1、sphinx使用及其簡單配置一、sphinx用法進入你要創(chuàng)建文檔的名目，例如要創(chuàng)建在名目/home/wwwroot/doc下cd /home/wwwroot/doc開頭用法向?qū)?chuàng)建你的文檔項目sphinx-quickstart程序會提醒輸入一些選項，如輸入根名目,大部分用法默認選項，挺直按回車即可。enter the root path for documentation.> root path for the documentation .:/輸入跟名目，挺直回車you have two options for placing the build directory for sphin

2、x 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, tw

3、o 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 d

4、ir _:/挺直回車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 suf

5、fix 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 ='z

6、h_cn'，其它語言見下表bn – bengalica – catalancs – czechda – danishde – germanen – englishes – spanishfi – finnishfr – frenchhr – croatianit – italianja – japaneselt – lithuan

7、iannl – dutchpl – polishpt_br – brazilian portugueseru – russiansl – sloveniantr – turkishuk_ua – ukrainianzh_cn – simplified chinesezh_tw – traditional chinese設置主題找到html_theme = 'default'，修改default即可。目前官方提供的主題見/theming.htmlbuiltin-themes其它還其它更多設置，詳細請參考官方文檔。設置好以后，重新make html即可。擴展閱