[ruby-dev:3045] Re: ? RD (Re: feature freeze for 1.1c)

ごとけんです

In message "[ruby-dev:3020] Re: ? RD (Re: feature freeze for 1.1c)"
    on 98/06/25, Yukihiro Matsumoto <[e-mail]> writes:

>まつもと ゆきひろです

>いいかげんな仕様のまま，ちゃんと処理系も書かれてませんが，
>ruby本の原稿書きに活用されてます．っていっても現状ではほとん
>どプレーンテキストですけど．

えーっと、perlpod のマニュアルを見て、これは是非欲しい、
ってモノを探して見ました。

1. 見出し
2. 箇条書
3. リンク
4. エスケープ
5. verbatim

んで、現在の埋め込みドキュメント(^=begin$ ... ^=end$)を
崩さないかたちで拡張できる方法は、やはり、この埋め込み
ドキュメントの中に文法を持ち込む事だと思います。
そこで、埋め込みドキュメントの中の文法として、次のモノを
提案します。適当な書き方してますが察して下さい。

  1. 見出し
  ^ "=head1" <string>
  ^ "=head2" <string>
  ...
  ^ "=head"<n>

  2. 箇条書
  ^ "=list" ?(" " <string>)
  +(^ "=item" ?<text>)
  ^"=tsil"

  3. リンク
  "L@[" <name> "@]"
  "L@[" <name> "/" <section> "@]"
  "L@[" "/" <section> "@]"

  4. エスケープ
  "E@[" <string> "@]"

  5. verbatime
  "V@[" <text> "@]"

いかがでしょうか? 
あとは rd2html や rd2man を作るために、エスケープや
リンクなんかの書き方と意味を決めてやれば良いと思います。

-- gotoken