From: Toshiro Kuwabara Date: 2000-06-23T01:07:42+09:00 Subject: [ruby-list:23470] Re: readablity of RD Toshです。 In message "[ruby-list:23349] Re: readablity of RD" on 00/06/19, Wakou Aoyama writes: >> う〜ん、まぁブラウザでの表示の話はとりあえず、置いておきましょう。 > >ええ、できるだけそうしたいですね。なかなかそうはいかない現状ではありま >すが。 個人的にはw3mなのでフォントの大きさとかはあまり気にならなかったり しますが。 # テキストブラウザは規格に(そこそこ)忠実なHTMLなら「それなり」の # 表示になるのがよいです。 >> 僕は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 を付けない人とか。 filterやRegexpの/pオプションの警告って-wつけなくても出ませんでしたっけ？ # これって、「1.7あたりではもうなくしちゃうよ」って意志表示？ >そういう方向では、どちらかだけに制限するオプションや、ワーニングを出す >オプションなどがあると良いかもしれませんね。 RDの場合、必ずしもフォーマッタが処理するわけではないので、複数の 文法が混じって一番混乱するのは人間だと思われます。 フォーマッタが警告出せば、「うっかり混在」ってパターンは減らせる とは思いますが。 青山さん案だけトントン拍子で話が進んでますねぇ。 --- Tosh Toshiro Kuwabara