[Docs] Documentazione ReST-based

Manlio Perillo manlio_perillo a libero.it
Mer 1 Ago 2007 13:28:38 CEST


Daniele Varrazzo ha scritto:
>> Daniele Varrazzo ha scritto:
>>> Ciao,
>>>
>>> dove si trovano info su questa fantomatica documentazione ReST-based di
>>> cui
>>> sto sentendo parlare in questi giorni?
>>>
>> http://pydoc.gbrandl.de:3000/
> 
> Queste non sono le info,  il risultato: non  quello che cercavo. Poi ho
> trovato http://pyside.blogspot.com/2007/06/introducing-py-rest-doc.html che
> per non mi embra contenere la discussione che ha girato intorno alla
> faccenda, che psobabilmente c' stata (pro? contro? favs? cons? questo 
> solo l'annuncio del sistema, penso che guido voglia/abbia voluto
> dimostrazioni solide della bont del sistema)
> 

C' la nuova mailing lists docs a python.org.

Per qualche strano motivo la lista non  pubblica:
- non compare in http://lists.python.it/
- Per visionare gli archivi occorre essere iscritti.


Io ho richiesto l'iscrizione, ma non mi  mai arrivata la email di conferma.


>> sphinx  ancora immaturo.
>> Alan Franzoni soggerisce di usarlo anche per gestire le traduzioni, ma
>> richiederebbe comunque uno sforzo non indifferente per ampliare il codice.
> 
> sphinx  il nome di questo sistema di configurazione? Pensavo fosse il
> successore del CMS che usano a python.org (anche il nome lo suggerisce).
> 

No, ho fatto io confusione nell'altra discussione, scusa.
http://svn.python.org/view/doctools/trunk/


Comunque il sistema l'ha ideato il mantenitore della documentazione, 
quindi magari Guido si  fidato (oppure hanno accettato perch era la 
soluzione non peggiore, rispetto al sistema attuale).


Mi sembra che manchi anche il supporto per PDF, spero che almeno 
l'impaginazione sia all'altezza del sistema attuale.



Saluti  Manlio Perillo


Maggiori informazioni sulla lista Docs