CLASS="sect1" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" >

3. Installing Processing Tools - OpenJade

In this section we will install all the tools in the appropriate directories. All the tools go in the /usr/local/dbtools/ directory. Create this directory using the following command:


# mkdir /usr/local/dbtools

3.1. Installing OpenJade

This process is the easy part, but the most time consuming one too. Keep in mind that OpenJade take a long time to compile. To install OpenJade, complete the following steps:

  1. Change directories to /tmp/downloads.

    
	# cd /tmp/downloads
    	
  2. Unzip the file.

    
	# gzip -d openjade-1.3.x.tar.gz
    	
  3. Untar the file.

    
	# tar -xvf openjade-1.3.x.tar
    	
  4. Change directories to openjade-1.3

    
	# cd openjade-1.3.x
    	
  5. Run the ./configure command.

    
	# ./configure --prefix=/usr/local/dbtools/openjade
    	
  6. Run the make command.

    
	# make
    	
  7. Run the make install command. After this step the OpenJade binaries will be installed under /usr/local/dbtools/openjade.

    
	# make install
    	
  8. Copy the dsssl directory from /tmp/downloads/openjade-1.3.x to /usr/local/dbtools/openjade

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

3.2. Installing Norman Walsh's DSSSL

In this step we will install Norman Walsh's DSSSL in an appropriate place. The DSSSL does not have to be compiled.

  1. Change directories to /tmp/downloads

    
	# cd /tmp/downloads
    	
  2. Unzip the file.

    
	# gzip -d docbook-dsssl-1.76.tar.gz
    	
  3. Untar the file.

    
	# tar -xvf docbook-dsssl-1.76.tar
    	
  4. Move the file to the /usr/local/dbtools/docbook-dsssl.

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

3.3. Installing DocBook DTDs

In this section we will install the DocBook DTDs.

  1. Change directories to /usr/local/dbtools.

    
	# cd /usr/local/dbtools
    	
  2. Create three new directories called dtd3.1, dtd4.1, and dtd4.1.2.

    
	# mkdir dtd3.1
    	# mkdir dtd4.1
    	# mkdir dtd4.1.2
    	
  3. Change directories to the dtd3.1.

    
		# cd dtd3.1
    		
  4. Unzip the file DocBook SGML v3.1 in this directory.

    
		# unzip /tmp/downloads/docbk31.zip
    		
  5. Change directories to the dtd4.1.

    
		# cd ../dtd4.1
    		
  6. Unzip the file DocBook SGML v4.1 in this directory.

    
		# unzip /tmp/downloads/docbk41.zip
    		
  7. Change directories to the dtd4.1.2.

    
		# cd ../dtd4.1.2
    		
  8. Unzip the file DocBook XML v4.1.2 in this directory.

    
		# unzip /tmp/downloads/docbk412.zip
    		

3.4. Installing the ISO Entities

In this section we will install the ISO entities that we downloaded from the LDP website.

First we install the ISO Entities for the 3.1 SGML DTD.

  1. Change directories to the /usr/local/dbtools/dtd3.1 directory.

    
	# cd /usr/local/dbtools/dtd3.1
    	
  2. Copy /tmp/download/entities.tar.gz to this directory.

    
	# cp /tmp/download/entities.tar.gz .
    	
  3. Unzip the file.

    
	# gzip -d entities.tar.gz
    	
  4. Untar the file.

    
	# tar -xvf entities.tar
    	

Next we install the ISO Entities for the 4.1 SGML DTD.

  1. Change directories to the /usr/local/dbtools/dtd4.1 directory.

    
	# cd /usr/local/dbtools/dtd4.1
    	
  2. Copy /tmp/download/entities.tar.gz to this directory.

    
	# cp /tmp/download/entities.tar.gz .
    	
  3. Unzip the file.

    
	# gzip -d entities.tar.gz
    	
  4. Untar the file.

    
	# tar -xvf entities.tar
    	

3.5. Installing the LDP DSL

Finally we install the customised LDP stylesheet.

  1. Change directories to the /tmp/download directory.

    
	# cd /tmp/download 
    	
  2. Copy the ldp.dsl file to the /usr/local/dbtools/docbook-dsssl/print/ldp.dsl directory.

    
	# cp ldp.dsl /usr/local/dbtools/docbook-dsssl/print/ldp.dsl
    	
  3. Copy the ldp.dsl file to the /usr/local/dbtools/docbook-dsssl/html/ldp.dsl directory.

    
	# cp ldp.dsl /usr/local/dbtools/docbook-dsssl/html/ldp.dsl
    	

3.6. Installing HTMLDOC

This step is optional. It is only required if you want to produce PDF documents from HTML.

Change back to the downloads directory.


	# Change to /tmp/download directory

Untar the source code for HTMLDOC.


	# gzip -d htmldoc-1.8.xx-source.tar.gz 
	# tar -xvf htmldoc-1.8.xx-source.tar 
	# cd htmldoc-1.8.xx-1

Run configure to set the installation location.


	# ./configure --prefix=/usr/local/dbtools/htmldoc
	# make

At the time of writing this document HTMLDOC ver 1.8.20-1 was available. This version had a little problem in the fonts Makefile. It would complain while installing the fonts, because the correct fonts were not available on the system.

Here is the error you will get while running make install:


	# 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

To fix this installation issue, please edit fonts/Makefile and comment out the lines with references to ZapfChancery and ZapfDingbats fonts.

Then execute the install:


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