Mac OS X 10.8.5 + Python 2.7.5の環境にて、Sphinxをインストールしました。
インターネットに接続していることが前提条件になります。
まず、ez_setup.pyのダウンロード&インストールを行います。
Mac OS Xのため、取得コマンドはwgetではなくcurlになります。
$ curl https://bitbucket.org/pypa/setuptools/raw/bootstrap/ez_setup.py -o ez_setup.py
$ python ez_setup.py
インストールに失敗する場合は、管理者権限で実行してみて下さい。
$ sudo python ez_setup.py
インストールされたeasy_installにてSphinxをインストールします。
今回は1.1.3が選択されました。(最新は1.2です。)
$ easy_install sphinx
Searching for sphinx
Best match: Sphinx 1.1.3
...
プロジェクト用ディレクトリー(ここでは「sphinx」)を作成して、カレントを移動します。
$ mkdir sphinx
$ cd sphinx/
sphinx-quickstartにてSphinxプロジェクトを生成します。
今回は「お試し」のため、sphinx-quickstart実行後の質問には、ほぼ初期値([Enter]キー押下)で回答しました。
$ sphinx-quickstart
$ ls
Makefile build/ make.bat source/
sourceディレクトリー内の「 index.rst」がreStructuredTextファイルです。
$ ls source/
_static/ _templates/ conf.py index.rst
sourceディレクトリー内のファイルから、HTMLを作成します。
$ make html
$ ls build/html/
_sources/ genindex.html objects.inv searchindex.js
_static/ index.html search.html
WWWブラウザー(ここではSafari)を起動して、作成されたHTMLを確認します。
$ open /Applications/Safari.app build/html/index.html