お薦め ページ

メニュー

ハワイ島 遊覧飛行ツアー

ハワイ島 Ｂ＆Ｂ・ホテル

ハワイ島 不動産情報

ハワイ島 情報・観光ガイド

ブログ(Blog)

その他

関連サイト

: 個別エントリー・アーカイブ :

« Eclipse Language Pack と RDT との相性 メイン RDoc »

2006年12月20日

RD (Ruby Document)

Ruby関連の情報をいろいろ調べていると、「RD」という言葉に遭遇することが多々ある。 では、「RD」とは、一体 何のことなのか。

まず、私が一番はじめに「RD」という言葉に遭遇したのは Rubyの「コメント」について調査した時。 以前のブログ 「Ruby の コメント（１）」 でも書いたとおり、Rubyのコメントには二通りあって、 行コメント としての「＃」 と ブロックコメントの「=begin 〜 =end」。 しかし、このブロックコメントの方は、マニュアル上 コメントとは呼ばずに 「埋め込みドキュメント」 と呼んでいる。 その「=begin 〜 =end」についての説明部分を引用させていただくと。
Rubyのソースコードにドキュメントを埋め込む事ができます。 文が始まる部分の行頭の =begin から、 =end で始まる行までが埋め込みドキュメントです。 Rubyインタプリタとしては内容に縛りはかけませんが、 通常はRD形式でドキュメントを埋め込むことを期待しています。
とある。ここで「RD形式」という表現が使われている。

では、Ruby リファレンスマニュアル 「RD」 ページでの説明は、というと、ここでの説明は一行だけ。
このリファレンスマニュアルでも使われているドキュメント形式です。
あとは、関連記事へのリンクである。

いろいろリンクを辿ってみると、 「RD とは POD のようなドキュメントフォーマットである」という記述があった。 ここで言う「POD」とは何であろう。 ご存知の通り、RubyはPerlの影響を強く受けている。 そのPerlのドキュメントの基本形が 「POD(Plain Old Document)」である。 「RD」とは、このPerlの「POD」を参考にし ドキュメント形式を Ruby風にアレンジしたもののようだ。

RDの文法は POD にも似ているが Wikiにも似ていてる。 例を挙げると 「= で始まる行はタイトルになる。」 「周辺より字下げが深い箇所はそのまま出力」 「箇条書きは行頭が * で始まっている行で表す」 というようになっている。 文法について詳しくは 「RD working draft 日本語版」 に解説してある。

また文法が Wikiに似ているということから、 このRDの文法そのままで Wikiしてしまうという 「Rwiki」 というアプリケーションも存在している。

それから RDフォーマットのファイルからhtml 等の フォーマットへ変換するアプリケーションが 「RDtool」だ。 このRDtoolは、残念ながらRubyのシステムにデフォルトでは組み込まれていないようだ。

【参考リンク】

カテゴリー: Ruby     2006年12月20日 22:44

トラックバック

このエントリーのトラックバックURL:
http://www.skymerica.com/blog/yotsumoto/mt/mt-tb.cgi/654


コメント

コメントしてください




保存しますか?


 
ハワイ島での遊覧飛行ツアーとＢ＆Ｂのスペシャリスト、スカイメリカ
Copyright © 2003,2009 Skymerica Corp. All rights reserved.