Macにsphinxをインストール

sphinx

Sphinxは、先週参加した鍋駆動勉強会で興味をもったのでいつか勉強しようと思ってましたが、twitterで神戸で勉強会があるのを知って参加登録したので、それまでにインストールすることにしました。
Sphinx朝会@神戸 : ATND
環境はMac OS X 10.7(LION)で、pythonがインストール済かどうかターミナルでバーション表示で確認したら2.7がインストール済だった。

python --version

なので、Mac OS X, Linuxへのインストール — Python製ドキュメンテーションビルダー、Sphinxの日本ユーザ会の「自分でインストールをする」参考にインストール開始。
ez_setup.pyをdownloadして

python ez_setup.py

は成功。次に

easy_install sphinx

でpermission deniedのエラーが発生。http://packages.python.org/distribute/easy_install.htmlを参考に「/.pydistutils.cfg」を以下の内容で作成し、再度easy_install sphinxを実行。

[install]
install_lib = ~/Library/Python/$py_version_short/site-packages
install_scripts = ~/bin   <-----☆1

でinstallは成功。次にインストールの確認で

sphinx-quickstart

で「command not found」エラー発生。
「/.pydistutils.cfg」の３行目☆1の行で指定した場所がPATH指定してなかったので、「.bash_profile」にPATH追加。で再度「sphinx-quickstart」コマンドで、また別のエラー発生。同じようなエラーが以下のページで報告されていたので、自分でインストールする方法は諦める。
FS#27928 : [python-sphinx] sphinx-build doesn't work

で次は再度、パッケージシステムを使用したインストールに挑戦。
Mac OS X, Linuxへのインストール — Python製ドキュメンテーションビルダー、Sphinxの日本ユーザ会

sudo port install py26-sphinx

は成功、次に

sudo port install python_select
sudo python_select python26

でエラー発生。同じエラーが発生したtmmkr'sさんのblog
tomesoftさんのblogを参考にpythonのバージョン設定、シンボリックリンクを指定。

sphinx-quickstart

でWelcome to the Sphinx...の表示、やっとインストール成功。

  • 結局以下の手順するのが最短だった。(Mac Ports2.0.3使用)
1: sudo port install py26-sphinx
2: sudo port select --list python
3: sudo port select --set python python26
4: sudo ln -s /opt/local/bin/sphinx-autogen-2.6 /opt/local/bin/sphinx-autogen
5: sudo ln -s /opt/local/bin/sphinx-build-2.6 /opt/local/bin/sphinx-build
6: sudo ln -s /opt/local/bin/sphinx-quickstart-2.6 /opt/local/bin/sphinx-quickstart
7: which sphinx-quickstart
8: sphinx-quickstart

1行目でsphinxをインストール
2行目でpythonのactiveなバージョンを確認
3行目でpython2.6をactiveなバージョンに指定
4〜6行目でシンボリックリンクを作成
7行目でインストール確認
8行目で以下のリンクを参考にプロジェクトを作成。
プロジェクトを作る — Python製ドキュメンテーションビルダー、Sphinxの日本ユーザ会