Python için bir Dokümantasyon jeneratör arıyorum. javadoc, aşinayım ve Doxygen, ama oldukça yetersiz görünüyor ve karşı-sezgisel Python için çalıştım.

Herhangi bir fikir?

EDİT: Aşağıda mükemmel cevaplar dışında, ayrıca wikipedia Comparison of documentation generators ayrıntılı danışabilirsiniz.

API doc için klasik araç epydoc. , Docstrings, vb javadoc işler... Ama API docs araçlar oldukça kötü buluyorum. Ben çok belgelere etrafında odak kendisi hangi aracı tercih ve ek belgeler kod çıkarılan enjekte sağlar. Sphinx Bu iş için mükemmel. Olabilir oluşturur html ve pdf, içerebilir otomatik olarak çıkarılan kütüphane kod, sözdizimi vurgulama, vb... Bir güçlü noktası Sfenks olup bitmiş olan bir kişi tarafından bilmediği bir şey hakkında web tasarım ve görünmüyor gibi bir**. matplotlib Web sitesi ve doktor Sfenks tamamen varsayılan değerler ile oluşturulur. Epydoc/doxygen ile sen-ecek almak çok daha güzel bir şey daha görünüyor. Ve javascript entegre bir arama motoru vardır