3. Installazione degli strumenti di elaborazione - OpenJade

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

3.1. Installazione di OpenJade

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:

  1. Cambiare la directory corrente in /tmp/downloads.

    
	# cd /tmp/downloads
    	
  2. Decomprimere il file.

    
	# gzip -d openjade-1.3.x.tar.gz
    	
  3. Estrarre i file dall'archivio.

    
	# tar -xvf openjade-1.3.x.tar
    	
  4. Cambiare la directory corrente in openjade-1.3.

    
	# cd openjade-1.3.x
    	
  5. Eseguire il comando ./configure.

    
	# ./configure --prefix=/usr/local/dbtools/openjade
    	
  6. Eseguire il comando make.

    
	# make
    	
  7. Eseguire il comando make install. Completato questo passo, i file binari di OpenJade saranno installati in /usr/local/dbtools/openjade.

    
	# make install
    	
  8. Copiare la directory dsssl da /tmp/downloads/openjade-1.3.x in /usr/local/dbtools/openjade

    
	# cp -dpR dsssl /usr/local/dbtools/openjade/
    	

3.2. Installazione del DSSSL di Norman Walsh

In questa fase si installerà il DSSSL di Norman Walsh in una collocazione appropriata. Il DSSSL non necessita di compilazione.

  1. Cambiare la directory corrente in /tmp/downloads.

    
	# cd /tmp/downloads
    	
  2. Decomprimere il file.

    
	# gzip -d docbook-dsssl-1.76.tar.gz
    	
  3. Estrarre il file dall'archivio.

    
	# tar -xvf docbook-dsssl-1.76.tar
    	
  4. Spostare il file in /usr/local/dbtools/docbook-dsssl.

    
	# mv docbook-dsssl-1.76 /usr/local/dbtools/docbook-dsssl
    	

3.3. Installazione dei DTD di DocBook

In questa sezione installeremo i DTD di DocBook.

  1. Cambiare la directory corrente in /usr/local/dbtools.

    
	# cd /usr/local/dbtools
    	
  2. Creare tre nuove directory chiamate dtd3.1, dtd4.1 e dtd4.1.2.

    
	# mkdir dtd3.1
    	# mkdir dtd4.1
    	# mkdir dtd4.1.2
    	
  3. Cambiare la directory corrente in dtd3.1.

    
		# cd dtd3.1
    		
  4. Decomprimere il file DocBook SGML v3.1 in questa directory.

    
		# unzip /tmp/downloads/docbk31.zip
    		
  5. Cambiare la directory corrente in dtd4.1.

    
		# cd ../dtd4.1
    		
  6. Decomprimere il file DocBook SGML v4.1 in questa directory.

    
		# unzip /tmp/downloads/docbk41.zip
    		
  7. Cambiare la directory corrente in dtd4.1.2.

    
		# cd ../dtd4.1.2
    		
  8. Decomprimere il file DocBook XML v4.1.2 in questa directory.

    
		# unzip /tmp/downloads/docbk412.zip
    		

3.4. Installazione delle Entità ISO

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.

  1. Cambiare la directory corrente in /usr/local/dbtools/dtd3.1.

    
	# cd /usr/local/dbtools/dtd3.1
    	
  2. Copiare il file /tmp/downloads/entities.tar.gz in questa directory.

    
	# cp /tmp/downloads/entities.tar.gz .
    	
  3. Decomprimere il file.

    
	# gzip -d entities.tar.gz
    	
  4. Estrarre i file dall'archivio.

    
	# tar -xvf entities.tar
    	

Si installino ora le entità ISO per le DTD SGML, versione 4.1.

  1. Cambiare la directory corrente in /usr/local/dbtools/dtd4.1.

    
	# cd /usr/local/dbtools/dtd4.1
    	
  2. Copiare il file /tmp/downloads/entities.tar.gz in questa directory.

    
	# cp /tmp/downloads/entities.tar.gz .
    	
  3. Decomprimere il file.

    
	# gzip -d entities.tar.gz
    	
  4. Estrarre i file dall'archivio.

    
	# tar -xvf entities.tar
    	

3.5. Installazione del DSL di LDP

Infine, si installino i fogli di stile personalizzati di LDP.

  1. Cambiare la directory corrente in /tmp/downloads.

    
	# cd /tmp/downloads 
    	
  2. 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
    	
  3. 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
    	

3.6. Installazione di HTMLDOC

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...