<!-- =begin = RD2XML for JavaScript == Name RD2XML for JavaScript - convert rd files to XML == Abstract 主にRubyで使われるドキュメント形式であるRD形式を、 XMLに変換するJavaScriptです。 一般には、これで生成したXMLをXSLTでHTMLに変換して使うことになります。 == Description RDの存在を知って、いろいろ遊んでみようと思ったのですが、 RDtoolはRubyが必要な上に、外部依存のライブラリを集めるだけで一苦労、 Windowsで動かすためにコンパイル済みのライブラリを探すのでへとへと、 とあまりに大変だったので、あきらめかけました。 そんなこんなで逆に開き直って、自分でRD解析機を作ることにしたのです。 どの言語で作ろうか、少し迷ったのですが、 ここはせっかくなのでMocaScriptで作ることにしました。 MocaScriptで作っておけば、JavaScriptに移植するのも楽ですし、 JavaScriptで動けば、近頃のOSにはたいていブラウザが存在し、JavaScriptが動くので、 まさに“Write Once, Run Anywhere”です。（違 そうやって作ったMocaScript版をHTML+JavaScriptに移植したものがこれになります。 これはRDtoolのように、単体でRDから任意の形式に変換することを目指さず、 一度中間形式としてのXMLに変換して、その後XSLTで任意の形式に変換することにしました。 このため、別の形式に変換したくなったとしても、 このスクリプトのソースを細部まで読まなくてもよく、 XSLTだけを書けばよいのです。 本スクリプトは「RDtoolのJavaScript版」ではなく、 ((<RD working draft 日本語版>))を参考に、RD解析･表現を独自に実装しているため、 RD処理機の事実上の標準である((<RDtool>))とは、解釈が異なる場合があります。 == Synopsis 上のTEXTAREAにRD形式の文書を入れて、「変換」を押すと、下のTEXTAREAに変換結果が表示されます。 XSLTファイルの名前を変えたりしてから使ってください。 == Bugs and Limitations :脚注が処理できない 実装する必要があるかどうか、どうやって実装するか、迷ってます。 :コードが汚い 解析にInterpreterパターンを使い、XML書き出しをMSXML ParserをcreateObjectで呼び出して行う、 ということも夢見たのですが、現時点ではどちらも良くわからなかったので、こうなってしまいました。 コードの綺麗さよりもとりあえず動くものが欲しかったもので。。。 将来的に書き直したいとは思っているのですが。 :RDtoolと変換結果が異なる 仕様です。 :書き出すときのエンコードがShift_JIS固定 仕様です。 == See also :RD working draft 日本語版 ((<URL:http://www.ruby-lang.org/~rubikitch/RDP.cgi?cmd=view;name=RD>)) :Ruby Documentation Project ((<URL:http://www.ruby-lang.org/~rubikitch/RDP.cgi?cmd=view;name=top>)) :RD事始め ((<URL:http://www.ruby-lang.org/~rubikitch/computer/rd-intro/>)) :CGI版RDコンバータ ((<URL:http://www.ruby-lang.org/~rubikitch/makerd.html>)) :RDtool ((<URL:http://www2.pos.to/~tosh/ruby/rdtool/ja/>)) == License 一切を放棄し、PublicDomainとします。 このソースの一部または全部を利用しても、著作権表示をする必要はありませんし、 派生物のソースを公開する義務もありません。 このスクリプトを綺麗に書き直して下さった場合、公開してくださると助かりますが、 これもやはり義務ではありません。 ちなみに、((<RDtool>))のソースは一切見ていません。 参考にしたのは、((<RD working draft 日本語版>))と、((<RD事始め>))の紹介の部分です。 ((<CGI版RDコンバータ>))のソースは見ていません。 言語規格に著作権は無いはずなので、このスクリプトの著作権は成瀬のみに属していました。 == History :Revision: 1.2 (2003-05-23) rd2xml.ms Revision: 1.3に追従 :Revision: 1.1 (2003-03-22) 最初のバージョン。 RD2XML for MocaScriptをJavaScriptで書き直したもの。 == Author 成瀬ゆい ((<URL:mailto:naruse@airemix.com>)) == Copyright Copyright (c) 2001-2003 Airemix. No rights reserved. =end -->
変換(S)
Point of No Return