ruby-list

ごとけんです

In message "[ruby-list:22573] Re: (RD) Verbatim"
    on 00/05/15, Toshiro Kuwabara <toshirok@yb3.so-net.ne.jp> writes:
>僕が暴走した時には、ごとけんさんがとめてください。(^^;;

Toshさんは暴走しないと思うけど :-)

>ふぅむ。なるほど。
>そもそもキャプションってどんなものですかね？
>ごとけんさんの例にあったのはかなり長かったけど、普通は1行におさまる
>程度に短いですよね？

>つまり、Labelの候補として使えるでしょうか？
>それならば、キャプションを特別な要素として扱うのに十分な理由だと
>思えるのですが。

多分、一般にはLabel+註という機能があると思います。どちらかと
言うと註はオプショナルな気もしますね。僕の好みというか、業界
依存なんでしょうけど Figure や Table はそこだけ見て図の見方
がある程度分かるのが好きです。たとえば、

   :::Figure:srr.rb and clnt.rb:::
             server side            |              client side
   =================================|=======================================
   % ruby svr.rb                    | % ruby clnt.rb 2745 
   server is on 2745                | addr: AF_INET:2476:localhost:127.0.0.1
   #<TCPServer:0xa0424> is accepted | peer: AF_INET:2475:localhost:127.0.0.1
   #<TCPSocket:0xa02e4> is gone     | yahho
                                    | yahho
                                    | ^D
                                    | %
   :::Caption:::
   ::: まず svr.rb を動かし、そのポート番号を使って clnt.rb を動かす。
   ::: ^D(こんとろーるD)を打った時点で「#<TCPSocket:0xa02e4> is gone」
   ::: が出力される。

またLabelはFigureの属性であってCaptionの属性ではない気も少し
します。一方CaptionはFigureのなかに置きますがやっぱりFigure
のメタ情報と思います。

LaTeX だと自動生成される図の番号を使えますが、あれもあると良
いですけど、これはRD向きじゃないかも知れない。

# まとまらなくてすみません

>>えーっと、個人的には、Verbatim の中に置ける唯一の要素として 
>>Caption があるくらいのつもりです。少なくとも僕は、表の説明は
>>最初にあることを期待し、図の説明は下にあることを期待しますが、
>>すべての説明を上に書くという流儀もあるにはあるし、場所は固定
>>しない方が良いと思います。せいぜい上か下かのどちらか一方、も
>>しくは両方といったくらいのルースなモノで良いように思います。
>
>なるほど。前か後ろのどちらか、でよいかと思いました。

はい、実際は前後どちらか一方をユーザが選べると良いと思います。

>ある程度の意味情報を与える必要があるのはわかります。特に
>Verbatimはかなり色々と詰め込まれてますからね。

ですよね。

>CSSを見て、Emphasisにクラスの指定ができるべきなのだろうかと
>考えた事もあります。
>  ((*class:text*)) # => <STRONG CLASS="class">text</STRONG>
>みたいな感じで。
>これはちょっとごちゃごちゃしすぎるかと思って提案する前に破棄
>しましたが。

そうですね。インラインのなかに構造を持ち込むくらいなら新たな
インラインを検討した方がよいようにも思います。((<..|...>)) 
なんかは僕も使っちゃいますがあまり好きではありません。

ところで、やっと最近 Perl cookbook を買ったのですが、そこで
は次のような区別が設けてあり見やすいです。

: Italic
    ファイル名、コマンド名、URL または新出の術語。
: Bold
    コマンドラインオプション。
: Constant Width
    関数名、メソッド名とその引数。入力例。コード片。
: Constant Bold Italic
    実行例中の出力。

どの書体かは選べないにしても、ここに出てくるモノの種類をイン
ラインで指定する方法を検討するのは悪くないかも知れません。こ
のうち、RDで指定できるのはURLとコード片くらいでしょうか(逆に
変数なんかがあるわけですが)。

また、実行例と、コードを分ける仕組みはあると良いですね。
Verbatim の :::Execution::: で :::Code::: とか。

-- gotoken

Thread

Prev Next

In This Thread

Prev Next

