Installation

Installing the dependencies

To use the package, install properly the dependencies:

  1. Install Python if necessary.

  2. Install ConTeXt. Upgrading to a recent ConTeXt can be troublesome. Read carefully the recommendations available at http://wiki.contextgarden.net. At least you need to:

    • Have TeTeX-3.0 installed.

    • Install a Latin Modern font update.

    • Install a fresh ConTeXt distribution.

  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 installation with the --catalogs option.

Installing dbcontext

The steps to follow are the following:

  1. Untar the ball. For a bzipped release, do as follow:

    % bzip2 -dc dbcontext-x.x.x.tar.bz2 | tar xvf -

    For a gzipped release, do as follow:

    % gunzip -c dbcontext-x.x.x.tar.gz | tar xvf -    
  2. Install the package. You can specify the base directory with the --prefix option. You can also use the --catalogs option to specify where the catalogs are.

    % cd dbcontext-x.x.x
    % python ./setup.py install --prefix=/usr/local --catalogs=/path/to/mycatalog

    To know the other standard Python setup.py options, use the --help option.