Python'un web sitesi çevrimiçi belgelerini nasıl oluşturur?

Question

Sphinx 0.6.5 kullanılarak oluşturuldu.

Python'ın belgelerine reStructuredText kullanır biliyorum ama http://docs.python.org/whatsnew/2.6.html ve http://docs.python.org/tutorial/index.html gibi farklı bölümden oluşmaktadır.

Bunu nasıl yapıyorsunuz reStructuredText? Yapısını koruyarak bir grup dizine rst2html mu koşuyorsunuz?

Bunun Sphinx'i (Thomas Wouters in an answer ile belirtildiği gibi doğrudan rst2html'yi değil) kullandığını biliyorum, ancak rst yapınızı bir depoda kaynak kod dosyaları ile nasıl düzenlemelisiniz, böylece tam bir otomatik doc web sitesine sahip olursunuz?

Answer 1

Python belgeleri onun biçimlendirme dinlenmeye kullanır, ancak doğrudan sphinx değil rst2html kullanarak HTML üretir. sphinx aracı, tek tek .rst dosyalarını birden çok .html dosyaya dönüştüren şeydir. Python belgelerinin nasıl oluşturulduğunu görmek için, bkz.

Answer 2

Sphinx'i kullanmaya başlamak için sampledoc tutorial on the matplotlib site'u oldukça yararlı buldum.

Answer 3

Tam olarak how to build Python documentation tam olarak.