安装 Sphinx
$ easy_install sphinx
Searching for sphinx
Reading http://pypi.python.org/simple/sphinx/
Reading http://sphinx.pocoo.org/
Best match: Sphinx 1.0.
Downloading http://pypi.python.org/packages/[...]
Processing Sphinx-1.0.-py2..egg
[...]
Finished processing dependencies for sphinx
脚本 sphinx-build 用来建立Sphinx文档集. 调用方式:
$ sphinx-build [options] sourcedir builddir [filenames]
调用示例：
$ sphinx-build -b html /home/ccx/user_docs/source/ /var/www/html/user_docs
sourcedir 是源文件目录 source directory , builddir 是生成文件目录.一般不需要写 filenames .
脚本 sphinx-build 的选项:
-b 生成器名字
生成器,决定了生成文档的类型,是最重要的选项. 通用的生成器有:
html
生成HTML文档. 默认的生成器.