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