Ubuntuにドキュメンテーションツール、Sphinxインストールする

最初に入れるパッケージ

sudo apt-get install python-pip
sudo apt-get install python-setuptools
sudo apt-get install pandoc

Macでもできます

ただしHomebrewが必要です。 pipeasy_installがUbuntu同様必要ですが、最初っから入っている?わからないので入っていなかったら、これもググってbrewかなんかでインストールしてください。

Sphinxのインストール

sudo easy_install sphinx

sphinx_rtd_themeのインストール

pip install sphinx_rtd_theme

ディレクトリ作成

とくに意味はないがwarningがでるので,該当するディレクトリを作成する

cd source
mkdir _static
mkdir _templates

実行確認

以下のコマンドを入力して

Build finished. The HTML pages are in build/html.

とでれば成功

cd sphinx
make html

htmlのディレクトリのindex.htmlをブラウザでアクセス

cd build/html
#index.htmlをブラウザでアクセス
firefox index.html

画像のようにページができたら成功