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.
To work, the following items must be available:
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.
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
Since version 0.3.2 dblatex is distributed as a Python Egg in the Python Package Index (PyPI). It requires to have easy_install installed.
The procedure to follow is:
Call simply easy_install:
% easy_install dblatex
Searching for dblatex
Reading http://pypi.python.org/simple/dblatex/
Reading http://dblatex.sf.net
Best match: dblatex 0.3.1.1
Downloading http://pypi.python.org/packages/2.5/d/dblatex/dblatex-0.3.1.1-py2.5.egg#md5=8520d596e473ff544eb9dcdc5175d7ae
Processing dblatex-0.3.1.1-py2.5.egg
creating /path/to/dblatex-0.3.1.1-py2.5.egg
Extracting dblatex-0.3.1.1-py2.5.egg to /path/to
Adding dblatex 0.3.1.1 to easy-install.pth file
Installing dblatex script to /path/to
Installed /path/to/dblatex-0.3.1.1-py2.5.egg
That's it!