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.
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.
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
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
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.
Se si vuole convertire il proprio file per il navigatore GNU info, basta eseguire il seguente comando:
% linuxdoc -B info pippo.sgml
Per output LyX, usare il comando:
% linuxdoc -B lyx pippo.sgml
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.