reST 経由でドキュメントを生成したいのですが、手動で reST ソースを書きたくないのですが、Python スクリプトにそれをさせてから、sphinx で他の形式 (HTML、PDF) を生成します。
バイナリ形式の電話帳があるとします。次に、Python スクリプトを使用してこれを解析し、すべての名前と番号を含むドキュメントを生成します。
phone_book = PhonebookParser("somefile.bin")
restdoc = restProducer.NewDocument()
for entry in phone_book:
restdoc.add_section( title = entry.name, body = entry.number )
restdoc.write_to_file("phonebook.rst")
次に、pdf と html を生成するために sphinx を呼び出します。
> sphinx phonebook.rst -o phonebook.pdf
> sphinx phonebook.rst -o phonebook.html
reSTを生成するためのAPIを提供するpythonモジュール(上記の例ではrestProducer)はありますか?または、いくつかの print ステートメントを介して reST マークアップをダンプする最良の方法はありますか?