======================================================================= Sphinx導入方法(Windowsユーザ向け) ======================================================================= Pythonのインストール ======================================================================= * SphinxはPythonの拡張モジュールなので、まずPythonのインストールが必要です。 下記ページよりインストーラーをダウンロードします。 * Windows用インストーラ python-2.7.3.msi http://www.python.jp/Zope/download/pythoncore .. note:: Windowsの64bit(x64)版の場合も、上記のバージョンをダウンロードして下さい。 パッケージ管理ツール **easy_install** のインストール ======================================================================= A. Pythonの拡張モジュール **easy_install** をインストールします。 1. 下記をダウンロードします。 http://python-distribute.org/distribute_setup.py 2. **distribute_setup.py** をPythonをインストールしたディレクトリに配置します。 標準では下記ディレクトリに配置して下さい。 :: C:\Python27\ 3. コマンドプロンプトを起動し、 **distribute_setup.py** を配置したディレクトリへ移動します。 :: > cd \Python27 4. Pythonで **distribute_setup.py** を実行します。 :: > python.exe distribute_setup.py 5. 大量のメッセージが流れるが、最後に下記のようなメッセージが出ていれば成功。 :: Creating C:\Python27\Lib\site-packages\setuptools-0.6c11-py2.7.egg-info Creating C:\Python27\Lib\site-packages\setuptools.pth 環境変数PATHの設定 ======================================================================= 1. コントロールパネルより **システムとセキュリティ** を選択します。 2. **システム** を選択します。 3. **システムの詳細設定** を選択します。 4. システムのプロパティが開くので、 **詳細設定** タブを選択します。 5. 右下の **環境変数** を選択します。 6. 環境変数PATHにディレクトリを追加します。 A. Admin権限 **有り** * ユーザー環境変数(上側)の **新規** を選択します。 * **新しいユーザー変数** に下記のように入力します。 :変数名: Path :変数値: C:\Python27;C:\Python27\Scripts B. Admin権限 **無し** * システム環境変数(下側)の変数 **Path** を選択します。 * **編集** を選択し下記のようにディレクトリ名を追加します。 :変数値: C:\Python27;C:\Python27\Scripts 7. 入力し終わったら全てのウィンドウを **OK** を押下して閉じて下さい。 8. Windowsをリブートします。 9. コマンドプロンプトよりバージョンを確認します。 :: > python -V Python 2.7.3 ※このように出力されればOK .. note:: バージョン確認に失敗した場合は、コマンドプロンプトに **path** と打ち込みPython27のパスが入っているか確認して下さい。 パッケージ管理ツール **pip** のインストール ======================================================================= * Pythonの拡張モジュール **pip** をインストールします。 * コマンドプロンプトを開き下記コマンドを実行します :: easy_install -U pip Sphinxのインストール ======================================================================= 1. コマンドプロンプトを起動しインストールコマンドを実行します。 :: pip install sphinxjp.themes.bizstyle -U 2. 大量のメッセージが出力されるが下記メッセージが最後にでれば問題ありません。 :: Finished processing dependencies for sphinx .. note:: 上記はSphinxの拡張テーマ bizstyle と、Sphinxを含む関連しているPython拡張モジュールを一度にインストールする手順です。 .. note:: 参考 Windowsへのインストール(スタンドアロンインストール) http://sphinx-users.jp/gettingstarted/install_windows_standalone.html