6
6

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 5 years have passed since last update.

PythonAdvent Calendar 2013

Day 19

MacOSXにSphinxをインストール

Last updated at Posted at 2013-12-19

Mac OS X 10.8.5 + Python 2.7.5の環境にて、Sphinxをインストールしました。
インターネットに接続していることが前提条件になります。

まず、ez_setup.pyのダウンロード&インストールを行います。
Mac OS Xのため、取得コマンドはwgetではなくcurlになります。

$ curl https://bitbucket.org/pypa/setuptools/raw/bootstrap/ez_setup.py -o ez_setup.py
$ python ez_setup.py

インストールに失敗する場合は、管理者権限で実行してみて下さい。

$ sudo python ez_setup.py

インストールされたeasy_installにてSphinxをインストールします。
今回は1.1.3が選択されました。(最新は1.2です。)

$ easy_install sphinx
Searching for sphinx
Best match: Sphinx 1.1.3
...

プロジェクト用ディレクトリー(ここでは「sphinx」)を作成して、カレントを移動します。

$ mkdir sphinx
$ cd sphinx/

sphinx-quickstartにてSphinxプロジェクトを生成します。
今回は「お試し」のため、sphinx-quickstart実行後の質問には、ほぼ初期値([Enter]キー押下)で回答しました。

$ sphinx-quickstart
$ ls
Makefile build/    make.bat source/

sourceディレクトリー内の「 index.rst」がreStructuredTextファイルです。

$ ls source/
_static/    _templates/ conf.py    index.rst

sourceディレクトリー内のファイルから、HTMLを作成します。

$ make html
$ ls build/html/
_sources/       genindex.html  objects.inv    searchindex.js
_static/        index.html     search.html

WWWブラウザー(ここではSafari)を起動して、作成されたHTMLを確認します。

$ open /Applications/Safari.app build/html/index.html
6
6
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
6
6

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?