Simon Pepping Michael Wiedmann

DocbookInContext is a mapping of Docbook XML files to the ConTeXt macro package for TeX. It is built upon the XML interface of context. It allows one to produce a typeset version of a Docbook XML file, in dvi or pdf format.

Change directory to the top directory of one of the texmf trees of your TeX installation, e.g. /usr/share/texmf, and untar the distribution file DocbookInContext.tar.gz. Then run the command mktexlsr for that tree, e.g. mktexlsr /usr/share/texmf. Test the result by issuing the command kpsewhich xtag-docbook.tex. The reply should be the path of one of the files just installed, e.g. /usr/share/texmf/tex/context/DocbookInContext/xtag-docbook.tex.

Run context on a Docbook XML file using xtag-docbook.tex as the map file. Context offers several possibilities to do this, see the context XML manual example.pdf. One option is to construct a TeX file that inputs the mapping file xtag-docbook.tex, and in the text block inputs the XML file with the command \processXMLfilegrouped. For example: \input xtag-docbook \setupindenting[medium] \setupheadertexts[section][pagenumber] \setupheader[leftwidth=.7\hsize,style=slanted] \setuppagenumbering[location=] \setupitemize[each][packed][before=,after=,indentnext=no] \starttext \processXMLfilegrouped{\jobname.xml} \stoptext Test this on the README file. It comes in an XML version with a corresponding TeX file README.tex. The command texexec --pdf README produces the file README.pdf, which you may now use to read the following sections.

DocbookInContext is compatible with ConTeXt version 2002.6.25. Because it modifies several context commands, compatibility may be broken by new releases of context.

Discussions with the ConTeXt Task Force about integration of this module with the context distribution are ongoing. They may result in changes in the names of the module and of the directory in which it is installed.

The DocbookInContext project was started by Simon Pepping in January 2002 after a suggestion by Hans Hagen. Soon Michael Wiedmann joined him. Simon did and does most of the ConTeXt programming. Michael contributed the localization files and part of the mappings. His knowledge of Docbook theory, practice and community and his test files feed the project with practical goals.

The copyright of this module rests with the authors and contributors. The module is released under the GNU General Public License Version 2, June 1991. See the file COPYRIGHT for details. If the module or part of it is received as part of a an official ConTeXt distribution, the context license is applicable. See the file mreadme.pdf of the context distribution for details.