[ruby-list:16204] Re: RD specification

ごとけんです

ところで、この議論はここで続けますか??  それとも ruby-talk 
でやりますか?? 英語は大変なんだけど、議論が共有されないのは
もったいないし。

In message "[ruby-list:16168] Re: RD specification"
    on 99/08/16, Toshiro Kuwabara <[e-mail]> writes:

>> >閉じカッコの前にもマークを入れるならカッコは一重でもいいのでは?
>> 大丈夫かなぁ。ちょっと心配。
>
>普通の文章にはたぶん大丈夫かと。
>Rubyのコードはちょっと微妙なものもあるかも。('...'),("...")とか(/.../)
>あたりはまずいですね。きっと。

カッコってわりと使うんで二重の方がよいと思うです。

>> えっと、これはHeadlineElementなどはその見出しそのものを書く
>> ということを意図してました(plain2 の ((x...))のように)。つま
>> りHTMLだと <a href="bar">foo</a> のように foo と bar を違う
>> のにできますが、それを基本的には禁止するということです。
>
>ふむふむ。同じ名前のHeadlineは書けない事になりますね。
>@inputとかを使い出すと名前がかぶることがあるかも。
># rdtoolはwarning出すようにしないと。

そうです。例えば Method とか Included modules なんてのはいか
にも重なりそうですが、そういうセクションを指すこと自体があま
りよくない気がします。もしくはヘディングのネストを把握して、
((<Foo::Include modules>)) のように :: を入れて解決すると言
う手はあるかも知れません。

>なるほど。URLの場合と他の場合で処理を適当に変えてくれるんですね。
>パーサはLinkElementとかで始めがURL:かどうかで場合分けするだけですので
>そんなに複雑にはならないと思います。
># 現状が十分複雑との説も。(^^;
>
>> あとは参考文献(SEE ALSO)かな。
>
>LaTeXみたいにインラインで使うようにするのですか?
>そうでないなら付加情報で与えてしまえば、これ以上のタグ(?)を導入しなくて
>すみますが。

例えば ((<REF:HF90>)) と書くと、LaTeX では [HF90] と出て、
HTMLでは

=References

  [HF80] Hoge FOO ``Mr. Annonymous'', Bar Press 123pp (1980)
  [HF90] Hoge FOO ``Mr. Annonymous, again'' Bar Press 132pp (1990)

の [HF90] のところにリンクを貼るといった感じはどうでしょう??

>> >それとインラインの入れ子も許すようにしないといけなさそうですね。
>> そうですね、入れ子にしないと使いにくいでしょう。
>
>御意。

大変ですね。もはや racc のようなものを使わないと難しいかも。
しかし、インデントベースなので単純なCFGでもなさそうだなぁ…

>LaTeXはラベルで指定するけどRDはHeadlineのtitleやcaptionで、
>ってことですね。逆に言うとリストを参照したいならリストに
>caption付ける機能が無いとだめですね。
>リストの前に#の行があったらcaptionにするとか。

僕がおもうに、table とか言うものを導入しないかぎり、
DescListElement の中に ItemListElement を置くとかすればリス
トにキャプションは要らないでしょう。

>Headlineへの参照(ごとけんさんのおっしゃたように)はtitle
>(例のHeadlineの部分)で指定でいいように思いました。
>それで行くとキャプションをどうつけるか、何に付けられる事にするか、
>ですね。

そうですね。まぁ、キャプションは本来図や表につけるものですか
ら、図や表という概念が必要になるまでは HeadlineElement と 
DescListElement の見出しだけでよいと思います。

>> >> >> >あと、ちょっと思い付いただけのものですが、
>> >> >> > {script-name: hogehoge.rb}
>> >> >> > {author: Tosh}
>> >> >> > {auther-mail-addr: [e-mail]}
>> >> >> > {last-mod: 1999/08/13 23:41:00 JST}
>> >> >> > {descript: ......}
>(ちょっと途中を省略)
>> >> いっそのこと、ある規約にしたがって、Rubyのモジュールを吐き出
>> >> すのもいいかも知れません。
>> > module Foo
>> >   ...
>> > end
>> >のモジュール?
>> そうです。そのモジュールです。中身は何も考えてませんが。
>
>吐いたモジュールは何が使うのですか?

一つは rd2html の補助です。例えば roff で目次を作ったりとか。
あるいは、raa みたいなものを自動生成するモノが使う。先走ると、
ここをちゃんと決めてみんなが従えば CPAN みたいなのを自動的に
作れるんじゃないかと思うです。

>> =begin html
>> <br>Figure 1.<IMG SRC="figure1.png"><br>
>> =end html
>
>あると便利なのですし、別スレッドででているコメントRDもこれで
>ぴったりとうまくいくのですが、あるといくらでも「一見して意味が
>わからない(フォーマッタに通さないと読むに耐えない)RD」が書けそ
>うなのが恐かったりします。(コメントRDも)
>こういうのはRDの仕様にはいれないでおいて、その代わりにどうし
>てもやりたい場合には他のツール(eRubyとか)と組み合わせると同じ
>事ができる、というような逃げ道があればいいと思うのですが、
>何かうまい案は無いですか?

たしかにそれは言えますね。plain2 だと、アスキー画を認識して
テーブル(\tabular)や線画(\picture)として吐き出す機能とかある
んですが、そういうのができればカバーできます。plain2 の場合、
必ずしもテーブルをテーブルとして認識するとは限らないので、強
制的にテーブルとして認識させるために

[[T

]]T

のような書き方があります。濫用は別にしてもこのようなコンパイ
ラスイートのようなものはないとつらいでしょう。

-- gotoken