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

Question

使用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在答案中所说的那样),但你应该如何组织你的第一个结构与源代码文件在存储库中,以便你有一个完整的自动化文档网站？

Answer 1

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