DocBook to LaTeX/ConTeXt Publishing

Benoît Guillon

Abstract

This project is splitted in two instances working on the same principles. Both instances are intended to produce DVI, PostScript, PDF documents from DocBook SGML or XML sources, by converting first to a high level set of TeX macros.

Even if close, each instance is provided as an independent package and works alone. The available instances are:

dblatex

Publishing is done by using LaTeX.

dbcontext

Publishing is done by using ConTeXt.


Table of Contents

I. Dblatex
1. Introduction
What about DB2LaTeX?
Features
Version
Changes
Release 0.2.7
Release 0.2.6
Release 0.2.5
Release 0.2.4
Release 0.2.3
Release 0.2.2
Release 0.2.1
Release 0.2
Release 0.2pre
Release 0.1.10
Release 0.1.9
Release 0.1.8
Release 0.1.7
Release 0.1.6
Release 0.1.5
Release 0.1.4.1
Release 0.1.4
Publishing Principles
Backend Drivers
XSL Stylesheets
Python Post Processing
LaTeX Style Package
2. Installing the Package
Content
Installing on Unix Systems
Dependencies
Installation
Installing on Windows
Dependencies
Installation
3. Using dblatex
dblatex - convert DocBook to LaTeX, DVI, PostScript, and PDF
Output Formatting Style
How it works
Adding a New Formatting Style
Figure Inclusion
Presentation
Converting on the fly
Paths Lookup
Writing mathematical equations
Presentation
Implementation choice
Compatibility
Writing MathML equations
Creating an Index
Writing a Bibliography
Using Bibliography Entries
Using BibTeX Databases
Natbib Citations
Document Revisions
Locale Support
Document Encoding
Babel Languages
CJK Languages
Mixing the languages
Using XRefsyle and Olinks
4. Customization
XSL Parameters
imagedata.default.scale
latex.hyperparam
Setting Command line Parameters
XSL User Stylesheet
Changing the XSL parameter values
Overriding some templates
Customized LaTeX style
Reusing an existing LaTeX style
Package options
Needed packages
DocBook interface
Debugging your Style
Latex post process script
Post latex compilations
Dblatex Configuration File
Configuration File Format
Configuration Paths
Customization Precedence
5. FAQ
II. Dbcontext User Manual
6. Introduction
Link to dblatex
What about DocbookInContext?
Features
What is missing
Version
7. Installing the package
Content
Dependencies
ConTeXt Release
Installation
Installing the dependencies
Installing dbcontext
8. Using dbcontext
Publishing with dbcontext
Including Figures
Presentation
Converting on the fly
Paths Lookup
Writing mathematical equations
Presentation
Implementation choice
Compatibility
Creating an Index
Document Revisions
9. Customization
XSL Parameters
Setting command line Parameters
Using an XSL Parameter Stylesheet
FO-like Layout Parameters
Using your ConTeXt Layout

List of Figures

1.1. Transforming Process

List of Examples

3.1. Choosing the DB2LaTeX style
3.2. Figure inclusion
3.3. Figure conversion
3.4. Figures lookup
3.5. Equation taken from TDG
3.6. Index Entry
3.7. A Bibliography
3.8. Bibliography using BibTeX databases
4.1. Configuring with latex.hyperparam
4.2. Overriding templates
4.3. Reused LaTeX style
4.4. User Manual Configuration File
4.5. Customization Precedence
8.1. Figure inclusion
8.2. Figure conversion
8.3. Figures lookup
8.4. Equation taken from TDG
8.5. Index Entry