4. Formattare documenti SGML

Supponendo di avere il documento SGML pippo.sgml, che si vuole formattare. Quella che segue è una panoramica generale sulla formattazione del documento per output in differenti formati. Per una lista completa delle opzioni, consultare le pagine man.

4.1 Controllare la sintassi SGML

Se si vuole solamente vedere gli errori della conversione SGML, usare il comando ``linuxdoc -B check''. Per esempio:

% linuxdoc -B check pippo.sgml

Se, quando viene eseguito questo controllo, non si vede altro output oltre al messaggio ``Processing...'', questo è positivo. Significa che non ci sono errori.

4.2 Creare output in testo semplice

Se si vuole produrre testo semplice, usare il comando:

% linuxdoc -B txt pippo.sgml

È possibile creare anche sorgenti groff per pagine man, che possono essere formattate con groff -man. Per fare questo dare il seguente comando:

% linuxdoc -B txt --man pippo.sgml

4.3 Creare output LaTeX, DVI, PostScript o PDF

Per creare documenti LaTeX da sorgenti SGML, eseguire semplicemente:

% linuxdoc -B latex pippo.sgml

Se si vuole produrre output PostScript (attraverso dvips), usare l'opzione -o:

% linuxdoc -B latex --output=ps pippo.sgml

Oppure si può produrre un file DVI:

% linuxdoc -B latex --output=dvi pippo.sgml

Si può produrre anche un file PDF:

% linuxdoc -B latex --output=pdf pippo.sgml

4.4 Creare output HTML

Se si vuole produrre output HTML, usare:

% linuxdoc -B html --imagebuttons pippo.sgml

Questo produrrà pippo.html, come anche pippo-1.html, pippo-2.html e così via: un file per ogni sezione del documento. Avviare il proprio browser WWW su pippo.html, che è il file principale. Assicurarsi anche che tutti i file HTML generati a partire dal documento si trovino in una stessa directory, poiché essi usano URL locali come riferimenti gli uni agli altri.

L'opzione --imagebuttons comunica al driver di backend html di usare le frecce grafiche come bottoni di navigazione. I nomi di queste icone sono "next.png", "prev.png" e "toc.png"; il sistema LinuxDoc-Tools fornisce le appropriate PNG nella sua directory delle librerie.

Se si usa ``linuxdoc -B html'' senza l'opzione ``-img'', i documenti HTML avranno in modo predefinito le etichette in inglese ``Previous'',``Next'' e ``Table of Contents'' per la navigazione. Se si specifica uno dei codici di lingua accettati nella opzione ``--language'', le etichette saranno tuttavia fornite in tale lingua.

4.5 Creare output GNU info

Se si vuole convertire il proprio file per il navigatore GNU info, basta eseguire il seguente comando:

% linuxdoc -B info pippo.sgml

4.6 Creare output LyX

Per output LyX, usare il comando:

% linuxdoc -B lyx pippo.sgml

4.7 Creare output RTF

Se vi vuole produrre output RTF, eseguire il comando:

% linuxdoc -B rtf pippo.sgml

Questo produrrà pippo.rtf, come anche pippo-1.rtf, pippo-2.rtf e così via; un file per ogni sezione del documento.