html5中文学习网

您的位置: 首页 > 网站及特效实例 > html5实验 » 正文

sphinx使用及其简单配置

[ ] 已经帮助:人解决问题

一、sphinx使用

进入你要创建文档的目录,例如要创建在目录/home/wwwroot/doc下sWJHTML5中文学习网 - HTML5先行者学习网

cd /home/wwwroot/doc

开始使用向导创建你的文档项目sWJHTML5中文学习网 - HTML5先行者学习网

sphinx-quickstart

程序会提示输入一些选项,如输入根目录,大部分使用默认选项,直接按回车即可。sWJHTML5中文学习网 - HTML5先行者学习网

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 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 ".txt"or ".rst".  Only files with this suffix are considered documents.> Source file suffix [.rst]: .txt//档文件的扩展名,默认是.rst//后面的操作基本回车就好

完成后可以看到doc文件中生了以下目录文件sWJHTML5中文学习网 - HTML5先行者学习网

build--生成文档目录source--源文件目录make.bat makefile

生成html文档sWJHTML5中文学习网 - HTML5先行者学习网

make html

看一下build目录下是不是生成了html文档了?sWJHTML5中文学习网 - HTML5先行者学习网

^_^ enjoy it!sWJHTML5中文学习网 - HTML5先行者学习网

二、sphinx简单配置

source目录下的conf.py文件为sphinx的配置文件。sWJHTML5中文学习网 - HTML5先行者学习网

1)修改文档语言为中文:

找到#language = None,修改为:language ='zh_CN',其它语言见下表sWJHTML5中文学习网 - HTML5先行者学习网

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-themessWJHTML5中文学习网 - HTML5先行者学习网

其它

还其它更多设置,具体请参考官方文档sWJHTML5中文学习网 - HTML5先行者学习网

设置好以后,重新make html即可。sWJHTML5中文学习网 - HTML5先行者学习网

扩展阅读:

(责任编辑:)
推荐书籍
推荐资讯
关于HTML5先行者 - 联系我们 - 广告服务 - 友情链接 - 网站地图 - 版权声明 - 人才招聘 - 帮助