Custom LaTeX Styles

DB2LaTeX uses a variety of standard LaTeX commands and environments. Most of these are provided by a LaTeX document-class or by style files that are part of the LaTeX software distribution. In some cases, DB2LaTeX must supplement these commands with its own LaTeX instructions. Most of this occurs within the ‘preamble’ of your LaTeX file (that is, the file created by transforming your source document with the DB2LaTeX stylesheets).

The preamble of books and articles is provided by DB2LaTeX templates and parameters described in the Reference section:

The preamble can be heavily customised in a number of ways. All of these methods are enabled through the use of stylesheet parameters (described in the main customization guide).

There is no single ‘best’ way to achieve this --- you will need to use whatever methods are best for your circumstances. You can see demonstrations of all techniques in the DB2LaTeX sample files.

Essential Preamble

There are a great many differences between the default behaviour of LaTeX and the semantics of DocBook. To bridge the gap, DB2LaTeX requires certain commands that we have invented ourselves. These form the “essential” preamble --- your documents will fail to work with LaTeX without these commands. As such, DB2LaTeX does not allow you to remove these commands from the preamble. Other commands may be removed. We have not yet placed all the essential commands into the essential preamble --- it is a “work in progress”.

If you use BibTeX or makeindex, you can customise them using regular .bst or .ist files.

In future, we will provide a list of packages that DB2LaTeX uses. For the time being, you may wish to look at the list of packages in the Reference index. It is known that the teTeX distribution of LaTeX is sufficient. (In fact, most DB2LaTeX development is conducted using teTeX versions 1 and 2.) There are some extra packages, such as truncate.sty, that are beneficial but not supplied with teTeX 1 (see the CTAN search facility).

In future, we will provide a description of the LaTeX commands that DB2LaTeX relies upon or modifies. For the time being, you will need to inspect preamble.mod.xsl (and any other modules that contain ‘essential’ sections of the preamble).