Python網站如何生成其在線文檔？

Question

使用獅身人面像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所述），但是您應該如何將第一個結構與源代碼文件組織在一個存儲庫中，以便您擁有一個完整的自動化doc網站？

Answer 1

Python文檔使用reST作爲其標記，但它直接使用sphinx而不是rst2html生成HTML。 sphinx工具是將所有個人.rst文件轉換爲多個.html文件的工具。要查看如何生成Python文檔，請參閱http://svn.python.org/projects/python/trunk/Doc/Makefile

Answer 2

我發現sampledoc tutorial on the matplotlib site對於開始使用Sphinx非常有用。

Answer 3

這裏是how to build Python documentation。