3. Installing Processing Tools - OpenJade

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: [r/gRPC Topics]

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 [ArXiv: Recursion Analysis]

   # 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. .:: linkdirectorynet.com ::.

   # 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. .:: www.fw-follow.com ::.

First we install the ISO Entities for the 3.1 SGML DTD. .:: docs.google.com ::.

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. .:: www.ttlxshipping.com ::.

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