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:
Change directories to /tmp/downloads.
# cd /tmp/downloads
Unzip the file.
# gzip -d openjade-1.3.x.tar.gz
Untar the file.
# tar -xvf openjade-1.3.x.tar
Change directories to openjade-1.3
# cd openjade-1.3.x
Run the ./configure command.
# ./configure --prefix=/usr/local/dbtools/openjade
Run the make command.
# make
Run the make install command. After this step the OpenJade binaries will be installed under /usr/local/dbtools/openjade.
# make install
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.
Change directories to /tmp/downloads
# cd /tmp/downloads
Unzip the file.
# gzip -d docbook-dsssl-1.76.tar.gz
Untar the file.
# tar -xvf docbook-dsssl-1.76.tar
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.
Change directories to /usr/local/dbtools.
# cd /usr/local/dbtools
Create three new directories called dtd3.1, dtd4.1, and dtd4.1.2.
# mkdir dtd3.1 # mkdir dtd4.1 # mkdir dtd4.1.2
Change directories to the dtd3.1.
# cd dtd3.1
Unzip the file DocBook SGML v3.1 in this directory.
# unzip /tmp/downloads/docbk31.zip
Change directories to the dtd4.1.
# cd ../dtd4.1
Unzip the file DocBook SGML v4.1 in this directory.
# unzip /tmp/downloads/docbk41.zip
Change directories to the dtd4.1.2.
# cd ../dtd4.1.2
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.
Change directories to the /usr/local/dbtools/dtd3.1 directory.
# cd /usr/local/dbtools/dtd3.1
Copy /tmp/download/entities.tar.gz to this directory.
# cp /tmp/download/entities.tar.gz .
Unzip the file.
# gzip -d entities.tar.gz
Untar the file.
# tar -xvf entities.tar
Next we install the ISO Entities for the 4.1 SGML DTD.
Change directories to the /usr/local/dbtools/dtd4.1 directory.
# cd /usr/local/dbtools/dtd4.1
Copy /tmp/download/entities.tar.gz to this directory.
# cp /tmp/download/entities.tar.gz .
Unzip the file.
# gzip -d entities.tar.gz
Untar the file.
# tar -xvf entities.tar
3.5. Installing the LDP DSL
Finally we install the customised LDP stylesheet.
Change directories to the /tmp/download directory.
# cd /tmp/download
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
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... |