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

Question

Created using Sphinx 0.6.5.

我知道Python的文档使用reStructuredText，但是它有不同的部分，比如http://docs.python.org/whatsnew/2.6.html和{}。在

如何在RestructedText中执行此操作？您是否在一堆目录中运行rst2html，并保持其结构？在

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

Answer 1

这是how to build Python documentation正是。在

Answer 2

我发现sampledoc tutorial on the matplotlib site对于开始使用狮身人面像非常有用。在

Answer 3

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