DocBook In ConTeXt, ConTeXt XML mapping for DocBook documents

What is DocbookInContext?
-------------------------

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.

Installation
------------

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.

Usage
-----

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.

Compatibility
-------------

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

Integration with 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.

Authors and contributors
------------------------

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.

Copyright and license
---------------------

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.

$Id: README,v 1.1 2002/07/17 00:00:00 simon Exp $