python - Python 的网站如何生成其在线文档？

Question

Created using Sphinx 0.6.5.

我知道 Python 的文档使用 reStructuredText，但它有不同的部分，例如 http://docs.python.org/whatsnew/2.6.html 和 http ://docs.python.org/tutorial/index.html。

你如何在 reStructuredText 中做到这一点？您是否在一堆目录中运行 rst2html 并保持其结构？

我知道它使用 Sphinx(不是直接使用 rst2html，如 Thomas Wouters in an answer 所说)，但是您应该如何使用存储库中的源代码文件来组织您的第一个结构，以便您拥有一个完整的自动化文档网站？

Answer 1

Python 文档使用 reST 作为其标记，但它使用 sphinx 而不是直接使用 rst2html 生成 HTML。 sphinx 工具可以将所有单独的 .rst 文件转换为多个 .html 文件。要查看 Python 文档是如何生成的，请参阅 http://svn.python.org/projects/python/trunk/Doc/Makefile