S-JIS[2012-04-17] 変更履歴

Sphinxのインストール

Sphinxのインストール方法のメモ。

Windowsへのインストール

SphinxはPythonで動いているらしいので、最初にPythonをインストールする必要がある。
そして、Python上のインストーラーを使ってSphinxをインストールする。

Windows7にPython3.2を用いてSphinx1.1.3をインストールする例。

1. Python本体をインストールする。
   1. Pythonのページの左側のメニューの「Quick Links (3.2.3)」の下の「Windows Installer」をクリックして、インストーラー（python-3.2.3.msi）をダウンロードする。
   2. インストーラーを実行する。
      途中の選択肢は全部デフォルトでOK。
      これで、「C:\Python32」にPythonがインストールされる。
   3. 環境変数PATHにPythonの実行ファイルのあるディレクトリーとスクリプトディレクトリーを追加する。

      PATH

      〜;C:\Python32;C:\Python32\Scripts

      この時点ではまだScriptsディレクトリーは存在していないが、後から作られる。

   4. コマンドプロンプトから「python」と打ってみて、実行できればOK。（Ctrl+Zで終了）
2. easy_installをインストールする。（Python2系と異なり、distributeというのを使うらしい）
   1. PyPIのdistributeのページの一番下にあるリンクから、アーカイブファイル（distribute-0.6.26.tar.gz）をダウンロードする。
   2. アーカイブを適当な場所に解凍する。
      （自分はCygwinを入れてあるので、「tar xf distribute-0.6.26.tar.gz」で解凍できる）
   3. すると「distribute-0.6.26」というディレクトリーが出来るので、コマンドプロンプトでその場所へ移動し、インストール用のコマンドを実行する。

      > cd distribute-0.6.26
      > python setup.py install

   4. これで、C:\Python32\Scriptsの下に「easy_install.exe」等が出来る。
3. pipをインストールする。
   1. コマンドプロンプトから（カレントディレクトリーはどこでもよいので）以下のコマンドを実行する。

      > easy_install pip

   2. 「このプログラムは正しくインストールされなかった可能性があります」とかいう「プログラム互換性アシスタント」ダイアログが出るかもしれないが、「このプログラムは正しくインストールされました」を選択してよい。
   3. これで、C:\Python32\Scriptsの下に「pip.exe」等が出来る。
4. Sphinxをインストールする。
   1. コマンドプロンプトから（カレントディレクトリーはどこでもよいので）以下のコマンドを実行する。

      > pip install sphinx

   2. アーカイブファイルがダウンロードされるので、しばらく待つ。
   3. これで、C:\Python32\Scriptsの下に「sphinx-build.exe」や「sphinx-quickstart.exe」等が出来る。