Sphinx

SphinxのTipsを紹介

Sphinxでマニュアルを書き始めてノウハウがちょっとずつたまってきたので、Tipsを書いていこうと思います。整理してまとめて書くと時間がかかり陳腐化しそうなので、書けた部分から小出しで紹介していきます。 includeディレクティブで画像も含めて取り込む…

JVM(Jython)上でSphinxを動かしてみた

使い道がないかもしれないが... 以下を参照すると、Jython上でPygmentsは動かないがいけるっぽい。 http://stackoverflow.com/questions/1085791/does-sphinx-run-on-jython http://bitbucket.org/birkenfeld/sphinx/issue/265/sphinx-doesnt-run-with-jytho…

ドキュメント作成ツールの検討(Sphinx、ReVIEWとか)

今後、マニュアルを書いてメンテナンスも継続的にしていく機会が丁度ありそうなので、現時点(2012/05/02)でどのツールが自分たちにフィットするか検討してみた。ツールの候補は以下。なお、過去の仕事ではWordとDocBookは経験あり。 Word DocBook Sphinx ReV…