¿Cómo genera el sitio web de Python su documentación en línea?

Question

Creado con Sphinx 0.6.5.

sé documentación de Python usa reStructuredText, pero tiene diferentes secciones como http://docs.python.org/whatsnew/2.6.html y http://docs.python.org/tutorial/index.html.

¿Cómo se hace esto en reStructuredText? Ejecuta rst2html en un grupo de directorios, manteniendo su estructura?

Sé que utiliza Sphinx (no rst2html directamente como dice Thomas Wouters in an answer), pero ¿cómo debe organizar su primera estructura con los archivos de código fuente en un repositorio para que tenga un sitio web completo de doc automatizado?

Answer 1

documentación La Python usa descanso para su marcado, pero genera el código HTML utilizando sphinx, no rst2html directamente. La herramienta sphinx es lo que convierte todos los archivos individuales .rst en varios archivos .html. Para ver cómo se generan los documentos de Python, consulte http://svn.python.org/projects/python/trunk/Doc/Makefile

Answer 2

Encontré el sampledoc tutorial on the matplotlib site bastante útil para comenzar a usar Sphinx.

Answer 3

Aquí está how to build Python documentation exactamente.