Bye Bye Moore

PoCソルジャーな零細事業主が作業メモを残すブログ

sphinx

Sphinx S6でHTMLのプレゼンをつくる

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

Sphinx拡張群が凄い! なるか、書類仕事自動化!? 

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

日本語入力はUTF-8で

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

ドキュメント作成環境Sphinx

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