In che modo il sito Web Python genera la sua documentazione online?

Question

Creato con Sfinge 0.6.5.

So che la documentazione di Python utilizza reStructuredText, ma ha diverse sezioni come http://docs.python.org/whatsnew/2.6.html e http://docs.python.org/tutorial/index.html.

Come si fa in reStructuredText? Esegui rst2html in un gruppo di directory, mantenendo la sua struttura?

So che utilizza Sphinx (non rst2html direttamente come detto da Thomas Wouters in an answer), ma come si dovrebbe organizzare la prima struttura con i file di codice sorgente in un repository in modo da avere un sito Web completo di documenti automatizzati?

Answer 1

La documentazione Python usa riposo per la sua markup, ma genera il codice HTML usando sphinx, non rst2html direttamente. Lo strumento sphinx è ciò che converte tutti i singoli file .rst in più file .html. Per vedere come vengono generati i documenti Python, vedere http://svn.python.org/projects/python/trunk/Doc/Makefile

Answer 2

Ho trovato il sampledoc tutorial on the matplotlib site abbastanza utile per iniziare con Sphinx.

Answer 3

Ecco esattamente how to build Python documentation.