仓酷云

 找回密码
 立即注册
搜索
热搜: 活动 交友 discuz
查看: 744|回复: 9
打印 上一主题 下一主题

[其他Linux] 来一发sphinx利用及其复杂设置办法

[复制链接]
莫相离 该用户已被删除
跳转到指定楼层
楼主
发表于 2015-1-16 16:40:21 | 只看该作者 回帖奖励 |倒序浏览 |阅读模式

马上注册,结交更多好友,享用更多功能,让你轻松玩转社区。

您需要 登录 才可以下载或查看,没有帐号?立即注册

x
如果你只是想应付一下操作系统的课程,劝你最好别学,或者说不要指望能用的怎么样。
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)[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等);
愤怒的大鸟 该用户已被删除
沙发
发表于 2015-1-16 18:51:36 | 只看该作者

来一发sphinx利用及其复杂设置办法

为了更好的学习这门课程,我不仅课上认真听讲,课下也努力学习,为此还在自己的电脑上安装了Ubuntu系统。
山那边是海 该用户已被删除
板凳
发表于 2015-1-18 19:58:03 | 只看该作者
任何一个叫做操作系统的东西都是这样子构成的:内核+用户界面+一般应用程序。
再见西城 该用户已被删除
地板
发表于 2015-1-27 19:16:48 | 只看该作者
Windows?是图形界面的,Linux类似以前的?DOS,是文本界面的,如果你运行了图形界面程序X-WINDOWS后,Linux?也能显示图形界面,也有开始菜单、桌面、图标等。
兰色精灵 该用户已被删除
5#
发表于 2015-2-5 14:55:29 | 只看该作者
Linux简单,占内存少,特别是对于程序开发人员来说很方便,如果说windows的成功在于其方便用户的窗口管理界面。
谁可相欹 该用户已被删除
6#
发表于 2015-2-12 10:18:32 | 只看该作者
我想即使Linux高手也很难快速准确精练的回答你。
柔情似水 该用户已被删除
7#
发表于 2015-3-3 02:59:06 | 只看该作者
一定要学好命令,shell是命令语言,命令解释程序及程序设计语言的统称,shell也负责用户和操作系统之间的沟通。
因胸联盟 该用户已被删除
8#
发表于 2015-3-11 09:27:03 | 只看该作者
期间我阅读了不少关于Linux的相关资料,其中也不乏一些有趣的小故事,这既丰富了我的课余生活,也让我加深了对一些术语的理解,比玩游戏强多了。?
飘飘悠悠 该用户已被删除
9#
发表于 2015-3-18 06:15:15 | 只看该作者
我感觉linux的学习,学习编程~!~!就去学习C语言编程!!
老尸 该用户已被删除
10#
发表于 2015-3-25 14:23:43 | 只看该作者
众所周知,目前windows操作系统是主流,在以后相当长的时间内不会有太大的改变,其方便友好的图形界面吸引了众多的用户。
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

QQ|Archiver|手机版|仓酷云 鄂ICP备14007578号-2

GMT+8, 2024-5-29 09:15

Powered by Discuz! X3.2

© 2001-2013 Comsenz Inc.

快速回复 返回顶部 返回列表