[Discussioni] Domandona

Nicola Larosa nico a tekNico.net
Mer 21 Feb 2007 15:12:14 CET


Paolo Cavallini wrote:
> - la difficolta' vera e' trovare un modo sufficientemente liscio e con
> bassa barriera di ingresso per consentire uno sforzo collaborativo e
> mantenere l'allineamento con le nuove versioni upstream, senza il quale
> si rischia di fare lavoro presto inutile o quasi.
> svn+latex va bene per allineare e coordinare, ma e' infattibile per i
> newbies (spesso i migliori per scrivere doc), il wiki e' praticamente
> impossibile da allineare.
> Io non ho trovato una soluzione brillante; idee?

Uso da anni docutils: http://docutils.sourceforge.net/ . Il markup
RestructuredText  semplice da imparare, nelle sue basi, e molto versatile,
disponendo degli elementi strutturali necessari a manuali e testi (sommari
e indici gestiti automaticamente, sezioni, riquadri, note a pi di pagina,
inclusione immagini e quant'altro).

Essendo testo liscio pi alcune convenzioni,  "diffabile" e gestibile con
controllo versione. L'output principale  verso HTML, sono in sviluppo (ma
gi usabili) le conversioni verso LaTeX e PDF.

E` uno strumento consolidato e maturo, scritto in Python e molto usato per
quel linguaggio: ovviamente  adatto a qualsiasi tipo di testo.


-- 
Nicola Larosa - http://www.tekNico.net/

Very little is actually impossible.
 -- Samuel Reynolds, August 2006




More information about the discussioni mailing list