From: Wakou Aoyama Date: 2000-06-19T07:01:55+09:00 Subject: [ruby-list:23349] Re: readablity of RD 青山です。 On Sun, 18 Jun 2000 12:23:41 +0900, Toshiro Kuwabara wrote: > う〜ん、まぁブラウザでの表示の話はとりあえず、置いておきましょう。 ええ、できるだけそうしたいですね。なかなかそうはいかない現状ではありま すが。 > 僕はDLというのは用語説明のためのものだと考えているので、例えば、Ruby本の > P.302にあるような「パッケージ再分割」とかは行頭見出しですけど(ですよね？) > DLっぽくはないかな、と思うのです。 ああ、それは小節(subsection)ですよね。やはり 4 段目の見出しは欲しいか も。で、行頭見出しは、おそらくこの本には無いと思います。たまたま似た感 じになっているのは、その少し後の P.307 の「リスト 6-18 の説明に戻りま す。」でしょうか。 これは、リスト何々を太字表記にしていて、それが行頭にあるために、たまた ま行頭見出しのようになっているだけですが。まあ、こんな感じで、改行せず に、同じ行に置く見出しが行頭見出しです。名前そのままですね。辞書などで は良く見かけると思います。 > =-=-=-=-= > とかを"==="と"---"の間に、とか考えましたが、Emacs + rd-mode.elでも使わない > かぎり、人間が書くにはつらすぎますね。 なるほど。=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= いえ、結構手打ちで も大丈夫じゃないですか？ キーボードの配列による心配はあるかもしれませ んが。 大見出し 中見出し 小見出し 小小見出し ======== =-=-=-=- -------- .......... 小小見出しには : を横にしたのがあれば綺麗だったかも。逆に、大見出しを もっと太くするという手もありますね。%%%%%, #####, ~~~~~, ^^^^^ とかい くつか案もあがっていたようですし。 > "====="というのは普通の文章にはほとんどでてこないのでたいした問題は出ない > かな、と。もし書いた人が居たらそれはVerbatimにしないと予期してものではない > のではないでしょうか。 ええ、このあたりは、実装のしやすい方でという感じでしょうね。 > 「追加」と言う事は青山さんの提案では以前の > > == Headline > > というのも残す、と言う事ですか？ です。すでに書かれたものもあるわけですし、プログラムのように、それによっ て何かをするのが主目的ではなく、それ自体を読みやすいようにするという目 的もありますから、使いたい方を使えば良いかなと。 > 追加でも実装にはそれほど問題は無いですが、2種類の形式を混在して使う人が > いるといやかな、とは思いませんか？ > > 例えば3レベルしかないと、 > > Headline > .......... > > ==== subsubsection > > っていうのは、絶対誰かやると思うのですが。 まあ、これも過渡期としてはあっても良いのではないでしょうか。そういうの が多く見られるようであれば、需要があるという事ですから、それから問題に ついて検討しても良いでしょうし。 1.5 系で変更になった filter --> collect! なんかも、ワーニングを気にし ないで filter を使う人もいるかもしれませんしね。-w を付けない人とか。 そういう方向では、どちらかだけに制限するオプションや、ワーニングを出す オプションなどがあると良いかもしれませんね。 -- 青山 和光 Wakou Aoyama