DocBook XML/SGML Processing Using OpenJade
Prev |  | Next

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

Prev | Home | Next
Requirements |  | Using OpenJade