一、sphinx使用 进入你要创建文档的目录，例如要创建在目录/home/wwwroot/doc下 cd /home/wwwroot/doc 开始使用向导创建你的文档项目 sphinx-quickstart 程序会提示输入一些选项，如输入根目录,大部分使用默认选项，直接按回车即可。 enter the root path fo
一、sphinx使用进入你要创建文档的目录，例如要创建在目录/home/wwwroot/doc下
cd /home/wwwroot/doc
开始使用向导创建你的文档项目
sphinx-quickstart
程序会提示输入一些选项，如输入根目录,大部分使用默认选项，直接按回车即可。
enter the root path for documentation.> root path for the documentation [.]://输入跟目录，直接回车you have two options for placing the build directory for sphinx output.either, you use a directory _build within the root path, or you separatesource and build directories within the root path.> separate source and build directories (y/n) [n]://是否分离source和build目录，建议选y,方便管理inside the root directory, two more directories will be created; _templatesfor custom html templates and _static for custom stylesheets and other staticfiles. you can enter another prefix (such as .) to replace the underscore.> name prefix for templates and static dir [_]://直接回车the project name will occur in several places in the built documentation.> project name: f2e cookbook> author name(s): imbingdian//输入项目名称//输入作者名称the file name suffix for source files. commonly, this is either .txtor .rst. only files with this suffix are considered documents.> source file suffix [.rst]: .txt//档文件的扩展名，默认是.rst//后面的操作基本回车就好
完成后可以看到doc文件中生了以下目录文件
build--生成文档目录source--源文件目录make.bat makefile
生成html文档
make html
看一下build目录下是不是生成了html文档了?
^_^ enjoy it!
二、sphinx简单配置source目录下的conf.py文件为sphinx的配置文件。
1）修改文档语言为中文：找到#language = none，修改为：language ='zh_cn'，其它语言见下表
bn – bengalica – catalancs – czechda – danishde – germanen – englishes – spanishfi – finnishfr – frenchhr – croatianit – italianja – japaneselt – lithuaniannl – dutchpl – polishpt_br – brazilian portugueseru – russiansl – sloveniantr – turkishuk_ua – ukrainianzh_cn – simplified chinesezh_tw – traditional chinese
设置主题找到html_theme = 'default'，修改default即可。目前官方提供的主题见sphinx.pocoo.org/theming.html#builtin-themes
其它还其它更多设置，具体请参考官方文档。
设置好以后，重新make html即可。
扩展阅读：http://sphinx.pocoo.org/contents.html target=“_blank”>http://sphinx.pocoo.org/contents.html 原文地址：sphinx使用及其简单配置, 感谢原作者分享。