ruby-list

Toshです。

> # 祝1.4.0!　＼(^-^)／

御意♪お盆は1.4.0とデート、とか。(^^)

> >: メタ文字列のエスケープか実体参照のような機能。
> >  # RDについてのドキュメント書く人にしか用は無いかも知れませんが。
> もしくはインラインの verbatim ですね。\varb+...+ とか %q() 
> みたいなのを流用するという手も考えられます。%q() そのものは
> まずいだろうから、%@() とか、 :::()::: かな。正規表現で書く
> のは面倒そうですが。

インラインのverbatimの方が便利かも。Rubyのスクリプトをインラインに
はさみたいときにも使えますし。

> >: ラベルと参照。
> >  SEE [ruby-dev:3070] etc.
> # blade で [ruby-dev:3067] をみたら「字面」が処理されてるよ
> # うに見える :-)

始め見たときしばし悩みました。(^^;

> RD は SGML とちがって汎用な括弧を用意しない思想なのでこの辺
> ツラいですね。しかし、podみたいのかSGMLみたいなのはなにかし
> ら用意しないと考えるのが大変かも(インライン要素はもうすこし
> ほしいので)。

インライン要素は結構ほしい機能とかたくさんでてきそうですが、
開始と終了の記号をかなり慎重に決めないとあっという間に可読性
が損なわれそうです。RDは可読性が嬉しいところなので、汎用の
ものを用意するにしても今の思想に従うにしてもなるべく慎重に
進めたいところです。

> まぁいまの思想で頑張ることにして、ラベル定義と参照が同じとい
> うの[ruby-dev:3070]はさすがに面倒なので、せめてどちらかを {} 
> で囲むようにした方がよいですね。

 [構文要素:ラベル]と
 {構文要素:ラベル}ってことですよね?

それで構わないと思います。
構文要素に何を許すかにちょっと議論の余地がありますが。

> >: Indexをどうするか。
> >  Latexが出力するような作業用のファイルのフォーマットを決めてしまうといろいろ
> >  と便利かも?
> >  # RDtoolではここらへんが未実装になってます。
> TeX っていうと aux とかのことでしょうか。仮に2パスになっても
> 外に出すことはないかも。

外に出すようにすると、例えば複数のライブラリのRDから得たauxをまとめて
一つの索引ファイルとして出力するスクリプトがあればお手軽にライブラリの
リファレンスができて便利かな、とか思いました。
それと、HTMLの最後に索引がついててもそれほど便利かなって思います。

> >: 強制的な改行の機能
> >  [ruby-list:16123]でAkihiro Yamauchiさんは「改行したときに<br>」と書いていら
> >  っしゃいますが、それだと困る事もあるでしょうから、指定した場所で強制的に
> >  改行するための機能が必要かも知れません。
> 
> :::br::: とかどうでしょう。実体参照もこの手でいけるような。

=br=とかも。どうせ行頭に来る事はないでしょうからHeadlineと紛らわしいという
こともありません。

> >: スクリプトに埋め込まないRDの決まり事
> >  スクリプトがなければ=begin, =endは省略してもよさそう。それとファイル名に
> >  つけるサフィックスが決まっていた方が良いかと。
> =begin =end は ruby -c でチェックできるとかmagicに使えるので、
> あった方が良いと思います。一方サフィックスで .rd って広く使
> われてるのありますか??

なるほど。＜magic
.rdだと.rbと似ていて紛らわしいかも。
もっとも=begin,=endがつくならruby *.rdとしても問題は起きませんが。

> >: 用語とかの定義・統一
> >  BlockElementとかInlineElementとか勝手に名前つけちゃいましたが、正直Tosh
> >  自身がこういう用語はHTMLくさくて気に入ってなかったりします。(^^;
> わかりやすくていいんでわ?? 視覚化する場合はすくなくともこの
> 二つの区別は必要でしょうし。

う〜む。実は[ruby-dev:3070]を読み返してみて、構文要素にリストなどのブロック
が入ってくると無理がでて来るような気がしました。
少なくとも同じラベルという要素にブロックのものとインラインのものの二つが
必要になりそうです。
現状でもリストはやや特殊な要素になってます。リストだけがブロックを含む
ブロックなので。

> >あと、ちょっと思い付いただけのものですが、
> > {script-name: hogehoge.rb}
> > {author: Tosh}
> > {auther-mail-addr: toshirok@yb3.so-net.ne.jp}
> > {last-mod: 1999/08/13 23:41:00 JST}
> > {descript: ......}
> >のような感じで付加的な情報を与える機能があるとおもしろいかも。
> >RAAのためにここからスクリプトの情報を集めたり、
> >同じものをrd2htmlではHTMLのTITLEとかに使ったり、とか。
>
> むしろ、このようなのが必要だと思うです。たとえば、今の 
> rd2html.html では最初に script info が出てたりしますが、これ
> はHTML化したものだと最後に載せるべきものの様な気がします。ま
> た、TITLE は ARGF.filename で補いましたがデフォルトはこれで
> いいとしてもやっぱりRD内でも指定できた方が良いでしょう。

ラベルと参照のどちらかに"{"をつかうなら、重なっちゃいますから、
上の形のままだとだめですね。
Rubyの代入やハッシュ式を真似て
 { key => value }
のような形がいいのか、もしくはそれだと問題が起きそうだから全く
別の形式にすべきなのでしょうか。

ところで、rd2html.rb(Ruby本体のsample/の)にある、「@input」とか
はどうしましょう?あったほうが便利ですか?
# そういえば、rd2html.rbの@inputの処理にバグを見付けて、それを
直そうとしたのがそもそものきっかけでした。(^^)

---
Tosh

Thread

Prev Next

In This Thread

Prev Next

[#15820] maillib with big base64 — kikutani@...

[#15825] matrix.o — Takashi Nishimoto <g96p0935@...>

[#15828] Ruby/Gtk for cygwin インストールについて — otokita@...

[#15832] Array#reverse! — setsura <setsura@...>

[#15833] ruby-orbit-0.0.1 — Dai <MAP2303@...>

[#15839] Windows95 で Tk — H サイトウ <HiroshiSaito@...>

[#15840] FreeBSD port kit for Ruby 1.3.6 — Yasuhiro Fukuma <yasuf@...>

[#15844] Re: alias new open — 助田 雅紀 <masaki.suketa@...>

[#15848] — Kazumi Okamoto <okamoto@...>

[#15856] Tiny Tiny eruby — Masatoshi SEKI <m_seki@...>

[#15865] mime.rb rev 1.4 — "NAKAMURA, Hiroshi" <nakahiro@...>

[#15870] help — Hideo Koyama <fa8h-kym@...>

[#15873] UDPsocket#recvfrom の API 変更について — Toshihiko SHIMOKAWA / 下川俊彦 <toshi@...>

[#15874] postgres でのユーザ指定 — Norio Kasahara <kasa@...>

[#15882] はじめまして — OGINO AKIHIRO <akimaru@...>

[#15885] difference of \Z between perl and ruby — Tomoyuki Kosimizu <greentea@...2.so-net.ne.jp>

[#15890] difference of system() between UNIX and Windows — suzuki@...

[#15894] RE: difference of system() between UNIX and Win dows — 助田 雅紀 <masaki.suketa@...>

[#15899] ruby/tk on cygwin /w Tk8.1 — たむら けんいち <tamura-r@...>

[#15902] sybase module — Hisakuni FUJIMOTO <hisa@...>

[#15911] Re: [ruby-talk:00563] Date class and rfc822 — Wakou Aoyama <wakou@...>

[#15912] [][-n,n] — Wakou Aoyama <wakou@...>

[#15916] Re: [][-n,n] — Inaba Hiroto <inaba@...>

[#15920] Re: [][-n,n] — Inaba Hiroto <inaba@...>

[#15927] Ruby 1.3.7 — Yukihiro Matsumoto <matz@...>

[#15928] DAO クラスモジュール 0.001alpha — たむら けんいち <tamura-r@...>

[#15935] Ruby/IRC — Shugo Maeda <shugo@...>

[#15944] Ruby 1.3.7 — Yukihiro Matsumoto <matz@...>

[#15954] [^] — Tomoyuki Kosimizu <greentea@...2.so-net.ne.jp>

[#15955] echo しない readline — m_seki@...

[#15956] FAQ-990807 — Akira Endo <akendo@...3.rim.or.jp>

[#15965] String#split — Tomoyuki Kosimizu <greentea@...2.so-net.ne.jp>

[#15966] あしたのために(その一) — kikutani@...

[#15981] Ruby/Tk81 Demos — ttate@...

[#15993] Where is "ruby-mode.sl" ?? — Ryuichi Tamura <tam@...3.kais.kyoto-u.ac.jp>

[#15996] Sun World — matz@... (Yukihiro Matsumoto)

[#16002] how to know binary file — kikutani@...

[#16003] RE: Sun World — 助田 雅紀 <masaki.suketa@...>

[#16004] RE: how to know binary file — 助田 雅紀 <masaki.suketa@...>

[#16023] Ruby/PDFlib — thitoshi@... (TAKAHASHI Hitoshi)

[#16025] eRuby 0.0.4 — Shugo Maeda <shugo@...>

[#16027] 日経オープンシステム — Ataru NAKATA <anakata@...>

[#16028] C マガ — hisanori@...

[#16034] mod_ruby 0.1.4 — Shugo Maeda <shugo@...>

[#16036] ruby/gtk でウィンドウを中央に表示したい — kkubota@18software.co.jp

[#16042] JUS Ruby Workshop — Tomoyuki Kosimizu <greentea@...2.so-net.ne.jp>

[#16048] ruby/tk の menu_spec について — S-Harada<jdn@...>

[#16049] [].length==0 — Kazuhiro HIWADA <hiwada@...>

[#16052] Re: ruby/gtk でウィンドウを中央に表示したい — kkubota@18software.co.jp

[#16055] Re: ruby/gtk でウィンドウを中央に表示したい — kkubota@18software.co.jp

[#16058] Re: ruby/gtk でウィンドウを中央に表示したい — Miyaki Masahiro <miyaki@...>

[#16059] Re: ruby/gtk でウィンドウを中央に表示したい — kkubota@18software.co.jp

[#16061] calendar/date — Tadayoshi Funaba <tadf@...>

[#16085] Re: ruby/gtk でウィンドウを中央に表示したい — kkubota@18software.co.jp

[#16091] The last day of a month — Akihiro Yamauchi <aygoofy@...>

[#16095] rd2html — Toshiro Kuwabara <toshirok@...3.so-net.ne.jp>

[#16099] クラスの別名 — Takashi Nishimoto <g96p0935@...>

[#16102] mysql-ruby link on RAA — とみたまさひろ <tommy@...>

[#16118] Ruby 1.4.0 — matz@... (Yukihiro Matsumoto)

[#16126] English document for RDtool — Toshiro Kuwabara <toshirok@...3.so-net.ne.jp>

[#16127] readline with 1.4 — kikutani@...

[#16147] Q: Constants — Tomoyuki Kosimizu <greentea@...2.so-net.ne.jp>

[#16151] extinit & mkmain — Takashi Nishimoto <g96p0935@...>

[#16152] mkprototype — Takashi Nishimoto <g96p0935@...>

[#16153] ANN: testsupp 0.2 released. — gotoken@... (GOTO Kentaro)

[#16157] rdtool-0.2.1 — Toshiro Kuwabara <toshirok@...3.so-net.ne.jp>

[#16158] maillib? 0.5.0 — Minero Aoki <aamine@...>

[#16164] Re: Ruby 1.4.0 — SHIROYAMA Takayuki <psi@...>

[#16167] Ruby 1.4.0 on BSD/OS 3.1 — OHARA Shigeki <os@...>

[#16171] FAQ の間違い ? — hiramatsu@...

[#16177] Ruby 1.4.0 binaries for cygwin, djgpp — WATANABE Hirofumi <watanabe@...>

[#16179] parsearg with debug.rb — kikutani@...

[#16185] Ruby lecture in Sapporo — gotoken@... (GOTO Kentaro)

[#16199] ruby/gtk の focus_out_event について — kkubota@18software.co.jp

[#16201] Re: ruby/gtk の focus_out_event について — kkubota@18software.co.jp

[#16202] — Hiroyuki Ueki <ueki@...>

[#16209] year of parsedate — kikutani@...

[#16216] timeout.rb — wakou@...

[#16218] ruby-1.4.0 [BUG] Segmentation fault — Toshihiko SHIMOKAWA / 下川俊彦 <toshi@...>

[#16219] Re: year of parsedate — Inaba Hiroto <inaba@...>

[#15844] Re: alias new open — 助田　雅紀 <masaki.suketa@...>

[#15894] RE: difference of system() between UNIX and Win dows — 助田　雅紀 <masaki.suketa@...>

[#15899] ruby/tk on cygwin /w Tk8.1 — たむら　けんいち <tamura-r@...>

[#15928] DAO クラスモジュール 0.001alpha — たむら　けんいち <tamura-r@...>

[#16003] RE: Sun World — 助田　雅紀 <masaki.suketa@...>

[#16004] RE: how to know binary file — 助田　雅紀 <masaki.suketa@...>

[#16228] Setup.nt — 助田　雅紀 <masaki.suketa@...>

[#16264] RE: ruby hacking guide — 助田　雅紀 <masaki.suketa@...>

[#16274] Re: Setup.nt — 助田　雅紀 <masaki.suketa@...>

[#16287] RE: Japanese in ruby/gtk (cygwin) — 助田　雅紀 <masaki.suketa@...>