Installing on Unix Systems

Installing on Unix Systems
Prev	Chapter 2. Installing the Package	Next

Dependencies

To work, the following items must be available:

An XSLT. xsltproc is the default XSLT used, but one can also use 4suite.
The XML DocBook DTD.
A recent LaTeX distribution. The configure script checks that the needed latex packages are available.
Python >= 2.4.

Installation

Installing the dependencies

To use the package, install properly the dependencies:

Install Python if necessary.
Install LaTeX.
Install the XSLT. By default xsltproc is used.
Install the XML DocBook DTD.

Create a catalog file, that defines where to find the DTD. Here is an example:

PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
    "file:///usr/local/share/xml/docbook/dtd/4.1.2/docbookx.dtd"

If the XML Gnome tools are available, it's a good idea to create an XML catalog by using xmlcatalog such like this:

% xmlcatalog --noout --create mycatalog
% xmlcatalog --noout --add 'public' '-//OASIS//DTD DocBook XML V4.1.2//EN' \
                           'file://path/to/4.1.2/docbookx.dtd' mycatalog

Add the catalog path to the SGML_CATALOG_FILES variable:
```
export SGML_CATALOG_FILES=$SGML_CATALOG_FILES:/path/to/mycatalog
```
You can skip this step if you configure the dblatex installation with the --catalogs option.

Installing the tool

The steps to follow are the following:

Untar the ball. For a bzipped release, do as follow:
```
% tar xvfj dblatex-x.x.x.tar.bz2
```
For a gzipped release, do as follow:
```
% tar xvfz dblatex-x.x.x.tar.gz
```
Install the package. The installation script preliminary checks the dependencies. In the example, the dblatex script is installed under /usr/local/bin and the other files are installed under /usr/local/share/dblatex. Besides, the --catalogs option tells where to find the catalogs.
```
% cd dblatex-x.x.x
% python ./setup.py install --prefix=/usr/local --catalogs=/path/to/mycatalog
```