来一发sphinx利用及其复杂设置办法
如果你只是想应付一下操作系统的课程，劝你最好别学，或者说不要指望能用的怎么样。sphinx利用
进进你要创立文档的目次，比方要创立在目次/home/wwwroot/doc下
cd/home/wwwroot/doc
入手下手利用导游创立你的文档项目
sphinx-quickstart
程序会提醒输出一些选项，如输出根目次,年夜部分利用默许选项，间接按回车便可。
.代码以下:
Entertherootpathfordocumentation.
>Rootpathforthedocumentation[.]:
//输出跟目次，间接回车
YouhavetwooptionsforplacingthebuilddirectoryforSphinxoutput.
Either,youuseadirectory"_build"withintherootpath,oryouseparate
"source"and"build"directorieswithintherootpath.
>Separatesourceandbuilddirectories(y/N):
//是不是分别source和build目次，倡议选y,便利办理
Insidetherootdirectory,twomoredirectorieswillbecreated;"_templates"
forcustomHTMLtemplatesand"_static"forcustomstylesheetsandotherstatic
files.Youcanenteranotherprefix(suchas".")toreplacetheunderscore.
>Nameprefixfortemplatesandstaticdir:
//间接回车
Theprojectnamewilloccurinseveralplacesinthebuiltdocumentation.
>Projectname:F2ECookbook
>Authorname(s):imbingdian
//输出项目称号
//输出作者称号
Thefilenamesuffixforsourcefiles.Commonly,thisiseither".txt"
or".rst".Onlyfileswiththissuffixareconsidereddocuments.
>Sourcefilesuffix[.rst]:.txt
//档文件的扩大名，默许是.rst
//前面的操纵基础回车就好
完成后能够看到doc文件中生了以下目次文件
build--天生文档目次
source--源文件目次
make.bat
makefile
天生html文档
makehtml
看一下build目次下是否是天生了html文档了?
^_^enjoyit!
检察demo：http://doc.litejs.com/
sphinx复杂设置
source目次下的conf.py文件为sphinx的设置文件。
1）修正文档言语为中文：
找到#language=None，修正为：language=zh_CN，别的言语见下表
.代码以下:
bnCBengali
caCCatalan
csCCzech
daCDanish
deCGerman
enCEnglish
esCSpanish
fiCFinnish
frCFrench
hrCCroatian
itCItalian
jaCJapanese
ltCLithuanian
nlCDutch
plCPolish
pt_BRCBrazilianPortuguese
ruCRussian
slCSlovenian
trCTurkish
uk_UACUkrainian
zh_CNCSimplifiedChinese
zh_TWCTraditionalChinese
2）设置主题
找到html_theme=default，修正default便可。今朝官方供应的主题见http://sphinx.pocoo.org/theming.html#builtin-themes
3）别的
还别的更多设置，详细请参考官方文档。
设置好今后，从头makehtml便可。
扩大浏览：
[*]http://sphinx.pocoo.org/contents.html
http://blog.s135.com/read.php?360
常用的linux命令，尤其是一些能帮你提高开发效率的命令，(eg：grep，awk，sed，split等)；
来一发sphinx利用及其复杂设置办法
为了更好的学习这门课程，我不仅课上认真听讲，课下也努力学习，为此还在自己的电脑上安装了Ubuntu系统。 任何一个叫做操作系统的东西都是这样子构成的：内核+用户界面+一般应用程序。 Windows?是图形界面的，Linux类似以前的?DOS，是文本界面的，如果你运行了图形界面程序X-WINDOWS后，Linux?也能显示图形界面，也有开始菜单、桌面、图标等。 Linux简单，占内存少，特别是对于程序开发人员来说很方便，如果说windows的成功在于其方便用户的窗口管理界面。 我想即使Linux高手也很难快速准确精练的回答你。 一定要学好命令，shell是命令语言，命令解释程序及程序设计语言的统称，shell也负责用户和操作系统之间的沟通。 期间我阅读了不少关于Linux的相关资料，其中也不乏一些有趣的小故事，这既丰富了我的课余生活，也让我加深了对一些术语的理解，比玩游戏强多了。? 我感觉linux的学习,学习编程~!~!就去学习C语言编程!! 众所周知，目前windows操作系统是主流，在以后相当长的时间内不会有太大的改变，其方便友好的图形界面吸引了众多的用户。
页:
[1]