From: Toshiro Kuwabara Date: 2000-01-04T11:42:31+09:00 Subject: [ruby-list:20039] Re: RD with method index (again) Toshです。 In message "[ruby-list:20038] Re: RD with method index (again)" on 00/01/04, nobu.nakada@nifty.ne.jp writes: > しまった。これは迂闊でした。 ># RD の仕様の話自体をちゃんと読んでいないってことか。(^^; > > というか、よく考えたら、仕様を拡張しなくても、in_rd じゃないと >きも単純に include さえしてくれれば、私の要求は満たせたのでした。 > >> filterも当分undocumentedのままです。 >> これは本来HTMLとかを書きたくない人(俺だ(^^;;)がWebページ等をRD使って書 >> く時に使う為の機能ですので、この機能使ったRDもどきを公開したりしないよ >> うにしてください。もちろん処理した後のHTMLは構いません。 > > これは、 RD 以外の文字列が =begin の後にあるブロックも処理され >ることを期待しているものはまずい、ということでしょうか。それとも、 >そういうブロックを含んでいること自体がまずい? =begin foo ... =end ってのは、fooが"RD nantoka"でない限りはRDには含まないことになってます。 Rubyには複数行のコメントがないので、代わりにRD用の"=begin" ... "=end" を使うことにした、ってのが起源だったと思います。 したがって、こういうブロックを含んでる事は問題ありません。処理される ことを期待するのは問題です。 逆に言うとRDtoolで処理する事を目的としてこういうブロックを含んでいても 処理される場合とされない場合でドキュメントの意味が変わったりしなければ 含んでもかまわないかと((*個人的には*))思ってますが、RD自体が生まれた ばかりなので、悪い習慣が根付かない為にしばらくは控えて欲しいです。 # まぁ、こんな機能つけたのが悪いんですが。 >> patch自体は僕のコードのごちゃごちゃしていた部分をかなりすっきりと >> 掃除していただいたみたいなので部分的になりますが、取り込みたいと >> 思います。ありがとうございました。 > > どうせなら、上に書いたように =begin RD 以外でも <<< が有効にな >るようにしていただけるとありがたいのですが…。 これは人によって欲しい人と欲しくない人がいると思いますので、欲しい人は 御自分で"<<<"を解釈するfilterを書くのがいいかと思います。 filter自体がそもそもそういう目的で作られたものですので。 >> > ついでに要望をもう一つ。 >> > 例えば rd2html などで、charset やら stylesheet やらを指定できる >> >ようになると嬉しいのですが。スクリプトを用意すればできるのかもで >> >すが、できればコマンドラインからも指定できるともっと嬉しいような。 >> >> これ僕も欲しいんですが、どういう風にするかでちと悩んでいます。 >> RD Headerなんて話もでているので、こういうのはそっちで指定する事に >> なるのかな、とか思って手を出しかねてる感じです。 > > なるほど。 > でも HTML のような各フォーマット毎の指定は独立していた方がいい >ような気がしますが。 コマンドラインオプションでの指定はかなり前から考えてはいるのですが、 コマンドラインオプションで指定していると長くなっちゃうんじゃないかなぁ、 とか、共通のオプションとフォーマットライブラリ依存のオプションをフロント エンドはどう区別してどうやってフォーマットライブラリに渡すのか、とかで 悩んでいて決まらないのでほっておいてる状態です。 # 設定ファイルもできたことだし、設定のセットを"~/.rd2rc"に書いておいて # コマンドラインオプションでセットを指定、がいいのかな？ >> # 0.5.5はいつになくフィードバックが頻繁でうれしいけど、 >> # 整理が大変かも。(^^;; > > 近頃、自作のツールとかでもドキュメントを書かねばならん、みたい >な強迫観念的なものに駆られてるらしくて(笑)。 それはいいことじゃないですか。(^^) --- Tosh Toshiro Kuwabara