前提 Sphinx導入済み Mac OS X 10.8 導入 $ sudo easy_install sphinxjp.themes.s6 設定 まずは叩き台としてsphinx-quickstartをやります。 $ sphinx-quickstart例のごとくトップページに色々とファイルが作成されます。 今回はindex.rstとconf.pyを以下のよ…

卒論を書いた時に利用したっきり放置していたSphinxの記事です。 oreillyの新刊にSphinx解説の電子書籍が出たみたいだし、久々に弄ってみるかーと調べ直した所……拡張群がトンでもない事に今更気付いてしまいました。 S6 なんと、プレゼンテーションファイル…

Sphinxで日本語入力をしようとしたところ、 C:\Users\shuzo_kino\doc\index.rst:91: WARNING: undecodable source characters, replacing with "?": '\x00\xd8N2>>>\x93 といった感じのエラーが大量に発生しました。 読めばわかりますが、エンコードエラーで…

Sphinxは知的で美しいドキュメントを簡単に作れるようにするツールです。 （公式サイトより）Pythonベースで、HTML、Latex、PDFの出力に対応しているとの事。 Latex対応ということで、数式、ソースコードを貼り付けるにも向いていそうです。 公式サイト（日…