2. Installazione

2.1 Dove ottenere l'archivio dei sorgenti

L'archivio dei sorgenti del linuxdoc-tools si può ottenere dal sito:

• http://www.debian.org/~sano/linuxdoc-tools/

Il nome dell'archivio può essere linuxdoc-tools_x.y.z.tar.gz o linuxdoc-tools_x.y.z-rel.tar.gz o linuxdoc-tools_x.y.z.orig.tar.gz. Questi hanno contenuto equivalente. Se ne può usare uno qualsiasi.

2.2 Cosa è necessario a LinuxDoc-Tools

LinuxDoc-Tools dipende dall'uso dell'analizzatore (parser) sgml da Jade o OpenJade (nsgmls o onsgmls). Almeno uno di questi deve essere installato per usare LinuxDoc-Tools.

L'archivio sorgente di linuxdoc-tools contiene gli strumenti e i dati che sono necessari per scrivere documenti SGML e convertirli a groff, LaTeX, PostScript, HTML, GNU info, LyX e RTF. In aggiunta a questo pacchetto, saranno necessari alcuni strumenti aggiuntivi per la genezione di output formattato.

1. groff. È necessaria la versione 1.08 o maggiore. Lo si può scaricare da ftp://prep.ai.mit.edu/pub/gnu. C'è una versione binaria per Linux su ftp://sunsite.unc.edu/pub/Linux/utils/text. groff è necessario per produrre testo semplice dai documenti SGML. nroff non funzionerà! Si può scoprire la propria versione di groff usando il comando groff -v < /dev/null.
2. TeX e LaTeX. Questo è disponibile praticamente ovunque; non ci dovrebbero essere problemi a prelevarlo e installarlo (c'è una distribuzione in formato binario per Linux su sunsite.unc.edu). Ovviamente, TeX/LaTeX è necessario solo se si vuole formattare i propri documenti SGML con LaTeX. Per questo l'installazione di TeX/LaTeX è opzionale. Se si vuole un output in PDF, allora è necessario avere anche pdfLaTeX.
3. flex. lex probabilmente non funzionerà. flex si può scaricare da: ftp://prep.ai.mit.edu/pub/gnu.
4. gawk e gli strumenti GNU info, per formattare e visualizzare i file info. Questi sono disponibili anche su: ftp://prep.ai.mit.edu/pub/gnu; oppure su: ftp://sunsite.unc.edu/pub/Linux/utils/text (per gawk) e ftp://sunsite.unc.edu/pub/Linux/system/Manual-pagers (per gli strumenti GNU info). awk non funzionerà.
5. LyX (una interfaccia quasi WYSIWYG per LaTeX, con struttura SGML) è disponibile su: ftp://ftp.via.ecp.fr.

2.3 Installare il software

I passaggi necessari per installare e configurare LinuxDoc-Tools sono i seguenti:

1. Prima, scompattare il file tar dell'archivio sorgente da qualche parte. Questo creerà la directory linuxdoc-tools-x.y.z. Non è importante dove vengono espansi i file; solo non si deve spostare nulla all'interno dell'albero dei sorgenti estratto.
2. Leggere il file INSTALL; ci sono istruzioni dettagliate sull'installazione. Seguirle. Se tutto è andato bene, si dovrebbe essere pronti per usare il sistema immediatamente.