Karakas Online

7.1.7. Catalogs

A catalogue is a text file containing the translation rules of the public identifier to system's files.

The identifier systems used by SGML and by some tools are based on catalogues that perform the translation of these identifiers to files that hold the necessary definitions. For tools to be able to find the necessary catalogue(s), the environment variable SGML_CATALOG_FILES should be set, as explained in Section 7.1.3.

In my system, the sgmltools-lite package installed the /etc/sgml/catalog file. Its content can be used to set SGML_CATALOG_FILES as follows:

SGML_CATALOG_FILES="/usr/share/sgml/CATALOG.iso_ent" SGML_CATALOG_FILES="$SGML_CATALOG_FILES:
/usr/share/sgml/CATALOG.docbook-dsssl-stylesheets" SGML_CATALOG_FILES="$SGML_CATALOG_FILES:
/usr/share/sgml/CATALOG.docbook_3" SGML_CATALOG_FILES="$SGML_CATALOG_FILES:
/usr/share/sgml/CATALOG.docbook_4" SGML_CATALOG_FILES="$SGML_CATALOG_FILES:
/usr/share/sgml/openjade/catalog" SGML_CATALOG_FILES="$SGML_CATALOG_FILES:
/usr/share/sgml/stylesheets/sgmltools/sgmltools.cat" SGML_CATALOG_FILES="$SGML_CATALOG_FILES:
/usr/share/sgml/dtd/sgmltools/catalog" 
export SGML_CATALOG_FILES 

However, as recent versions of lyxtox do not use sgmltools, I use the relevant (and only those!) lines of my “master” catalog file in /etc/sgml/catalog to define SGML_CATALOG_FILES as:

SGML_CATALOG_FILES="$SGML_CATALOG_FILES:/usr/share/sgml/CATALOG.iso_ent"
SGML_CATALOG_FILES="$SGML_CATALOG_FILES:/usr/share/sgml/CATALOG.docbook-dsssl-stylesheets"
SGML_CATALOG_FILES="$SGML_CATALOG_FILES:/usr/share/sgml/CATALOG.mathml-2.0"
SGML_CATALOG_FILES="$SGML_CATALOG_FILES:/usr/share/sgml/CATALOG.svg-1.1"
SGML_CATALOG_FILES="$SGML_CATALOG_FILES:/usr/share/sgml/CATALOG.docbook_4"
SGML_CATALOG_FILES="$SGML_CATALOG_FILES:/usr/share/sgml/openjade/catalog"
SGML_CATALOG_FILES="$SGML_CATALOG_FILES:/usr/share/refdb/refdb.cat"
export SGML_CATALOG_FILES

Generally, you'll need to set the SGML_CATALOG_FILES environment variable to all the catalogs that you have under the directory you installed the DocBook stylesheets (probably something like /usr/share/sgml or /usr/local/sgml, see Section 3.2 and Section 3.3 for the packages that install stylesheets).

If you want to learn more on catalogues and the way they are constructed, see Creating and modifying catalogues.

Last updated Mon Sep 24 01:19:25 CEST 2007 Permalink: http://www.karakas-online.de/mySGML/explain-catalogs.html All contents © 2002-2007 Chris Karakas