Epydoc – Documentazione Autogenerata per Python

Epydoc è un tool per python che genera automaticamente una pagina web contenente la documentazione dettagliata dei file sorgente del nostro progetto. Epydoc sfrutta la “docstring” di python estendendola con dei tag e degli elementi di markup che rendono la documentazione elegante e professionale. Andiamo ora a scoprire come installarlo e come commentare il codice per avere i risultati che ci aspettiamo. Continue reading

Sphinx 0.4

Mi apprestavo a scrivere la documentazione per PyBackup (che attualmente è in fase di manutenzione, rifinizione, etc etc) ed ho trovato molto comodo il tool Sphinx (utilizzato addirittura per la documentazione ufficiale del progetto Python). Sphinx però non è presente … Continue reading