Sphinx¶

轻松创建智能美观的文档

📝 富文本格式

使用 reStructuredText 或 MyST Markdown 创作，创建高度结构化的技术文档，包括表格、高亮代码块、数学符号等。

🔗 强大的交叉引用

在项目内部，甚至在不同项目之间创建交叉引用。包括对章节、图、表、引文、词汇表、代码对象等的引用。

📚 多功能文档格式

以受众偏爱的格式生成文档，包括 HTML、LaTeX（用于 PDF）、ePub、Texinfo，以及更多。

🎨 丰富的页面主题支持

创建具有视觉吸引力的文档，提供多种内置和第三方 HTML 主题选择，并能够自定义或创建新主题。

🔌 完全可扩展

通过强大的扩展机制添加自定义功能，提供众多内置和第三方扩展，用于创建图表、测试代码等任务。

🛠️ 自动 API 文档

为 Python、C++ 和其他软件领域生成 API 文档，可以手动或从 docstring 自动生成，确保您的代码文档以最少的精力保持最新。

🌍 国际化 (i18n)

添加多种语言的文档翻译，以覆盖全球受众。

🌟 活跃的社区和支持

受益于活跃的社区，拥有众多资源、教程、论坛和示例。

使用方

Python¶

Linux 内核¶

Project Jupyter¶

请参阅下文，了解如何浏览 Sphinx 的文档。

另请参阅

Sphinx 文档目录包含本网站页面的完整列表。

入门¶

这些部分涵盖了 Sphinx 入门的基础知识，包括从头开始创建和构建您自己的文档。

这些部分涵盖了在使用和扩展 Sphinx 以适应各种用例的各种主题。它们是使用 Sphinx 在许多情况下的综合指南，并假设您对 Sphinx 有更多了解。如果您是 Sphinx 新手，我们建议从入门开始。

Sphinx 由社区支持，并欢迎任何人的贡献。以下部分应帮助您开始加入 Sphinx 社区并做出贡献。

如果您想为项目做出贡献，请参阅Sphinx 贡献者指南。

社区

参考文档在本质上更完整和程序化，它是一个可以快速引用的信息集合。如果您想要用例驱动的文档，请参阅入门或用户指南。

参考