用sphinx将reStructuredText开源书籍转化成其他格式
今天在github看到了一个项目,是用reStructuredTex标记语言写的开源书籍,然后下载下来阅读,
结果发现下载下来的目录里面有很多各种格式的文件,并不能直接阅读,需要用sphinx编译成我们
可以阅读的格式,才可以看。比如html,pdf等格式。
以下是用sphinx编译开源书籍项目:https://github.com/me115/linuxtools_rst产生html格式的全过程。
一.sphinx工具简介:
sphinx工具是一个由Grorg Brandl写的产生文档的工具,可以将reStructuredTex格式转化成
多种格式,如HTML,LaTex,ePub,Texinfo,manual pages,plain text等。
二.使用sphinx编译开源书籍项目产生html格式的文档:
1.先到
https://github.com/me115/linuxtools_rst下载开源书籍项目,然后解压到某个目录.
2.安装Python:
到