[#22221] eRuby PNG patch — OZAWA Sakuro <crouton@...>

[#22224] text buffer — Minero Aoki <aamine@...>

[#22228] Re: #define const — toyofuku@...

[#22229] license of Ruby — TAKAHASHI Masayoshi <maki@...>

[#22238] Agancy? — Wakou Aoyama <wakou@...>

[#22242] <<< hoge.rd (rd2 bug) — gotoken@... (GOTO Kentaro)

[#22260] thread and Gtk.main — Yasushi Shoji <yashi@...>

[#22267] runit — Masatoshi SEKI <m_seki@...>

[#22268] irb on 1.4.? — "Kikutani, Makoto" <kikutani@...>

[#22275] host.conf は参照しないの？ — Uechi Yasumasa <uechi@...>

[#22276] Access Control List — Masatoshi SEKI <m_seki@...>

[#22284] escape in here document (1.4.4) — "Kikutani, Makoto" <kikutani@...>

[#22288] ruby-mysql と mod_ruby の組合せでエラー — Sakae Kobayashi <sakae@...>

[#22297] [PATCH] hide other block for rd-mode.el — nobu.nakada@...

[#22311] update uri.rb — Tomoyuki Kosimizu <greentea@...2.so-net.ne.jp>

[#22317] $0hoge, $1hoge — MOROHOSHI Akihiko <moro@...>

[#22323] Be FileType and Attribute library — tenmei@... (Noriaki Harada)

[#22325] comp.lang.ruby — matz@... (Yukihiro Matsumoto)

[#22331] undefined method — Masaki Suketa <CQN02273@...>

[#22346] mod_ruby installation — Akihiro Yamauchi <aygoofy@...>

[#22347] (RD) Verbatim — gotoken@... (GOTO Kentaro)

[#22361] rexp excluding Japanese — "Kikutani, Makoto" <kikutani@...>

[#22363] cgi.rb is too slow — WATANABE Hirofumi <eban@...>

[#22369] lists generated by rd2man — kjana@... (YANAGAWA Kazuhisa)

[#22374] about Gtk::RadioMenuItem — goto@...

[#22383] tmail-0.8.6 on ruby-1.4.4 — rubikitch <rubikitch@...>

[#22384] tmail — rubikitch <rubikitch@...>

[#22392] mod_ruby and suexec — Kenji Horikoshi <k-horix@...>

[#22397] new RD site — rubikitch <rubikitch@...>

[#22403] rd-mode.el — rubikitch <rubikitch@...>

[#22405] Release Schedule — ARIMA Yasuhiro <fit0298@...>

[#22409] postgres security — Noboru Saitou <noborus@...>

[#22422] media watch 2000.05.08 — Noritsugu Nakamura <nnakamur@...>

[#22431] /\c[/ — Wakou Aoyama <wakou@...>

[#22432] Wake on LAN with Ruby. — "K.Kodama" <kdm@...>

[#22434] Re: win OLE / eRuby — "NAKAMURA, Hiroshi" <nakahiro@...>

[#22436] RDindex 1.0.1 release — rubikitch <rubikitch@...>

[#22447] Re: Welcome to our (ruby mailing list) You are added automatically — "Kahori Takeuchi" <EB89012@...>

[#22448] Re: win OLE / eRuby — "Kahori Takeuchi" <EB89012@...>

[#22451] pack/unpack 'w' (BER comperssed integer) — Ryunosuke Ohshima <ryu@...>

[#22458] IO.foreach — Hiroshi SATO <hiroshi@...>

[#22483] p option of Regexp — Shin-ichiro Hara <sinara@...>

[#22489] M17N/I18N for Ruby — TAKAHASHI Masayoshi <maki@...>

[#22494] [Q] blade internal design — Hideto ISHIBASHI <hideto-i@...4u.or.jp>

[#22498] Re: M17N/I18N for Ruby — TAKAHASHI Masayoshi <maki@...>

[#22529] TCPServer.open() — Kazuhiro Nishiyama <nishiyama@...1.tiki.ne.jp>

[#22538] — "Kozuka Masahiro" <kozuka@...>

[#22539] Array.concat on ruby-1.5.3 — Tokita Kousui <ktokita@...>

[#22557] — "Kozuka Masahiro" <kozuka@...>

[#22559] eruby を windows98 で make(rubymw.dll), 実行時エラー発生 — Hiroshi Saito <HiroshiSaito@...>

[#22582] tmail0.8.8 — rubikitch <rubikitch@...>

[#22583] TMail::Mail RD document — rubikitch <rubikitch@...>

[#22585] =~ — NAWATE Masahiko <agul@...>

[#22593] Re: =~ — NAWATE Masahiko <agul@...>

[#22620] ftpup-1.3.3 — Shugo Maeda <shugo@...>

[#22624] Ruby Hotlinks — SUGIHARA Hiroshi <maili31s@...>

[#22668] CGI での添付ファイル付きメール送信 — Yukihiko Eda <eda@...>

[#22669] about net/telnet.rb — goto@...

[#22670] def foo= が呼ばれない — ARIMA Yasuhiro <fit0298@...>

[#22671] assert with iterator — rubikitch <rubikitch@...>

[#22685] runit — rubikitch <rubikitch@...>

[#22688] charset について — Shinya TOMOBE <shinya.tomobe@...>

[#22694] iterator? — Wakou Aoyama <wakou@...>

[#22728] — Miyazaki Shuhei <miyashu@...>

[#22737] link — Koyama Hideo <fa8h-kym@...>

[#22739] mod_ruby での __FILE__ — Shinya TOMOBE <shinya.tomobe@...>

[#22740] Re: #define const — toyofuku@...

[#22741] Re: iterator? — VLIW <cdrcarco@...>

[#22762] media watch 2000.05.18 — Noritsugu Nakamura <nnakamur@...>

[#22765] postgres-0.6.0 — Noboru Saitou <noborus@...>

[#22771] static instance — nobu.nakada@...

[#22789] OpenDesign 気になった点 — Noritsugu Nakamura <nnakamur@...>

[#22792] ruby 1.4.5 ? — Minero Aoki <aamine@...>

[#22793] ruby/tk の SUNOS でのコンパイル方法について — 山根 修一 <s-yamane@...>

[#22794] Ruby/KAKASI のありか — src <src@...>

[#22807] String#each_char — Wakou Aoyama <wakou@...>

[#22819] Re: メーリングリスト（ ruby-list ）との gateway — Yukihiro Matsumoto <matz@...>

[#22828] zlib — TAKAHASHI Masayoshi <maki@...>

[#22839] 脱会します — "T.Kanemaru" <kanemaru@...>

[#22844] またもや rd-mode.el — rubikitch <rubikitch@...>

[#22739] mod_ruby での FILE — Shinya TOMOBE <shinya.tomobe@...>

[#22793] ruby/tk の SUNOS でのコンパイル方法について — 山根　修一 <s-yamane@...>