[Discussioni] Domandona

[Nicola Larosa]

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