久しぶりにShphinxでドキュメント生成を行う。ソースを変更する前に、まずは既存の内容を確認するためhtmlを生成させてみるが、何故かエラーが発生してしまう。ログ出力の内容は下記の通り。 % make html sphinx-build -b html -d _build/doctrees . _build/…

Sphinxは、HTMLだけではなく他の形式でも出力可能だ。今回はPDFを生成出来るようにしてみた。Windowsでの導入方法については下記のエントリが詳しい。 Sphinxでドキュメント生成-PDF（Windowsでの始め方） - torutkのブログ 今回はMacで試してみた。動作環境…

最近、Sphinxを使ってドキュメントを書いている。元々、Wordのようにチマチマと自分で文字のレイアウトや装飾を指定するタイプは好きではなく、LaTeXのように「プレーンテキストで文章を書いて、コマンド一発で出力を生成。レイアウト等は一切お任せ」型のシ…