ruby-list

Toshです。

In message "[ruby-list:22706] Re: (RD) Verbatim"
    on 00/05/18, GOTO Kentaro <gotoken@math.sci.hokudai.ac.jp> writes:
>>ちょっと一般的な(?)本の場合どうなっているかを見ようと手元の本を
>>ぱらぱらとめくってみました。
>>日本語の本だと、Chaptionは大抵の場合10文字程度で1文におさまり、
>>名詞句(?)であることが多い様です。
>>
>>例外的に長い例はアンチパターンの本のP113に50文字くらいのものが
>>ありました。ぱらぱら見た程度では、2番目に長いのは20文字程度で
>>しかしこれは1文におさまる名詞句になっていました。
>
>どうも僕は科学論文を念頭に置いてるみたいです。図って本文とは
>独立しても意味がある資源だと思ってるんですかね > 俺。

完全に独立できるかどうかはわかりませんが、ある程度の独立性みたいな
ものはあるかと思います。
図はFloating要素ですから、編集の都合で本文とは離れ離れになってしまう
こともあるので、本文が無いと何の事だかさっぱりな図と言うのは、問題が
あるかもしれません。

>>この場合だと、元のキャプションは全て図(表?)の中にいれてしまって、
>>キャプションを「サーバーとクライアントの動作」等とする、のでしょうか。
>
>普通(?)はキャプションはその図を読むのに必要な情報をダイジェ
>ストしますね。詳細は本文をみよ、という形で。ベンチマークの結
>果のグラフなんかだと、こういう形があると思います。

そうです。どちらかというと、本文に「図を見よ」と参照が入っているわけ
ですが、始めに目に入るのは図の方ですから、「詳細は本文を」がむしろ
読者の読み方かも知れません。

>>つまり、提案はFigureのCaptionセクションの中にLabelという属性
>>を付加するのではなくて、CaptionセクションをそのままLabelにする、
>>ことです。
>
>…なんだかんだ言いましたがToshさんの意見の方がやっぱり良さそ
>うです。ただ、Captionと別にLabel指定するオプションもあると良
>いかと思います。:::Figure:label::: のlabelがあればそっちを使
>うとか。

そうですね。これまでの議論で図のキャプションは必ずしも見出しと
対応しているわけではないということもわかったので、Labelを別に
指定することができてもよいかと思います。

ところで、形式をどうするか、についてもちょっと掘り下げたいですね。
  :::Figure:::
  :::Caption
  :::...
といった記述は「:::」が多く並ぶとやや文字が見づらいのでないかと
思うのですが、どうでしょうか？

>>それって、「図 2.1」みたいな番号ってことですか？
>>それはRDのこと、というよりはRDtoolの機能としてってことですよね？
>
>そうです。これはRD自体の話ではなかったです。失礼 __;;

了解しました。

>>>また、実行例と、コードを分ける仕組みはあると良いですね。
>>>Verbatim の :::Execution::: で :::Code::: とか。
>>
>>Rubyの場合、実行例の形式には良く使われるものでも2種類(もっと?)
>>あるので、区別の必要があるかもしれません。
>># むしろフォーマッタが自動判別っていうのが現実的でしょうか。
>
>いや、難しいことはひとにさせるのが安上がりな気もします :-)
>
>>ひとつは、ごとけんさんのxmpでの出力にもなっている
>>  "a b c".split(/\s/)
>>     #=> ["a", "b", "c"]
>
>これはコード片と思ってよいのではないでしょうか?? 

ふむ、そうかも。

「#=>」以降はスタイル変えられるように
「<SPAN CLASS="evaluated">["a", "b", "c"]</SPAN>」とかしておく
とかはできるのではないかと思います。今回の提案が実現すれば。

>ちなみに xmp の出力はカット&ペーストを目的にデザインしてます。
>あんまり流行らないけど (^^;

そう言えば、以前、Emacsから呼び出すようにして「regionを各行
xmpに評価」とかできるようにすれば便利かも、とか考えたのですが。
それとも、すでにできるのですかね？誰かやっていてもおかしくない
使い方だと思うのですが。

>>みたいなやつで、もうひとつはシェルからスクリプトファイルを
>>実行した時の
>>  $ ruby foo.rb
>>  ....
>>みたいなやつです。
>
>コンソールって特別ですね。細かく言えば HTML だと
>
>$ <KBD>ruby foo.rb<KBD>
>
>したくなるような。でもここまではRDの可読性を保って実現するの
>は難しそう…しかしヘッダなどでプロンプトを指定できるとRDを読
>むひとにも優しいかも知れません。
>
>=begin AboutThisDocument
>....
>Prompt: "hoge>", "#"
>....
>=end

ヘッダに色々詰め込みすぎるのもRDとしてはどうだろうか、とも思う
のですが、どうせヘッダはオプションなんだから詰めるだけ詰めちゃって
もよいのでしょうかねぇ？
ここらへんのポリシーについてはかなり迷ってます。

ただ、さすがにプロンプト指定はやりすぎではないかと思います。
ヘッダにいれると実際の実行例の部分と距離的に離れていますし。

追加議題。

Verbatim => FloatingBlock の様に名前を変更すべき？

---
Tosh
Toshiro Kuwabara

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@...>