From: kjana@... (YANAGAWA Kazuhisa)
Date: 2000-08-31T23:22:08+09:00
Subject: [ruby-list:24683] Re: RubyDocumentationProject( $B2>(B )

In message <20000830210638-12146H.takashi@localhost>
rubikitch@ruby-lang.org writes:

> > そんなんだったら
> > 
> >   --- String
> >     --- #replace(x)
> >       description....
> 両方とも共存できそうな。

こっちだとクラスメソッドや定数も全く同じ処理ができる :-) それに意味が
あるかどうかは，また別のお話．


> まずはこれ。
> rd2html foo.rd | w3m -dump -T text/html 

# w3m は禁則処理無いし，意図的にいれた JIS-X-0208 の文字間のスペースま
# でとりのぞいてしまう，なんていうのはここで書いてもしょうがない．

> でもって、rd2txtへの要求としてどんなものがあります？

実際のところ w3m 使ったレンダリングでほぼ十分ではありますね．ちょっと
不満はあるけど，それは根本的な仕様の問題というよりは，趣味や実装の問題．


> > # 現行の RD もちょっと「意味」のマークアップをまじめにやると読みにくく
> > # なるから，rd2txt っていうのはそれなりに需要があるかもしれない．でも
> > # それって RD の理念に反してるよね....
> マークアップ言語としてでなく、 plain text のちょっとした拡張としてだっ
> たら有用だと思ってみたり。

いや，「もともとそのようなものだった RD だけど，ずいぶん仕様が肥大して
しまって，『読みやすく，書きやすい』っていうもともとの RD の理念から外
れてきてるなぁ」っていう話です．

強調と脚注ぐらいならまだしも，変数/可変要素，とか，コードとか，inline
要素が多いかな，と．さらに (('')) といった形が読みにくさを増す方向にあ
る．Plain text としては読みにくくなってしまう，という．

ある程度長いものを括るんならともかく ((*strong*)) とか (({code})) とか，
中身が短いと厳しい．MethodList が必要になるのもこういう細かい意味マー
クアップをちゃんと書いていくとものすごくみづらくなるからなわけだし．

# といってもそれを解決する画期的なアイディア，なんてものは無いんだな....


-- 
柳川和久 @ 東大阪市 . 大阪府                                August 31, 2000
Slow and steady wins the race.