In questa sezione verrà spiegata l'installazione degli strumenti nelle directory appropriate. Tutti gli strumenti vanno posti nella directory /usr/local/dbtools/. Questa directory può essere creata con il seguente comando:
# mkdir /usr/local/dbtools |
Questa operazione è la parte più facile, ma anche quella che richiede più tempo. Si rammenti che OpenJade richiede un lungo tempo di compilazione. Per installare OpenJade, si completino i seguenti passi:
Cambiare la directory corrente in /tmp/downloads.
# cd /tmp/downloads |
Decomprimere il file.
# gzip -d openjade-1.3.x.tar.gz |
Estrarre i file dall'archivio.
# tar -xvf openjade-1.3.x.tar |
Cambiare la directory corrente in openjade-1.3.
# cd openjade-1.3.x |
Eseguire il comando ./configure.
# ./configure --prefix=/usr/local/dbtools/openjade |
Eseguire il comando make.
# make |
Eseguire il comando make install. Completato questo passo, i file binari di OpenJade saranno installati in /usr/local/dbtools/openjade.
# make install |
Copiare la directory dsssl da /tmp/downloads/openjade-1.3.x in /usr/local/dbtools/openjade
# cp -dpR dsssl /usr/local/dbtools/openjade/ |
In questa fase si installerà il DSSSL di Norman Walsh in una collocazione appropriata. Il DSSSL non necessita di compilazione.
Cambiare la directory corrente in /tmp/downloads.
# cd /tmp/downloads |
Decomprimere il file.
# gzip -d docbook-dsssl-1.76.tar.gz |
Estrarre il file dall'archivio.
# tar -xvf docbook-dsssl-1.76.tar |
Spostare il file in /usr/local/dbtools/docbook-dsssl.
# mv docbook-dsssl-1.76 /usr/local/dbtools/docbook-dsssl |
In questa sezione installeremo i DTD di DocBook.
Cambiare la directory corrente in /usr/local/dbtools.
# cd /usr/local/dbtools |
Creare tre nuove directory chiamate dtd3.1, dtd4.1 e dtd4.1.2.
# mkdir dtd3.1 # mkdir dtd4.1 # mkdir dtd4.1.2 |
Cambiare la directory corrente in dtd3.1.
# cd dtd3.1 |
Decomprimere il file DocBook SGML v3.1 in questa directory.
# unzip /tmp/downloads/docbk31.zip |
Cambiare la directory corrente in dtd4.1.
# cd ../dtd4.1 |
Decomprimere il file DocBook SGML v4.1 in questa directory.
# unzip /tmp/downloads/docbk41.zip |
Cambiare la directory corrente in dtd4.1.2.
# cd ../dtd4.1.2 |
Decomprimere il file DocBook XML v4.1.2 in questa directory.
# unzip /tmp/downloads/docbk412.zip |
In questa sezione installeremo le entità ISO scaricate dal sito web di LDP.
Per prime si installino le entità ISO per le DTD SGML, versione 3.1.
Cambiare la directory corrente in /usr/local/dbtools/dtd3.1.
# cd /usr/local/dbtools/dtd3.1 |
Copiare il file /tmp/downloads/entities.tar.gz in questa directory.
# cp /tmp/downloads/entities.tar.gz . |
Decomprimere il file.
# gzip -d entities.tar.gz |
Estrarre i file dall'archivio.
# tar -xvf entities.tar |
Si installino ora le entità ISO per le DTD SGML, versione 4.1.
Cambiare la directory corrente in /usr/local/dbtools/dtd4.1.
# cd /usr/local/dbtools/dtd4.1 |
Copiare il file /tmp/downloads/entities.tar.gz in questa directory.
# cp /tmp/downloads/entities.tar.gz . |
Decomprimere il file.
# gzip -d entities.tar.gz |
Estrarre i file dall'archivio.
# tar -xvf entities.tar |
Infine, si installino i fogli di stile personalizzati di LDP.
Cambiare la directory corrente in /tmp/downloads.
# cd /tmp/downloads |
Copiare il file ldp.dsl nella directory /usr/local/dbtools/docbook-dsssl/print/ldp.dsl.
# cp ldp.dsl /usr/local/dbtools/docbook-dsssl/print/ldp.dsl |
Copiare il file ldp.dsl nella directory /usr/local/dbtools/docbook-dsssl/html/ldp.dsl.
# cp ldp.dsl /usr/local/dbtools/docbook-dsssl/html/ldp.dsl |
Questo passo è opzionale. È richiesto solo se si vuole produrre documentazione PDF da documenti scritti in HTML.
Ritornare alla directory di download.
# cd /tmp/downloads directory |
Estrarre dall'archivio il codice sorgente di HTMLDOC.
# gzip -d htmldoc-1.8.xx-source.tar.gz # tar -xvf htmldoc-1.8.xx-source.tar # cd htmldoc-1.8.xx-1 |
Lanciare il comando configure per impostare la posizione dell'installazione.
# ./configure --prefix=/usr/local/dbtools/htmldoc # make |
Al momento della stesura di questo documento era disponibile la versione 1.8.20-1 di HTMLDOC. Questa versione aveva un piccolo problema di font nel Makefile. Si dovrebbe presentare al momento di installare i font, poiché i font corretti non sono disponibili sul sistema.
L'errore che si presenta al momento di lanciare il comando make install è questo:
# make install Making all in htmldoc... Making all in doc... Installing in fonts... Installing font files in /usr/local/dbtools/htmldoc/share/htmldoc/fonts... /bin/cp: cannot stat `ZapfChancery.afm': No such file or directory /bin/cp: cannot stat `ZapfChancery.pfa': No such file or directory /bin/cp: cannot stat `ZapfDingbats.afm': No such file or directory /bin/cp: cannot stat `ZapfDingbats.pfa': No such file or directory make[1]: *** [install] Error 1 |
Per correggere questo problema di installazione, si modifichi il file fonts/Makefile commentando le righe che fanno riferimento ai font ZapfChancery e ZapfDingbats.
Quindi si esegua l'installazione:
# make install Making all in htmldoc... Making all in doc... Installing in fonts... Installing font files in /usr/local/dbtools/htmldoc/share/htmldoc/fonts... Installing in data... Installing in doc... Installing in htmldoc... |