renareto” post=76953
“questo”… quale? Le due guide di Debian e Ubuntu?
scusa, hai ragione, intendevo quello di Ubuntu.
Ma i link che mi hai dato, di cosa sono? del sorgente per creare l’ambiente?
Quali link in particolare? I primi due rimandavano ai Makefile delle due guide, gli ultimi tre ai siti di Publican, dblatex e DocBook, nel caso tu non conoscessi questi progetti (per esempio io non li conoscevo). DocBook ha voce su Wikipedia in inglese, sembra un linguaggio molto interessante perché senza cambiare il sorgente permette di ottenere un documento in molti formati differenti (Wikipedia elenca HTML, XHTML, EPUB, PDF, pagine di manuali Unix, Web help e CHM) senza modificare il sorgente. Da questo punto di vista LaTeX è in netto svantaggio, ma ciò è dovuto al fatto che LaTeX è nato per fare altro e lo fa molto bene. Il difetto di DocBook è che non si appoggia direttamente su LaTeX, però con dblatex è possibile tradurre un sorgente DocBook in LaTeX e poi apportare le volute modifiche. Se preferisci avere la tua guida in HTML e PDF credo che DocBook sia una buona soluzione, non per niente “Doc” sta per “Documentation” e l’incipit della voce di Wikipedia dice
WikipediaDocBook is a Semantics markup language for technical documentation. It was originally intended for writing technical documents related to computer hardware and software but it can be used for any other sort of documentation.
renareto” post=76953hai anche un link per vedere come funziona?
Ti ho dato i link ai repository dei due progetti, cosa ti serve altro di preciso? Tieni presente che se non hai intenzione di tradurre il tuo manuale in più lingue il lavoro si semplifica notevolmente, diventa un semplice repository con il sorgente LaTeX e basta. Eventualmente puoi aggiungere un Makefile o simile per automatizzare la compilazione.
Edit un altro linguaggio utile per la creazione di documentazione è Texinfo, utilizzato per la documentazione dei programmi del progetto GNU. Sviluppato da Karl Berry (che probabilmente qualcuno conoscerà), ha una sintassi vagamente simile a quella di LaTeX e permette di ottenere l’output in PDF, DVI, HTML, DocBook, XML e info. Sito del progetto, voce su Wikipedia