[ruby-list:22552] Re: (RD) Verbatim

ごとけんです

引用の順番を変えています。

In message "[ruby-list:22550] Re: (RD) Verbatim"
    on 00/05/15, Toshiro Kuwabara <[e-mail]> writes:
>HTMLにフォーマットするときに全て<PRE>...</PRE>だけというのは
>多少の無理がありますし、他のフォーマットならもっとでしょう。
>
>しかし、この提案の方法がいいやり方か、と言うのはまだ判断が
>つきません。

# Toshさんの慎重な態度には好感を持っています :-)

>例えば、キャプションは本当に特別扱いが必要でしょうか？

僕は必要だと考えます。多くのマークアップ言語にはキャプション
があるというのが天下り的な理由ですが、正規化されたキャプショ
ンの規則があると、RDの読みやすさも上がると考えられるからです。

>とりあえず、「キャプションは最後にひとつだけ」もルールに加えて
>おきましょう。
[...]
>しかし、図と表でキャプションの位置が違うと言うのはルールとしては
>複雑ではないですか？

えーっと、個人的には、Verbatim の中に置ける唯一の要素として 
Caption があるくらいのつもりです。少なくとも僕は、表の説明は
最初にあることを期待し、図の説明は下にあることを期待しますが、
すべての説明を上に書くという流儀もあるにはあるし、場所は固定
しない方が良いと思います。せいぜい上か下かのどちらか一方、も
しくは両方といったくらいのルースなモノで良いように思います。

>>>>意味をはっきりさせると言う点では、次の :::Code::: もあるとよ
>>>>いやも知れません。
>>>>
>>>>  :::Code:::
>>>>  require 'socket'
>>>>
>>>>  host, port, path = "localhost", 80, "/"
>>
>>>こういうのがあればRubyの予約語を色を変えたりとかもできますね。
>>
>>なるほど、それは考えていませんでした(普段色をつけてないので)。
>
>僕もw3mなので普段は色の違いを目にする事は無いのですが。

むしろ、意味の情報があれば、自分で(HTMLの)クラスを付加する
visitor が書けるので助かります。クラスを指定できないとスタイ
ルシートを書く効果が激減しますので。これはLaTeXでもそうで、
Tree情報から自作のTeXコマンドに置き換えることが出来ません。

>>ところで rdtool などでは、TABをスペースに展開してからTreeを
>>構成したほうがよいようにおもいます。TABのカラム数はデフォル
>>ト8で、さらにコマンドラインオプションなどで指定できると嬉し
>>いです。
>
>TABが何カラムか、というのはかなり環境依存な問題なのでスペース
>に展開する事がいい、とは言えないと思います。
>
>RD書いた人とフォーマッタで処理をする人は違う場合が多いので、
>書いた人の環境では問題無かったRDが読み手の環境では変な出力
>になってしまうことも出て来るでしょう。
>
>いずれにしろTABとスペースを混ぜるのはおすすめできません。

実は、かなり注意しないとTABがスペースと混在してしまうんです。
Emacsで書いている場合、リージョン内のインデントを増やしたり、
逆に長方形コマンドでインデントを減らしたりすると、空白がいつ
の間にかTABに置き換わってしまいよく泣かされます。

# 僕の使い方が悪い可能性が大ですが ^^;;

-- gotoken