Sphinxのインストール¶
概要¶
Sphinxは Python で書かれており、Python 3.6+をサポートしています。これは、Sphinxのインストール時にインストールされる Docutils と Jinja のような多くのサードパーティのライブラリの上に構築されています。
Linux¶
Debian/Ubuntu¶
apt-get: コマンドで python3-sphinx をインストールしてください。
$ apt-get install python3-sphinx
もしPythonがインストールされていなくても、このコマンドで一緒にインストールされます。
RHEL, CentOS¶
yum コマンドで python-sphinx をインストールしてください:
$ yum install python-sphinx
もしPythonがインストールされていなくても、このコマンドで一緒にインストールされます。
他のディストリビューション¶
ほとんどのLinuxディストリビューションは、OSのパッケージ管理リポジトリにSphinxが用意されています。一般的なパッケージ名は python3-sphinx, python-sphinx, sphinx のいずれかです。 sphinx という名前をもつ別の用途のパッケージが他に2つあることに注意してください: 音声認識ツールキット(CMU Sphinx), フルテキスト検索データベース(Sphinx search)。
macOS¶
Homebrew や MacPorts でSphinxをインストールできます。あるいは、Pythonの配布形態の1つである Anaconda でもインストールできます。
MacPorts¶
port: コマンドで python3x-sphinx をインストールしてください。
$ sudo port install py38-sphinx
実行パスを設定するために port select コマンドを使って下さい:
$ sudo port select --set python python38
$ sudo port select --set sphinx py38-sphinx
詳しくは、 package overview を参照してください。
Anaconda¶
$ conda install sphinx
Windows¶
課題
パッケージングを始めてもよろしいですか?
ほとんどのWindowsユーザはPythonをデフォルトでインストールしていないので、Python自体のインストールから始めます。Pythonがすでにインストールされているかどうかを調べるには、 (⊞Win-r およびタイプ cmd で) Command Prompt を開きます。コマンドプロンプトが開いたら、 python --version と入力してEnterを押します。Pythonがインストールされている場合は、Pythonのバージョンが画面に出力されます。Pythonがインストールされていない場合は、 Hitchhikers Guide to Python's Python on Windowsインストール・ガイドを参照してください。 Python 3 をインストールする必要があります。
Pythonがインストールされたら、 pip を使ってSphinxをインストールすることができます。詳細は以下の pip installation instructions を参照してください。
PyPIからインストール¶
Sphinxのパッケージは Python Package Index に公開されています。 PyPI からパッケージをインストールするには pip を使うことをお勧めします。このツールは最近のバージョンのPythonすべてに付属しています。
LinuxまたはMacOSの場合は、ターミナルを開いて次のコマンドを実行します。
$ pip install -U sphinx
Windowsでは、( ⊞Win-r および cmd タイプにより) Command Prompt を開いて同じコマンドを実行します。
C:\> pip install -U sphinx
インストール後、コマンド・プロンプトで sphinx-build --version と入力します。問題がなければ、インストールしたSphinxパッケージのバージョン番号が表示されます。
PyPI からのインストールでは、最新の開発リリースをインストールすることもできます。一般的にこれを行うのに(または)は必要ありませんが、最新の安定版リリースにバグの可能性がある場合には便利です。これを行うには、 --pre フラグを使用します。
$ pip install -U --pre sphinx
Docker¶
Sphinx用のDockerイメージは Docker Hub に公開されています。
前者はSphinxの標準的な使用法で、後者は主にLaTeXを使用したPDFビルドに使用されます。目的に応じて選択してください。
注釈
sphinxdoc/sphinx-latexpdf にはTeXLiveパッケージが含まれています。そのため、イメージは非常に大きくなります(2GB以上!)。
ヒント
dockerイメージを使用する場合は、 docker run コマンドを使用してsphinxコマンドを起動してください。たとえば、次のコマンドを使用してSphinxプロジェクトを作成できます:
$ docker run -it --rm -v /path/to/document:/docs sphinxdoc/sphinx sphinx-quickstart
次のコマンドを実行すると、HTMLドキュメントを作成できます:
$ docker run --rm -v /path/to/document:/docs sphinxdoc/sphinx make html
詳細については、docker imagesの README file をお読みください。
ソースからインストール¶
Git repository のクローンからSphinxを直接インストールすることができます。これは、単に git 経由で直接インストールするか、リポジトリをクローンしてローカルのクローンからインストールすることで行うことができます。
$ git clone https://github.com/sphinx-doc/sphinx
$ cd sphinx
$ pip install .
$ pip install git+https://github.com/sphinx-doc/sphinx
Gitリポジトリのスナップショットを tar.gz または zip フォーマットでダウンロードすることもできる。ダウンロードして解凍すると、上記のように pip を使用してインストールできます。