2. Requisiti
Si deve scaricare e compilare un solo pacchetto (OpenJade). Questo HOWTO illustrerà la procedura di compilazione, ma il lettore dovrebbe avere familiarità con l'installazione da codice sorgente.
La maggior parte dei pacchetti necessari sono disponibili sul sito web The Linux Documentation Project (TLDP).
2.1. Pre-requisiti
Creare una directory /tmp/downloads. Sarà utilizzata per archiviare il codice sorgente scaricato.
2.2. OpenJade
OpenJade sarà utilizzato per trattare documenti DocBook. OpenJade può essere scaricato da: http://openjade.sourceforge.net/.
Al momento della stesura del presente documento, era disponibile la versione OpenJade 1.3.1. Il file da scaricare è openjade-1.3.x.tar.gz.
2.3. Le DTD DocBook
Tutte le DTD DocBook sono disponibili sul sito The Linux Documentation Project all'indirizzo http://www.tldp.org/authors/index.html#resources.
Scaricare le seguenti DTD: DocBook SGML v4.1, DocBook SGML v3.1 e DocBook XML v4.1.2.
 | Nota |
|---|---|
Scaricare tutti gli archivi zip. |
2.4. Entità ISO
Per comodità degli utenti, The Linux Documentation Project ha compresso tutte le entità in un unico grande file tar, collocato all'indirizzo http://www.tldp.org/authors/tools/entities.tar.gz. Grazie al TLDP per questo.
2.5. DSSSL di Norman Walsh
Il DSSSL sviluppato da Norman Walsh può essere scaricato dal sito web del progetto DocBook: http://sourceforge.net/project/showfiles.php?group_id=21935.
Al momento della stesura del presente documento era disponibile il file docbook-dsssl-1.7.6.
2.6. Fogli di stile DSL personalizzati da LDP
LDP DSL è un foglio di stile personalizzato usato da The Linux Documentation Project (TLDP). È una estensione del DSSSL di Norman Walsh. Sono state aggiunte cose come gli sfondi e gli Indici. Può essere scaricato da http://www.tldp.org/authors/tools/ldp.dsl.
Il file ldp.dsl richiede il DSSSL di Norman Walsh.
2.7. HTMLDOC (Opzionale)
HTMLDOC può essere utilizzato per convertire l'HTML in PDF. Se preferite produrre documenti in PDF, potrete scaricare HTMLDOC da http://www.easysw.com/htmldoc/software.php.
2.8. XSL di Norman Walsh (Opzionale)
Questo non è necessario. Ma qualora si volesse utilizzare Tomcat + Cocoon come server di contenuti per documenti XML DocBook 4.1.2, saranno necessari i fogli di stile XML creati da Norman Walsh.
I fogli di stile sono disponibili sul sito http://sourceforge.net/projects/docbook/.
Si può scaricare il pacchetto chiamato docbook-xsl.
| Nota |
|---|---|
Recentemente è stata rilasciata la versione 1.57.0 del pacchetto. Quanto qui detto è stato verificato con l'ultima versione, apportando al testo le opportune modifiche. Chi dovesse incontrare ancora errori, è pregato di avvisarmi via e-mail all'indirizzo <saqib@seagate.com>. |
2.9. XSL personalizzati da LDP (Opzionali)
I fogli di stile personalizzati da LDP possono essere scaricati da http://my.core.com/~dhorton/docbook/tldp-xsl/.