«

»

7月 07

Print this 投稿

Sphinx+blockdiagを3行でインストール

2011/07/07

sphinx + blockdiag で始めるドキュメント生活 2011/05 yokohama.pm
View more presentations from Takeshi Komiya

小宮さんのスライドに衝撃を受けて，MacBook AirにSphinx+blockdiag環境を作ったろう！と思ったものの，インストール方法をググればググるほどに混乱してきた．

結論から言うとHomeBrewのインストール含めて3行だった．

ruby -e "$(curl -fsSL https://raw.github.com/gist/323731)" # HomeBrewのインストール
brew install pip # HomeBrewでpipのインストール
pip install -U sphinxcontrib-blockdiag # pipでSphinxcontrib-blockdiagをインストール

pipが適当に依存性解決してくれる．
小職の環境だとこんな感じ．

Successfully installed blockdiag docutils funcparserlib Jinja2 PIL Pygments Sphinx sphinxcontrib-blockdiag webcolors

HomeBrewが使える環境ならわずか2行．

HomeBrewでsearchしても”sphinx”というパッケージが見つかるけど，
これは同名の検索サーバなので巧妙な孔明の罠．

Sphinxのhtmlテーマ，オススメは”cloud_sptheme“です．

※ 実は3行で終わらないことが発覚！
MacOSX (homebrew) の場合を見ると，pipで入れたPILじゃblockdiagが動いてくれないらしい．
Freetype2のFormula足して，easy_install –upgrade pilすると「FREETYPE2 support available」になってちゃんと図が描けるようになりました！

Similar Posts:

Share on Facebook
Sphinx+blockdiagを3行でインストールb - log

タグ: , , ,

Permanent link to this article: http://bellonieta.net/2011/07/sphinxblockdiag%e3%82%923%e8%a1%8c%e3%81%a7%e3%82%a4%e3%83%b3%e3%82%b9%e3%83%88%e3%83%bc%e3%83%ab/

1 個のping

  1. Sphinxの設定とか | b-log

    2011/07/08 at 12:00 AM (UTC 9)

    返信

    [...] 「3行で！」とか大嘘ついちゃったので，せめてScreenShotぐらい載せる… blockdiagを使うために弄ったconf.pyの部分も． [...]

コメントを残す

メールアドレスは公開されません