MacにPythonとSphinx, blockdiagをセットアップ

HomebrewでPython（とPIL）をインストール（Macデフォルトと環境を分ける）

brew install python pil

.zshrc (.bashrc) に下記を追加

export PATH=/usr/local/share/python:$PATH

Pythonのインストールを確認

which python && python -V
 > /usr/local/bin/python
 > Python 2.7.3

Sphinx と blockdiag をインストール

pip install Sphinx blockdiag sphinxcontrib-blockdiag

Sphinxでプロジェクトを作成

mkdir ~/sphinx-test && cd ~/sphinx-test
sphinx-quickstart

ウィザードが完了したら、

make html && open build/index.html

参考リンク