From: Toshiro Kuwabara Date: 2000-05-23T18:27:43+09:00 Subject: [ruby-list:22848] Re: (RD) Verbatim Toshです。 In message "[ruby-list:22836] Re: (RD) Verbatim" on 00/05/23, GOTO Kentaro writes: >>そうです。どちらかというと、本文に「図を見よ」と参照が入っているわけ >>ですが、始めに目に入るのは図の方ですから、「詳細は本文を」がむしろ >>読者の読み方かも知れません。 > >だと思います．問題は Vervatim で何でも書けるわけではないって >ことですが，将来ASCIIアートからPNGイメージを作るようなことも >ないとは限りませんね． 難しそうですが、将来的にはやりたいことのひとつです。Rubyは オブジェクト指向ですから、クラス図やオブジェクト図を書きたい場合は 結構あるかと思います。そういうときには、PNGに整形されていたほうが うれしいですよね。 # 特にRubyistの多くはデザインパターンとかお好きなようですし。(^^;; >>そうですね。これまでの議論で図のキャプションは必ずしも見出しと >>対応しているわけではないということもわかったので、Labelを別に >>指定することができてもよいかと思います。 > >良かった ^^;; 検討お願いします． たぶん、文法的に美しい案が出て来るか、に掛かってます。 というわけで、がんばってください。(^^;; >>ところで、形式をどうするか、についてもちょっと掘り下げたいですね。 >> :::Figure::: >> :::Caption >> :::... >>といった記述は「:::」が多く並ぶとやや文字が見づらいのでないかと >>思うのですが、どうでしょうか？ > >うーん，目を引いたほうが良いと思いますので僕はこれを押します． 僕が気にしているのは、 * ":::"が強いと目を引くべきCaptionの文字が逆に読みづらくなりそう。 * ":"って結構、数を数えにくくて、":::"と"::::"の違いは一見して そんな明らかでもないですよね。(俺だけ？) あと、"Figure"とかの判定とかももっと詰めないと。 :::FIGURE::: # 全て大文字 :::figure::: # 全て小文字 ::: Figure ::: # 前後の空白文字 ::: Figure # 後ろ側の ":::" の省略 がどう扱われるか、などです。 >>そう言えば、以前、Emacsから呼び出すようにして「regionを各行 >>xmpに評価」とかできるようにすれば便利かも、とか考えたのですが。 >>それとも、すでにできるのですかね？誰かやっていてもおかしくない >>使い方だと思うのですが。 > >面白いですね．だれか作ってくれないかなぁ． 不文律に則ると僕がやるって事になりますねぇ。(^^;;; >>ヘッダに色々詰め込みすぎるのもRDとしてはどうだろうか、とも思う >>のですが、どうせヘッダはオプションなんだから詰めるだけ詰めちゃって >>もよいのでしょうかねぇ？ >>ここらへんのポリシーについてはかなり迷ってます。 > >RD拡張について議論したほうが良いかも知れません．plain2よりも >RDのマークの方が読みやすいと僕は思うので当初の目的であるスク >リプトとドキュメントの一体化を超えた用法に向けた機能も採り入 >れるのは悪くないと思います．線を引くとすれば，要素の種類は増 >やさないということではないでしょうか?? RD本来の用途を逸脱したもののためには、例えばRDtoolにはFilterとかが ユーザーの勝手な拡張向けに用意されています。一応。 これは、RDでコメントとされてる部分をどう変換するかを指定できるもの なので =begin RDの部分 =end =begin Filtered Filterに扱われる部分 =end Filtered の様な形でBlockレベルの文法要素は拡張できますね。要素の 種類増やしてますし、みじんもRDらしくはないですけど。 RDの仕様に、この手の拡張を余地を残してある、と明記するかは ちょっとRDらしくない感じですから、やってません。 FilterもあくまでRDtoolの拡張で、使うとRDとは呼べない代物に なりますよ、ってものです。 もとのヘッダの話とややずれましたが、ヘッダ自体もFilterで扱って FilterがVisitorとやりとりすることも不可能ではないです。ヘッダ みたいなものを拡張として扱う事も可能と言う意味です。 # なんか書いてる本人がよくわからない文章になりました。 # ごめんなさい。(^^;; >>ただ、さすがにプロンプト指定はやりすぎではないかと思います。 >>ヘッダにいれると実際の実行例の部分と距離的に離れていますし。 > >そうですか…．僕はプロンプトのような何度も出てくるものは最初 >に定義してしまっても良いと思いました． う〜ん、そう言われると僕も迷いますが、例えばドキュメント書く人 がそれを指定するか、ってのはまた別の問題かと。 >>追加議題。 >> >>Verbatim => FloatingBlock の様に名前を変更すべき？ > >Verbatim の名称は変更しても良いかも知れませんが floating か >どうかは分かりませんね．ImageBlock とかかなぁ．図と表とリス >トを合わせて何というんだろうか… 僕は"floating"ってのはフォーマット上の指定でなく、図とか表とかいった 「本来文章の流れとはある程度独立している要素」の属性だと思うのですが。 --- Tosh Toshiro Kuwabara