Sphinx
debian 6 から 7.0 に upgrade したところ、sphinx の make html でエラーが出るようになってしまった。 Extension error Extension error: Could not import extension sphinxcontrib.plantuml (exception: No module named plantuml) make: *** [html] エ…
Python のパッケージをインストールする場合、virtualenv を使うのが常識のよう なので、sphinxやその拡張もシステムに直接インストールせずに、virtualenv環境でやってみようと考えていました。 sphinxのビルド環境を virtualenv で用意する(ドキュメント…
Sphinx Advent Calendar 2012 - connpass の 15日目のエントリとなります。本日は、pandocというドキュメント変換ツールの紹介です。 Sphinx を使う場合、reSTにてドキュメントを記述しますが、例えばプロジェクト管理にRedmineを導入している場合、Wikiに書…
TokyoMercurial#6 - connpass に参加しました*1 sphinxcontrib-mercurial リリース! 今回は、対面に 西原さん(TortoiseHg コミッタ で Sphinx の plantuml 拡張を実装された)がいました。Sphinx拡張周りの実装のことを聞いて、なんとか sphinxcontrib-merc…
SphinxからPDFを出力する方法は 2通り あります。今回は、rst2pdfを用いた方法でやってみました。 こんな感じで出力されます。 環境 Windows 7 Professional 64-bit Python 2.7.3 32-bit Sphinx 1.1.3 msysgit または MinGW/MSYS pip をあらかじめインスト…
htmlで書かれたファイルを rest に変換したくなりました。Sphinxを触っているとたぶん誰もが一度は通る道な気がします。しかし Sphinx の 逆引き辞典 や クックブックには無かったのでググった。いくつか試してみた。 うまくいった方法 codeigniter-jp/html2…
前回の エントリ にて紹介した sphinx_git という git のチェンジログをSphinxに埋め込む拡張を紹介しましたが、 sphinx-git便利だわ〜。だれかmercurialのを作らないかな。— しろうさん (@r_rudi) 9月 14, 2012はい。つくってみました。 こんな感じで表示*1…
sphinx-git が便利らしい sphinx-git便利だわ〜。だれかmercurialのを作らないかな。— しろうさん (@r_rudi) 9月 14, 2012そもそも sphinx-git ってなんだろう。ちょっと試してみた。 結論 こんな感じで表示された リポジトリを指定するものだと勘違いしてい…
Sphinxドキュメントのリポジトリを指定するとビルドとHTMLサイトのホスティングをしてくれるサービス Read the Docs を試してみました。 元ネタ ReadTheDocsでSphinxホスティングは磐石(になる予定) - YAMAGUCHI::weblog 公式ドキュメント 公式 Welcome to…
SphinxConJP 2012 が本日開催され、計7件のセッションがありました。それぞれスライド内容をレポートとしてまとめました。 イベント概要 SphinxCon JP 2012 開催 (2012/9/16) :: ドキュメンテーションツール スフィンクス Sphinx-users.jp Twitter まとめ 世…