概要
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での記述
他のドキュメントへの変換
Public Git Hosting - rst2info.git/summary:texinfo
rst2pdf - Project Hosting on Google Code:PDF
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
JRst - reStructuredText parser : JRst
関連
http://www.rutherfurd.net/articles/rst-ht2html.html
http://www.rutherfurd.net/software/rst2ht/
参考サイト
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/
reStructuredText - 物理のかぎプロジェクトWiki
Python Implementation of Markdown:ほかのマークアップ