読者です 読者をやめる 読者になる 読者になる

secretbase.log

コードはすべてNYSLです

Sphinx

debian 7 の Sphinx にて Could not import extension となる問題の原因と対策

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] エ…

virtualenv 環境で sphinx を試してエラーが出て先生に尋ねたら解決した

Python のパッケージをインストールする場合、virtualenv を使うのが常識のよう なので、sphinxやその拡張もシステムに直接インストールせずに、virtualenv環境でやってみようと考えていました。 sphinxのビルド環境を virtualenv で用意する(ドキュメント…

pandoc で Redmine の Wiki を Sphinx に変換しよう

Sphinx Advent Calendar 2012 - connpass の 15日目のエントリとなります。本日は、pandocというドキュメント変換ツールの紹介です。 Sphinx を使う場合、reSTにてドキュメントを記述しますが、例えばプロジェクト管理にRedmineを導入している場合、Wikiに書…

sphinxcontrib-mercurial 0.2 リリース

TokyoMercurial#6 - connpass に参加しました*1 sphinxcontrib-mercurial リリース! 今回は、対面に 西原さん(TortoiseHg コミッタ で Sphinx の plantuml 拡張を実装された)がいました。Sphinx拡張周りの実装のことを聞いて、なんとか sphinxcontrib-merc…

rst2pdf で Sphinx から PDF 出力する方法 (Windows編)

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変換がなんとかうまくいった

htmlで書かれたファイルを rest に変換したくなりました。Sphinxを触っているとたぶん誰もが一度は通る道な気がします。しかし Sphinx の 逆引き辞典 や クックブックには無かったのでググった。いくつか試してみた。 うまくいった方法 codeigniter-jp/html2…

sphinx-hg (SphinxにMercurialのコミットログ埋め込む拡張)つくってみた

前回の エントリ にて紹介した sphinx_git という git のチェンジログをSphinxに埋め込む拡張を紹介しましたが、 sphinx-git便利だわ〜。だれかmercurialのを作らないかな。— しろうさん (@r_rudi) 9月 14, 2012はい。つくってみました。 こんな感じで表示*1…

sphinx で Git の ChangeLog を埋め込む方法 (sphinx-git)

sphinx-git が便利らしい sphinx-git便利だわ〜。だれかmercurialのを作らないかな。— しろうさん (@r_rudi) 9月 14, 2012そもそも sphinx-git ってなんだろう。ちょっと試してみた。 結論 こんな感じで表示された リポジトリを指定するものだと勘違いしてい…

Read The Docs (Sphinxドキュメントホスティングサービス) が便利なので紹介

Sphinxドキュメントのリポジトリを指定するとビルドとHTMLサイトのホスティングをしてくれるサービス Read the Docs を試してみました。 元ネタ ReadTheDocsでSphinxホスティングは磐石(になる予定) - YAMAGUCHI::weblog 公式ドキュメント 公式 Welcome to…

SphinxConJP 2012 (世界ではじめてのSphinxカンファレンス) 参加レポート

SphinxConJP 2012 が本日開催され、計7件のセッションがありました。それぞれスライド内容をレポートとしてまとめました。 イベント概要 SphinxCon JP 2012 開催 (2012/9/16) :: ドキュメンテーションツール スフィンクス Sphinx-users.jp Twitter まとめ 世…