sphinx でtext からドキュメント作成

• http://sphinx-users.jp/index.html
• http://sphinx.shibu.jp/
• http://labs.timedia.co.jp/2011/05/sphinx-blockdiag-yokohamapm-201105.html

このような、プログラマーがドキュメントを書きたくなってしまうすばらしいツールに乾杯！”

reST(reStructuredText; HTTP の RESTじゃないyp) でテキストを書いて、ドキュメントに変換する。markdown、wiki記法みたいなもの？

blockdiag からsphinx を知ったんですが、なかなか良い感じですね。make html, make pdf, make latex, などで色々作れるし！ make pdf するには rst2pdf というpython ライブラリがいるのでeasy_install しとく。(もしくは latex からpdf 作るか?)

$ sudo apt-get install python-sphinx