Sphinx是由GeorgBrandl编写的工具，可轻松为Python项目（或由多个reStructuredText源组成的其他文档）创建智能且美观的文档。它最初是为新的Python文档创建的，具有用于Python项目文档的出色功能，但同时也支持C/C++，并且计划了更多的语言。
Sphinx使用reStructuredText作为标记语言，它的许多优势来自reStructuredText及其解析和翻译套件Docutils的强大功能和直接性。
其功能包括：
输出格式：HTML（包括派生格式，例如HTML帮助，Epub和Qt帮助），纯文本，手册页和LaTeX或使用rst2pdf的直接PDF输出广泛的交叉引用：功能，类，词汇术语和类似信息的语义标记和自动链接层次结构：轻松定义文档树，并自动链接到兄弟姐妹，父母和孩子自动索引：常规索引以及模块索引代码处理：使用Pygments荧光笔自动突出显示使用Jinja2模板引擎灵活的HTML输出提供各种扩展名，例如，用于自动测试代码片段和包含适当格式的文档字符串Setuptools集成
评论