#pragma section-numbers off
[[TableOfContents]]

= 概要 =
reStructuredText

= URL =
http://docutils.sourceforge.net/

http://sourceforge.net/projects/docutils/

= インストール =
最新版を取得してください。

http://docutils.sourceforge.net/docutils-snapshot.tgz

{{{
sudo python setup.py install
}}}

tools以下は手でコピーするのが良いです。

http://docutils.sourceforge.net/sandbox/oliverr/docbook/

http://docutils.sourceforge.net/sandbox/pobrien/

= 設定 =
日本語モジュールはないです。

http://docutils.sourceforge.net/spec/howto/i18n.html

http://www.oasis-open.org/cover/iso639a.html

とりあえず英語をコピーします。というか英語のままでもそれほど問題ないです。
{{{
sudo cp /Library/Python/2.3/docutils/languages/en.py /Library/Python/2.3/docutils/languages/ja.py 
}}}

= 利用方法 =
http://lowlife.jp/yasusii/wiki/restructuredtext.html

http://docutils.sourceforge.net/docs/rst/quickref.html

を読めばだいたい大丈夫。

http://docutils.sourceforge.net/spec/rst/reStructuredText.txt

が最良のリファレンスになります。

== リンク ==
その場でリンク生成
{{{
`紹介マニア <http://sakito.s2.xrea.com/>`_ 参照
}}}
みたいに書けばいいです。

以後

{{{
紹介マニア_
}}}
でリンク生成できます。

== 忠告フィールド ==
忠告用のフィールドを定義できます。
{{{
.. Danger:: modify at your own risk!
}}}
みたいにすると

{{{
<div class="danger">
<p class="admonition-title">!DANGER!</p>
modify at your own risk!</div>
}}}
みたいになるのでcssでclassに色定義するなりなんなりしてください。

http://docutils.sourceforge.net/spec/rst/directives.html#admonitions

== コメント ==
{{{
.. こんにちは
}}}
です。

{{{
<!-- こんにちは -->
}}}

隠しコメントってできるのかな?

== テーブル ==
素のままだと日本語でテーブル組めません。(正確には組めるけどつかい物にはならないです)

http://city.plala.jp/download/rst/

= Emacsでの記述 =
MacEmacs:reSTmode

= 他のドキュメントへの変換 =
[http://repo.or.cz/w/rst2info.git Public Git Hosting - rst2info.git/summary]:texinfo

[http://code.google.com/p/rst2pdf/ rst2pdf - Project Hosting on Google Code]:PDF

[http://www.rexx.com/~dkuhlman/odtwriter.html Odtwriter for Docutils]:ODT(OOo Writer)

http://docutils.sourceforge.net/sandbox/OpenDocument/

= 他のドキュメントからの変換 =
DocBook から rst へ http://code.google.com/p/db2rst/

http://johnmacfarlane.net/pandoc/

= Java =
[http://jrst.labs.libre-entreprise.org/jrst/en/user/index.html JRst - reStructuredText parser : JRst]

= 関連 =
http://www.rutherfurd.net/articles/rst-ht2html.html

http://www.rutherfurd.net/software/rst2ht/

[http://www.voidspace.org.uk/python/rest2web/ rest2web - The Site Builder]


= 参考サイト =
http://lowlife.jp/yasusii/wiki/restructuredtext.html

http://www-6.ibm.com/jp/developerworks/xml/030411/j_x-matters24.html

http://cvs.m17n.org/~akr/markup

http://city.plala.jp/download/rst/

http://zenkai.atransia.co.jp/blog/25

http://www.python.jp/pipermail/python-ml-jp/2003-November/002598.html

http://arch.flibuste.net/libre/docs-tla/docs-tla--fr/docs-tla--fr--1.0/

http://flibuste.net/libre/tlafr/

[http://hooktail.org/wiki/index.php?reStructuredText reStructuredText - 物理のかぎプロジェクトWiki]

[http://www.freewisdom.org/projects/python-markdown/ Python Implementation of Markdown]:ほかのマークアップ

----
CategoryPrograming
CategoryPython