开始使用Sphinx写读书笔记

 本文作者:riag
本文出处:http://blog.csdn.net/riag
声明: 本文可以不经作者同意, 任意复制, 转载, 但任何对本文的引用都请保留文章开始前三行的作者, 出处以及声明信息. 谢谢.

 

   其实，以前我就想用reStructuredText来写读书笔记，但发现在reStructuredText上面贴代码很痛苦，所以就放弃了。后来就发现了Sphinx这个写文档的工具，它虽然是基于reStructuredText，但它有自己的一些扩展命令，如可以把代码放到一个独立的文件，然后指定文件高亮显示代码就可以了，很方便，用法如下:

 

   .. highlight:: c
   .. literalinclude:: code/snoob.c

 

highlight 是指以c语法来高亮

literalinclude 要显示的代码文件

 

Sphinx的主页: http://sphinx.pocoo.org/

 

感兴趣的同学 可以试试