Installing on Unix like Systems

Dblatex Packages
Dependencies
Installation

Dblatex Packages

Dblatex is packaged for these Systems or Distributions:

If you are installing on one of these distributions, follow their recommended way of installation, and you can safely ignore the next sections that give details for installing dblatex from the source tarball.

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:

  1. Install Python if necessary.

  2. Install LaTeX.

  3. Install the XSLT. By default xsltproc is used.

  4. Install the XML DocBook DTD.

  5. 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
        
  6. 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:

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