Python的网站如何生成其在线文档？
使用 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 的回答），但是您应该如何使用存储库中的源代码文件组织第一个结构，以便拥有一个完整的自动化文档网站？
Created using Sphinx 0.6.5.
I know Python's documentation uses reStructuredText, but it has different sections like http://docs.python.org/whatsnew/2.6.html and http://docs.python.org/tutorial/index.html.
How do you do this in reStructuredText? Do you run rst2html in a bunch of directories, keeping its structure?
I know that it uses Sphinx (not rst2html directly as said by Thomas Wouters in an answer), but how you should organize your rst structure with source code files in a repository so you have a full blown automated doc website?
如果你对这篇内容有疑问，欢迎到本站社区发帖提问 参与讨论，获取更多帮助，或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱，如果其他用户或者作者回复了您的评论，将不能在第一时间通知您！
发布评论
评论（3）
Python 文档使用 reST 作为其标记，但它使用
sphinx生成 HTML，而不是直接使用rst2html。sphinx工具可将所有单独的.rst文件转换为多个.html文件。要了解如何生成 Python 文档，请参阅 http://svn.python.org /projects/python/trunk/Doc/MakefileThe Python documentation uses reST for its markup, but it generates the HTML using
sphinx, notrst2htmldirectly. Thesphinxtool is what converts all the individual.rstfiles into multiple.htmlfiles. To see how the Python docs are generated, see http://svn.python.org/projects/python/trunk/Doc/Makefile我发现matplotlib 网站上的sampledoc 教程对于开始使用Sphinx 非常有用。
I found the sampledoc tutorial on the matplotlib site quite useful to get started with Sphinx.
以下是如何构建 Python 文档。
Here is how to build Python documentation exactly.