rabbit 0.9.2 → 0.9.3

data/doc/ja/install/index.rd

@@ -0,0 +1,65 @@
+---
+layout: ja
+title: インストール
+---
+== インストール方法について
+
+Rabbitはgemまたはそれぞれのプラットフォームにあるパッケージ管
+理システムを使ってインストールすることができるため、導入が非
+常に簡単です。
+
+== gemを使う方法
+
+  % gem install rabbit
+
+== Debian GNU/Linuxでのインストール方法
+
+  % sudo aptitude install -y rabbit
+
+== Ubuntuでのインストール方法
+
+  % sudo aptitude install -y rabbit
+
+== Gentoo Linuxでのインストール方法
+
+  % sudo env ACCEPT_KEYWORDS=~x86 FEATURES="digest" emerge rabbit
+
+== NetBSD（またはpkgsrcが使えるプラットフォーム）でのインストール方法
+
+  % sudo pkg_add ruby18-rabbit
+
+または
+
+  % sudo pkg_add ruby19-rabbit
+
+== FreeBSDでのインストール方法
+
+  % sudo portupgrade -NRr rabbit
+
+== Mac OS XでMacPortsを使ったインストール方法
+
+((<macports.rd/MacPortsを使ったインストール方法>))を参照してく
+ださい。
+
+== Mac OS XでHomebrewを使ったインストール方法
+
+((<homebrew.rd/Homebrewを使ったインストール方法>))を参照してく
+ださい。
+
+== Windowsでのインストール方法
+
+((<windows.rd/Windowsでのインストール方法>))を参照してくださ
+い。
+
+== tar.gzからインストール
+
+((<URL:http://rabbit-shockers.org/download/rabbit.tar.gz>))
+から最新のRabbitをダウンロードし、setup.rbを実行します。この
+URLは常に最新のRabbitのアーカイブになります。
+
+  % mkdir tmp
+  % cd tmp
+  % wget http://rabbit-shockers.org/download/rabbit.tar.gz
+  % tar xvzf rabbit.tar.gz
+  % cd rabbit-*
+  % sudo ruby setup.rb

data/doc/ja/install/macports.rd

@@ -0,0 +1,105 @@
+---
+layout: ja
+title: MacPortsでインストール
+---
+== Mac OS XでMacPortsを使ったインストール方法
+
+Mac OS X のパッケージ管理システムのひとつである、MacPorts を利用して
+Rabbit をインストール、利用する手順について説明します。
+
+=== 事前に準備するもの
+
+以下のソフトウェアが必要です。Mac OS X のシステムDVDなどからインストール
+してください。
+
+* Xcode Tools
+* X11
+
+Xcode Tools のインストール時には、X11 SDK を選択するのを忘れないでください。
+
+=== MacPorts のインストール
+
+MacPorts の公式サイト ((<URL:http://www.macports.org/>)) からダウンロード、
+インストールします。ディスクイメージ(.dmg)からインストールするのが簡単です。
+
+とくに指定しなければ、/opt/local 以下に MacPorts 関連のファイル群がインストール
+されます。MacPorts のコマンドを利用するために、環境変数 PATH に /opt/local/bin
+を追加します。
+
+=== Rabbit のインストール
+
+まず、以下のコマンドで、Rabbitに必要なソフトウェアの情報を更新し
+ておくのも良いかもしれません。
+
+  ~% sudo port sync
+
+以下のコマンドで Rabbit と、それに必要なソフトウェアがインストールされます。
+
+  ~% sudo port install rb-rabbit
+
+glib や Gtk2 がインストールされていないときは、これらのインストールのために
+ある程度の時間がかかります。
+
+他にも以下の port をインストールするとよいでしょう。
+
+* Ruby-GetText-Package (rb-gettext) - メッセージなどの国際化が有効になります
+* net/irc (rb-net-irc) - rabbircが利用できるようになります
+
+インストール方法は同様です。
+
+  ~% sudo port install rb-gettext
+  ~% sudo port install rb-net-irc
+
+注) Ruby-GetText-Package が、すでに RubyGems からインストールされているときは
+rb-gettext のインストールは不要です。
+
+==== X11なしでRabbitを利用したい
+
+もしRabbitをX11なしで利用したい場合は、rb-rabbitパッケージをインストールする
+前に、pango・cairoおよびgtk2をX11なしでインストールしてください。
+
+  ~% sudo port install pango +no_x11 +quartz
+  ~% sudo port install cairo +no_x11 +quartz
+  ~% sudo port install gtk2 +no_x11 +quartz
+
+=== X11 環境に関する Tips
+
+一般的な PC-UNIX 環境とは異なり、Mac OS X ではウィンドウシステムとして X を
+利用していません。そのため、いくつかの注意が必要になります。
+
+==== X11.app を起動する
+
+X11.app が起動していなければ、rabbit は実行できません。X11.app は 
+/アプリケーション/ユーティリティ/X11.app にあります。
+
+==== DISPLAY 環境変数
+
+X11 上で動作する Rabbit を利用するためには、DISPLAY 環境変数が設定されて
+いなければなりません。X11.app 上の xterm では設定されていますが、標準の
+ターミナルや iTerm、JTerminal を利用しているときは自分で設定する必要が
+あることに注意してください。
+
+=== Rabbit をバージョンアップする
+
+port sync コマンドで Portfile を最新のものに更新したうえで、
+port upgrade コマンドにより、Rabbit を最新のバージョンに更新することが
+できます。
+
+  ~% sudo port sync
+  ~% sudo port upgrade rb-rabbit
+
+Rabbit だけをバージョンアップしたいときは、-n オプションを指定します。この
+オプションの指定により、関連するソフトウェアは更新せずに Rabbit だけを更新
+することができます。
+
+  ~% sudo port -n upgrade rb-rabbit
+
+=== 連絡先
+
+お気づきの点やリクエストなどは、Rabbit::UsersGroup.ja
+((<URL:http://www.cozmixng.org/~rwiki/index.rb?cmd=view;name=Rabbit%3A%3AUsersGroup.ja>)) 
+や Rabbit MacPorts 担当の木村 (kimuraw at i.nifty.jp) までどうぞ。
+
+
+Rabbitはgemまたはそれぞれのプラットフォームにあるパッケージ管
+理システムを使ってインストールすることができます。

data/doc/ja/install/windows.rd

@@ -0,0 +1,100 @@
+---
+layout: ja
+title: Windowsへインストール
+---
+== Windowsでのインストール方法
+
+Windows上でRabbitをインストール、利用する手順について説明し
+ます。
+
+必ずインストールしなければいけないソフトウェアと、なくても動
+くけどあると便利なソフトウェアがあります。
+
+=== 必須のソフトウェアのインストール
+
+以下が必須のソフトウェアです。
+
+  * Ruby
+  * Rabbit
+
+まずは必須のソフトウェアをインストールしましょう。
+
+==== Ruby 本体のインストール
+
+((<RubyInstall for Windowsのダウンロードページ（英語）
+|URL:http://rubyinstaller.org/downloads/>))からRuby 1.8.7 の
+インストーラをダウンロードします。Ruby 1.8.7-p334のインストー
+ラは以下のURLからダウンロードできます。
+
+: rubyinstaller-1.8.7-p334.exe
+   ((<URL:http://rubyforge.org/frs/download.php/74293/rubyinstaller-1.8.7-p334.exe>))
+
+==== Rabbitのインストール
+
+RubyInstallerをインストールするとスタートメニューに「Start
+Command Prompt with Ruby」というプログラムが追加されます。こ
+のプログラムを実行するとruby.exeにパスが通ったコマンドプロン
+プトが表示されます。ここで以下のコマンドを実行することで
+Rabbitをインストールできます。Ruby/GTK2など関連するソフトウェ
+アも一緒にインストールされます。
+
+  > gem install rabbit
+
+=== 必須ではないソフトウェアのインストール
+
+以下がなくても動くけどあると便利なソフトウェアです。
+
+  * RDtool
+  * Ghostscript
+  * Enscript
+  * div
+
+それではあると便利なソフトウェアをインストールしましょう。
+
+==== RDTool のインストール
+
+((<RAA:rdtool>)) をインストールする。
+
+アーカイブを展開して，setup.rb を実行してインストールする．
+
+: rdtool-0.6.20.tar.gz
+   ((<URL:http://www.moonwolf.com/ruby/archive/rdtool-0.6.20.tar.gz>))
+
+==== EPS を表示する
+
+(1) AFPL Ghostscript 8.53 for Win32 をインストールする。
+
+    : gs853w32.exe
+        ((<URL:http://www.cs.wisc.edu/~ghost/>))
+
+(2) インストール後 <インストール先>/gs/gs8.53/bin に PATH を通す。
+
+==== ソースコードの色づけを行う
+
+(1) Enscript をインストールする。
+
+    : enscript-1.6.3-9-bin.exe
+        ((<URL:http://sourceforge.net/project/showfiles.php?group_id=23617&package_id=16960>))
+
+(2) <Enscript のインストール先>/bin に PATH を通す。
+
+(3) ruby コードを色づけする場合は、以下のコマンドで ruby.st もインストールする。
+
+      > cd <Enscript のインストール先>\share\enscript\hl
+      > ruby -ropen-uri -e "puts open('http://viewvc.rubyforge.mmmultiworks.com/cgi/viewvc.cgi/trunk/support/ruby.st?root=support&view=co').read" > ruby.st
+
+(4) ((<RAA:htree>)) をインストールする。
+
+    アーカイブを展開して，install.rb を実行してインストールする。
+
+    : htree.tar.gz
+        ((<URL:http://cvs.m17n.org/viewcvs/ruby/htree.tar.gz>))
+
+==== rabrick を使う
+
+((<RAA:div>)) をインストールする。
+
+アーカイブを展開して，install.rb を実行してインストールする。
+
+: div-1.3.2.tar.gz
+   ((<URL:http://www2a.biglobe.ne.jp/~seki/ruby/div-1.3.2.tar.gz>))

data/{NEWS.ja → doc/ja/news.rd}

@@ -1,8 +1,89 @@
-# -*- rd -*-
+---
+layout: ja
+title: お知らせ
+apply_data: false
+---
+== 0.9.3: 2010-06-25
 
-= NEWS.ja
+コメント・Twitterサポート強化リリース。
 
-$Id: NEWS.ja 1455 2010-12-31 09:13:21Z kou $
+=== 改良
+
+==== 本体
+
+  * PDFサポートのRuby 1.9対応。
+    [とみたさんが報告]
+  * [#199] "-I"オプションで指定されたパスの中の「~」を展開す
+    るようにした。
+    [kdmsnrさんが報告]
+  * TwitterのOAuthに対応。
+  * Bundlerに対応。
+  * rabbitコマンド終了時に実行する処理を登録できる
+    Rabbit.add_cleanup_procを追加。
+  * Wii RemoteでRabbitを操作するためのコマンドrabwii（らぶ
+    うぃー）を追加。
+    [おかべさんのコードをベースに改造]
+  * dRubyサーバはデフォルトでlocalhostにバインドするようにし
+    た。
+  * デフォルトでRabbit APIをすべて公開するようにした。
+    （--default-public-level=all）
+  * rabbitter: OAuthを使用するようにした。
+  * rabrick: --druby-uriオプションを--rabbit-uriに変更した。
+  * rabbit-command: --druby-uriオプションを--rabbit-uriに変更した。
+  * コメントビューの削除。
+  * rabbitter: --user-languageオプションを追加。
+  * Windowsではrubyw.exeで起動されていたらデフォルトでGUIロガー
+    を使うようにした。
+    [なかださんが手助け]
+  * コンソールなしの状態で引数を指定せずに起動した場合はファ
+    イル選択ダイアログを表示するランチャーモードを追加。
+  * Hiki記法でタグをサポート。（{{tag('タグ名', '値')}}）
+
+==== テーマ
+
+  * title-background-image: スライドプロパティでの画像ファイ
+    ル名指定に対応。
+    [kdmsnrさんが提案]
+  * background-image-toolkit: テーマでオプションが指定されて
+    いても常にスライドプロパティを使うようにした。
+  * image: 画像のキャプションのフォントサイズをカスタマイズ
+    できるようにした。
+  * color-circle: newline-in-slidesテーマとtagテーマを有効に
+    した。
+  * slide-number: スライド番号を表示する位置をカスタマイズで
+    きるようにした。
+    [佐々木さん]
+  * debian: アップデート。
+    [佐々木さん]
+  * dark-gradation: 追加。Keynote風の暗めのグラデーションの
+    テーマ。
+    [佐々木さん]
+  * twitter-comment: 追加。Twitterのtweetをコメントとして取
+    り込むテーマ。
+    [おかべさんのコードをベースに改造]
+  * comment: 削除。廃止されたコメントビュー用のテーマ。
+  * footer-comment: 追加。コメントをフッターに表示するテーマ。
+    [おかべさんのコードをベースに改造]
+  * clutter-comment: 追加。コメントをClutterのAPIを利用して
+    ぐりんぐりんさせながら表示するテーマ。
+  * stream-comment: 追加。コメントをスライド上に流すテーマ。
+
+=== 修正
+
+==== 本体
+
+  * Clutterバックエンドが動かない問題を修正。
+    [おばたさんが報告]
+  * GUIロガーが動かない問題を修正。
+
+=== 感謝
+
+  * とみたさん
+  * kdmsnrさん
+  * おばたさん
+  * 佐々木さん
+  * おかべさん
+  * なかださん
 
 == 0.9.2: 2010-12-31
 

data/doc/ja/rd.rd

@@ -0,0 +1,489 @@
+---
+layout: ja
+title: RD
+apply_data: false
+---
+== RDとは何か
+
+RDとはRuby版のPODです。つまりRubyスクリプトファイルの中に埋め込む事を意図して
+定義されたドキュメントフォーマットです。
+
+RDは主にplain textをさまざまなフォーマットに変換するplain2というプログラム
+の影響を受けています。そのため、RDはplain textに似ており、シンプルですっきり
+した文法なので読みやすく書きやすいでしょう。
+
+== RubyインタプリタはRDをどのように扱うか
+
+Rubyのインタプリタは単純に"(({=begin}))"で始まる行から"(({=end}))"で始まる
+行までを無視します。ですから、スクリプトファイル中に埋め込む事ができるのは
+RDだけではありません。何でも(({=begin}))と(({=end}))の間に書く事ができるの
+です。RDは選択肢の一つにすぎませんが、Ruby標準のドキュメントフォーマットと
+されています。((-もし他のドキュメントフォーマットに興味があるなら、例えば
+rubyapi2
+((<URL:http://www.ueda.info.waseda.ac.jp/~igarashi/ruby/xml.html#rubyapi2>))
+などを見るといいでしょう。これはRuby/Gtkのような大規模ライブラリのドキュメン
+ト向けに作られています。-))
+
+== RDの基本的な概念と文法
+=== Element, Block, Inline
+
+これからの説明では"Element"という用語((-訳注: RDの文法用語についてはあ
+えて日本語訳をあてませんでした。-))をテキストに文章構造を与えるための
+構成要素という意味で用います。さらに、"((<Block>))"という用語を比較的
+大きくグローバルな構造を表すElementに、"((<Inline>))"という用語を比較的小さ
+くローカルな、テキストに付加的な修飾を与えるElementに対して用います。
+
+段落や見出し、リストなどがBlockです。RDではBlockを表すのに
+インデントや特殊文字を用います。Blockを入れ子にすることで複雑な
+構造も表現できます。そして、Blockの表現は自然とplain textに見え
+ます。詳しくは((<Block>))を見てください。
+
+強調やコードや参照などがInlineです。(('((? ... ?))'))のようなカッコと
+特殊文字の組合せがInlineの表現に使われます。ほとんどのInlineが互いに
+入れ子にできます。詳しくは((<Inline>))を見てください。
+
+=== Block
+==== 基本文法
+
+Blockは行指向の文法にしたがいます。つまり、同じ行にある文字はすべて同じ
+Blockに属しています。インデントはBlockの入れ子レベルとタイプを表して
+います。行の先頭の文字はBlockのタイプに関係します。
+
++ 概念と用語
+
+:Baseline
+  Baselineはインデントの基準です。ある行のインデントととBaselineの相対的
+  な深さはその行の属するBlockのタイプに影響します。
+
+:Head Char
+  Head Charは空白文字を除いた行の先頭の文字です。
+
+:STRINGLINE
+  STRINGLINEは普通の文字で構成された行です。STRINGLINEは"(({*}))",
+  "(({(((|num|)))}))", "(({:}))", "(({=}))", "(({+}))"といった文字を
+  Head Charとしては含みません。しかし、インデントされた行なら"(({=}))"
+  や"(({+}))"をHead Charとすることができます。
+
+:WHITELINE
+  WHITELINEは空白文字だけの行です。
+
+:Comment
+  (({/^#/}))にマッチする行はコメントとみなされます。
+
++ Baselineの決定と影響
+トップレベルでは((<Baseline>))は行の左端です。リスト内ではBaselineはListItem
+の最初の((<Block>))によって決定します。例えば、
+
+  Example: "|" はBaselineを表しています。
+    |この行はトップレベルのTextBlockの行だとします。
+    |<- したがって、Baselineは左端です。
+      *|List内では (1)
+       |<- このようにBaselineは(1)の行で決定されます。
+      *    |同じListでもListItem毎にBaselineが決定されます。
+           |<- したがって、1番目のListItemとは違うここにBaselineがあります。
+|この行はトップレベルのTextBlockの行だとします。
+|<- したがって、Baselineは左端です。
+  *|List内では (1)
+   |<- このようにBaselineは(1)の行で決定されます。
+  *    |同じListでもListItem毎にBaselineが決定されます。
+       |<- したがって、1番目のListItemとは違うここにBaselineがあります。
+
+Blockが別のBlockに入れ子になっている時には内部のBlockのBaselineは外側の
+BlockのBaselineよりも深くなります。
+
+Baselineとインデントの相対的な位置関係がBlockのタイプに影響します。
+Baselineと同じ深さにインデントされた((<STRINGLINE>))は((<TextBlock>))
+に属す行となります。一方Baselineより深くインデントされた((<STRINGLINE>))
+は((<Verbatim>))の行です。
+
+==== Blockのタイプ
++ Headline
+
+Headlineは"(({=}))"か"(({+}))"を((<Head Char>))とする行で構成されます。
+Headlineは1行以上にはなりません。Headlineはトップレベルだけに置く事が
+できます。
+
+  Example:
+  |<- トップレベルのBaseline
+  = Headline 1.
+  === Headline 1.1.1.
+  + Headline 1.1.1.1.1.
+
+= Headline 1.
+=== Headline 1.1.1.
++ Headline 1.1.1.1.1.
+
+Headlineの先頭の特殊文字はHeadlineのレベルを表しています。次の図で
+最初のマークは最も大きなレベルのもので、最後のマークがもっとも小さな
+レベルのものです。
+
+  Fig: Headline Marks
+  =
+  ==
+  ===
+  ====
+  +
+  ++
+
+マークに続くテキストはHeadlineのタイトルです。これは同時に
+((<Reference>))のラベルとして使われます。
+
+Headlineのタイトルには((<Reference>))とFootnoteを除く((<Inline>))を使う事が
+できます。
+
++ Include
+
+Includeは"(({<<<}))"を((<Head Char>))とし、その後ろにインクルードする
+ファイルの名前が続く行からなります。RD形式のファイルと出力するフォーマッ
+トで書かれたファイルのどちらでもIncludeによってインクルードできます。
+
+RD形式のファイルをインクルードする時にはインクルードされるファイルの名
+前は"foo.rd"の様に".rd"もしくは".rb"というサフィックスでなくてはなりま
+せん。そして、"(({<<<}))"の後にはサフィックスを含めたファイルの完全な
+名前を書きます。例えば、次の様にです。
+  <<< foo.rd
+
+出力するフォーマットのファイルをインクルードするには、インクルードされる
+ファイルはその出力フォーマットに固有のサフィックスを持たないといけません。
+例えば、HTMLのファイルをインクルードするには".html"というサフィックスを、
+Texinfo形式のファイルをインクルードするには".texi"というサフィックスを
+つけます。そして、"(({<<<}))"の後ろにはサフィックスを除いたファイルの
+名前を書きます。例えば、
+  <<< foo
+と書くわけです。
+
+この場合、RDフォーマッタはHTMLを出力する時には"foo.html"をインクルード
+し、Texinfo形式で出力する時には"foo.texi"をインクルードします。出力フォー
+マットのIncludeを用いる時には複数の(しかもなるべく多くの)形式のインク
+ルードファイルを用意すべきです。
+
++ TextBlock
+
+TextBlockは複数の((<STRINGLINE>))から構成されます。それらの行は((<Baseline>))
+と同じインデントでないといけません。((<Baseline>))より深い((<STRINGLINE>))は
+((<Verbatim>))の行とみなされます。
+
+TextBlockは((<Inline>))を内部に含む事ができます。
+
+  Example:
+  |
+  これはTextBlockです。
+  TextBlockの2行目の行です。
+    この行はTextBlockでなくVerbatimです。
+  * そしてこの行はListの行です。(正確にはListItemの中のTextBlockの行でも
+    あるのですが)
+
+この例は次のようにフォーマットされます。
+
+これはTextBlockです。
+TextBlockの2行目の行です。
+  この行はTextBlockでなくVerbatimです。
+* そしてこの行はListの行です。(正確にはListItemの中のTextBlockの行でも
+  あるのですが)
+
++ Verbatim
+
+Rubyスクリプトを引用するのにVerbatimを用いる事ができます。Verbatimは
+((<Baseline>))より深いインデントを持つ((<STRINGLINE>))で構成されます。
+Verbatimは"(({*}))"や"(({(1)}))"や"(({:}))"といった特殊文字を((<Head
+Char>))として持つ行も含む事ができますが、それらは最初の行には置く事
+ができません。最初の行にあるときには((<List>))と見なされます。Verbatim
+は最初の行より浅いインデントの行も含みません。Verbatimは((<WHITELINE>))
+を含める事ができます。
+
+((<Inline>))はVerbatim内では使えません。
+
+ Example:
+  これはVerbatimです。
+    最初の行より深いインデントを持っても、同じVerbatimの行になります。
+  * この行はListに見えますが、Verbatimです。
+ しかしこの行は最初の行よりも浅くインデントされているので、別のVerbatim
+ の行になります。
+
+この例が次のようにフォーマットされます。
+
+  これはVerbatimです。
+    最初の行より深いインデントを持っても、同じVerbatimの行になります。
+  * この行はListに見えますが、Verbatimです。
+ しかしこの行は最初の行よりも浅くインデントされているので、別のVerbatim
+ の行になります。
+
++ List
+
+Listは特殊な((<Block>))です。Listは複数のListItemから構成され、ListItem
+は複数のBlockから構成されます。したがって、ListはBlockを内部に含む事が
+できます。含む事のできるBlockにはList自身も含みます。((-((<Headline>))
+や((<Include>))はList内部に持てません。-))
+
+ListItemは((<WHITELINE>))を含む事ができますが、((<TextBlock>))は
+持てません。そのため、WHITELINEを間にはさむ事によって複数のTextBlock
+をListItem内部に置く事ができます。
+
+Listには"((<ItemList>))"、"((<EnumList>))"、"((<DescList>))",
+"((<MethodList>))の4種類があります。
+
+++ ItemList
+
+ItemListは単純な番号付されないListです。ItemListItemは"(({*}))"という
+((<Head Char>))の行で始まります。ItemListItemの最初のBlockは必ず
+((<TextBlock>))になります。
+
+  Example:
+  * 親Listの最初のItem
+      * 子Listの最初のItem
+      * 子Listの2番目のItem
+    親ListのItemに含まれるTextBlock
+
+下のようにフォーマットされます。
+
+  * 親Listの最初のItem
+      * 子Listの最初のItem
+      * 子Listの2番目のItem
+    親ListのItemに含まれるTextBlock
+
+++ EnumList
+
+EnumListは番号付されたListです。EnumListItemは"(({((|num|))}))"(((|num|))
+は整数)という((<Head Char>))の行ではじまります。他の点ではEnumListは
+((<ItemList>))と同じです。
+
+  Example:
+  (1) 親Listの最初のItem
+        * 子ListとなるItemList
+  (2) 親Listの2番目のItem
+  (10) 番号は無視されます。
+
+次のようにフォーマットされます。
+
+  (1) 親Listの最初のItem
+        * 子ListとなるItemList
+  (2) 親Listの2番目のItem
+  (10) 番号は無視されます。
+
+++ DescList
+
+DescListは用語説明のためのListです。DescListItemは2つの部分からなります。
+1つはTermパートでもう1つはDescriptionパートです。Termパートは((<Reference>))
+のLabelとして使われます。
+
+Termパートは"(({:}))"という((<Head Char>))の行からなります。Termパートの
+行はインデントできることを除くとTermパートは((<Headline>))と同様です。
+
+DescriptionパートはTermパートの次の行からはじまります。Descriptionパート
+の((<Baseline>))はTermパートの(((<Head Char>))を除いた)テキスト部分と
+同じかより深くないといけません。例えば次の例は間違っています。
+
+  Example:
+  :   |Term
+    |Description.
+
+Descriptionぱーとは複数の((<Block>))を含む事ができます。((<List>))を
+最初のBlockとすることもできます。Termパートは((<Inline>))を含む事が
+できますが、((<Reference>))とFootnoteは例外です。
+
+  Example:
+  :Term
+     Descriptionの最初の行
+     2番目の行
+  :Term2
+     * Listも含む事ができます
+     * ...
+
+次のようにフォーマットされます。
+
+  :Term
+     Descriptionの最初の行
+     2番目の行
+  :Term2
+     * Listも含む事ができます
+     * ...
+
+++ MethodList
+
+MethodListはメソッドの説明のための特殊なタイプの((<DescList>))です。
+ほとんどの点でMethodListは((<DescList>))と同様ですが、Labelの規則
+は違っています。RDフォーマッタはMethodListのTermパートがなんらかの
+Rubyのあるクラスのメソッドや定数やCの関数プロトタイプといったような
+プログラムのコードであると知っています。そのため、MethodListは
+メソッドの引数のように見える部分を除いた上でLabelとなります。詳細は
+((<LabelとReference>))を見てください。
+
+MethodListItemは((<DescList>))と同様にTermパートとDescription
+パートを持ちます。Termパートは"(({---}))"という((<Head Char>))
+の行でなり、Descriptionパートは((<TextBlock>))や((<Verbatim>))
+、((<List>))を含む事ができます。しかし、逆にMethodListを((<List>))
+の中に置くべきではありません。RDは将来的にはこれを禁止するかも
+しれません。
+
+  Example:
+  --- Array#each {|i| ... } # => Labelは"Array#each"
+        各項目に対してブロックを評価する。
+  --- Array#index(val) # => Labelは"Array#index"
+        ((|val|))と同じ値である最初の項目を返す。同じ項目が無いときには
+        (({nil}))を返す。
+
+この例が次のようにフォーマットされます。
+
+  --- Array#each {|i| ... }
+        各項目に対してブロックを評価する。
+  --- Array#index(val)
+        ((|val|))と同じ値である最初の項目を返す。同じ項目が無いときには
+        (({nil}))を返す。
+
+フォーマッタのいくつかはMethodListのTermパートに書かれているのはRuby
+のメソッドや定数などであると仮定しています。そういったフォーマッタでは
+MethodListのTermパートをインテリジェントに扱う事ができますが、そのため
+には特定の慣習にしたがってRDを書く必要があります。
+
+標準的なRubyクラスリファレンスのための慣習として次のようなものが提案さ
+れています。
+  : インスタンスメソッド
+      クラス((|Class|))のインスタンスメソッド((|method|))
+        Class#method(its params  ...) { parameter block }
+  : クラスメソッド(クラスの特異メソッド)
+      クラス((|Class|))のクラスメソッド((|method|))
+        Class.method(its params ...) { parameter block }
+  : クラス定数
+      クラス((|Class|))の定数((|Const|))
+        Class::Const
+  : 関数メソッド
+      関数((|func|))
+        function#func(its params ...) { parameter block }
+
+Rubyはいくつかの特殊な文字(e.g. [], []=, +, -, <<, ...)はメソッドの名前
+(識別子)として使います。この時、Rubyインタプリタはこれらのメソッドの
+パースを普通のメソッドとは違ったやりかた(演算子メソッド)で行います。
+しかし、この慣習ではこれらの演算子メソッドも同じように書きます。
+
+  Example:
+    --- Array#[](key)
+          ((|key|))に対応する値を返す。
+    --- Array#[]=(key, value)
+          ((|key|))の場所に((|value|))を格納する。
+    --- Array#+(other)
+          2つの(({Array}))を結合してそれを返します。
+
+=== Inline
+Inlineは((<TextBlock>))や((<Headline>))、((<DescList>))のTermパートの
+中で使う事ができます。カッコを使ったマークアップがInlineに使われます。
+Inline同士は互いに入れ子にできます。
+
+次のInlineの一覧では左側に書式を、右側にフォーマット後の様子を表示
+しています。
+
+:(('((*Em*))')) => ((*Em*))
+    強調
+
+:(('(({while gets...}))')) => (({while gets...}))
+    プログラムのコード
+
+:(('((|var|))')) => ((|var|))
+    メタ変数((- Varについての詳しい説明はtexinfo.texiの該当部分にあります。-))
+
+:(('((%ruby -v%))')) => ((%ruby -v%))
+    キーボード
+
+:(('((:Term:))'))
+    => ((:Term:))
+
+    インデクスやキーワードとなる用語の指定
+
+:(('((<Identity or URL>))'))
+    => ((<Indentity or URL>))
+
+    参照。詳しくは((<LabelとReference>))を見てください。
+
+:(('((-Footnote-))'))
+    => ((-Footnote-))
+
+    脚注
+
+:(('(('verb\'))')) => (('verb'))
+    Inlineのvarbatim(フォーマット抑制)
+
+==== LabelとReference
+
+ReferenceにはLabelが必要です。RDでは((<Headline>))のタイトルと((<DescList>))
+や((<MethodList>))のTermパートだけがLabelとなります。したがって、各々の
+((<Headline>))には違うタイトルをつけてあげなくてはなりません。この問題の
+きちんとした解決策はまだ見付かっていません。
+
++ どのようにLabelがつけられるか
+
+((<Headline>))のタイトルと((<DescList>))や((<MethodList>))のTermパートが
+Labelとして使われます。しかし、((<Inline>))が含まれるために、それらが
+そのままLabelとして使われる、というほど単純ではありません。
+
+第一に、((<MethodList>))はLabel付けにおいてはやや特殊です。((<MethodList>))
+のTermパートは((<Inline>))を含みませんが、その代わりRDでは((<MethodList>))
+のTermパートはメソッドリファレンスやそれに類似の物とみなされますので、次の
+ようなルールでラベルが付けられます。
+
+  (1) "(({(}))"や"(({{}))"の前にあるテキストだけがラベルと見なされる。((-
+      "(({(...)}))"の内部のテキストはメソッドの引数だと見なされ、
+      "(({{...}}))"の内部のテキストはメソッドのブロックと見なされるのです。-))
+
+次の例を見れば、どのようにルールが適用されているかわかるでしょう。
+"(({# =>}))"より右にあるのが((<MethodList>))のTermパートから抽出された
+Labelです。
+
+  Example:
+    --- Array.new([size[, val]]) # => Array.new
+    --- Array#[]=(key, val) # => Array#[]=
+    --- Array#each { ... } # => Array#each
+    --- void rb_define_method(VALUE class, ...) # => void rb_define_method
+
+次に、((<Headline>))のタイトルや((<DescList>))のTermパートの場合には、この
+ような特別なルールはありませんが、((<Inline>))を含む事があるので、((<Inline>))
+に用いるカッコを取り除くためのルールがあります。
+
+  (1)どんな((<Inline>))修飾もLabelには影響しません。したがって、
+        = ((*Headline*))
+      と
+        = Headline
+      は共に"Headline"とLabelが決まります。
+  (2)しかし、Labelを抽出する際には((<Inline>))の開始カッコの後ろと終端カッコ
+     の前にある空白文字は取り除かれます。したがって、
+        = ((* Headline  *))
+     も
+        = ((*Headline*))
+     も"Headline"とLabelがつけられます。
+
++ Reference
+
+LabelのつけられたElementはReferenceによって参照できます。Referenceは
+(('((<...>))'))というカッコで修飾される((<Inline>))です。
+
+最も簡単なReferenceの使用法は、単にLabelをそのカッコの中に書けばよいのです。
+  ((<Label>))
+これは"Label"というLabelに対する参照となります。また、フォーマッタによる
+出力では"Label"というテキストが表示にも使われます。例: ((<Label>))((-
+"Label"というLabelのついたElementが無いのでおそらくReferenceの様には
+見えないでしょう。-))
+
+URLによって示されたリソースを参照するには次のように書きます。
+  ((<URL:http://www.ruby-lang.org/en/raa.html>))
+可能ならRDフォーマッタはURLを次のようにハイパーリンクします。例:
+((<URL:http://www.ruby-lang.org/en/raa.html>)).
+
+Labelとは違うテキストを表示に使いたい時には次のように書きます。
+  ((<Text for display|Label>))
+"Text for display"が表示用のテキストとして使われ、"Label"がLabelとして
+使われます。例: ((<Text for display|Label>))
+
+表示用のテキストは((<Inline>))を含む事ができます。しかし、Footnoteと
+Reference自身を含む事はできません。
+
+Reference内では"|"や"/"は特殊文字なのでこれらを使いたい時には、それを含む
+部分ごとダブルクオートで囲ってやらないといけません。これはReference内のどの
+部分でも同じです。
+   ((<"Bar | inside display text"|Label>))
+((<"Bar | inside display text"|Label>))
+
+表示用のテキストはURLへのReferenceにも使う事ができます。
+   ((<Ruby Application Archive|URL:http://www.ruby-lang.org/en/raa.html>))
+((<Ruby Application Archive|URL:http://www.ruby-lang.org/en/raa.html>))
+
+表示用のテキストが無い場合には代わりにLabelに((<Inline>))を使えます。
+   ((<((*Label*))>))
+((<((*Label*))>))