用sphinx写文档

1 Sphinx简介

Sphinx是一个开源的文档工具。最开始被设计用于创建新的Python文档，后来被广泛应用与Python项目，现在对C／C++的支持也已经相当不错。并且正在逐步增加对更多其他编程语言的支持。Sphinx有以下主要功能：

1，支持多种输出格式，HTML，LaTeX, ePub, Texinfo, manual pages, plain text

2，支持大量交叉引用，语法标记，函数、类，引用、术语等类似信息的自动链接；

3，支持文档层次结构，通过兄弟，父亲孩子节点间的自动链接实现轻松定义文档树形结构；

4，自动索引；

5，代码高亮处理

6，更多的扩展支持

Sphinx使用