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 separate
"source" 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; "_templates"
for custom HTML templates and "_static" for custom stylesheets and other static
files. 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 ".txt"
or ".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!
查看demo：http://doc.litejs.com/
sphinx简单配置
source目录下的conf.py文件为sphinx的配置文件。
1）修改文档语言为中文：
找到#language = None，修改为：language ='zh_CN'，其它语言见下表
复制代码 代码如下:
bn � Bengali
ca � Catalan
cs � Czech
da � Danish
de � German
en � English
es � Spanish
fi � Finnish
fr � French
hr � Croatian
it � Italian
ja � Japanese
lt � Lithuanian
nl � Dutch
pl � Polish
pt_BR � Brazilian Portuguese
ru � Russian
sl � Slovenian
tr � Turkish
uk_UA � Ukrainian
zh_CN � Simplified Chinese
zh_TW � Traditional Chinese
2）设置主题
找到html_theme = 'default'，修改default即可。目前官方提供的主题见http://sphinx.pocoo.org/theming.html#builtin-themes
3）其它
还其它更多设置，具体请参考官方文档。
设置好以后，重新make html即可。
扩展阅读：
您可能感兴趣的文章:
- Sphinx/MySQL 协议支持与SphinxQL应用实例
- python将html转成PDF的实现代码(包含中文)
- 深入解析php之sphinx
- Python生成pdf文件的方法
- Python实现批量把SVG格式转成png、pdf格式的代码分享
- php启用sphinx全文搜索的实现方法
- python使用reportlab实现图片转换成pdf的方法
- 使用rst2pdf实现将sphinx生成PDF
本文由 华域联盟 原创撰写：华域联盟 » sphinx使用及其简单配置方法
转载请保留出处和原文链接：https://www.cnhackhy.com/44355.htm
