accidenti, grazie mille .... mi ci butto subito :D<br><br><div class="gmail_quote">Il giorno 14 ottobre 2009 12.49, Alessandro Dentella <span dir="ltr"><<a href="mailto:sandro@e-den.it">sandro@e-den.it</a>></span> ha scritto:<br>
<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"><div class="im">On Wed, Oct 14, 2009 at 12:38:22PM +0200, Antonello Mangone wrote:<br>
> Ciao a tutti, posto una richiesta che spero non sia considerata troppo<br>
> particolare.<br>
</div>> Non so se fattibile, ma vorrei documentare Python in modo da produrre dei<br>
<div class="im">> documenti HTML in stile API di Java, PHP ecc ... o altrimenti in altri formati,<br>
</div>> ma comunque qualcosa di statico che pu essere ovviamente aggiornato in maniera<br>
<div class="im">> rapida, partendo dai commenti che vengono inseriti all'interno delle classi<br>
> Python e delle funzioni o metodi.<br>
> I commenti di cui parlo sono quelli che iniziano e finiscono con """ e """, che<br>
> vengono utilizzati da IDE evoluti per fornire documentazione di classi e<br>
> funzioni durante il loro uso.<br>
> Un grosso grazie a chiunque riesca a fornirmi una dritta ... anche solo<br>
> documentazione<br>
<br>
<br>
</div>Ti suggerisco di guardare sphinx, il sistema concui viene prodotta la<br>
documentazione di python stesso su www.python.oro, di django e di tanti<br>
altri (fra cui [1] :-).<br>
<br>
Oltre a permettere di scrivere la documentazione in formato rst aggiunge<br>
molte direttive molto comode oltre a cose come 'automodule' che legge la<br>
docstring del modulo, 'autoclass' che legge la docstring della classe e a<br>
piacimento produce la documentazione per i vari metodi:<br>
<br>
<a href="http://sphinx.pocoo.org/" target="_blank">http://sphinx.pocoo.org/</a><br>
<br>
sandro<br>
*:-)<br>
<font color="#888888"><br>
--<br>
Sandro Dentella *:-)<br>
[1] <a href="http://sqlkit.argolinux.org" target="_blank">http://sqlkit.argolinux.org</a> SQLkit home page - PyGTK/python/sqlalchemy<br>
_______________________________________________<br>
Python mailing list<br>
<a href="mailto:Python@lists.python.it">Python@lists.python.it</a><br>
<a href="http://lists.python.it/mailman/listinfo/python" target="_blank">http://lists.python.it/mailman/listinfo/python</a><br>
</font></blockquote></div><br>