Software for use with ConTeXt

DocbookInContext | EuroTeX2003 presentation | Ignorable white space | ConTeXt install script

DocBook In ConTeXt
ConTeXt XML mapping for DocBook documents

For more info see the README file or the README.xml file.

Download: DocbookInContext.tar.gz (26kB) (5 March 2003) or the development version (35kB) (06 August 2003)

Input with latin-1 and utf-8 encodings is enabled. This feature works properly in a Context version from early December or later. Recent addition: Metapost graphics for admonitions. Most recent addition: Attribute actions are implemented on an experimental basis. See the file Customization for an explanation and details. Every release contains numerous new small features and fixes.

The beta version was tested with the Context version of 4 March 2003.

Known problem with the beta version: Sometimes Context inserts a spurious pagebreak; this seems to be connected with the use of backgrounds. I have noted a similar problem with the Index.

Not every variation can be captured in a customization option. When you discover that your customization needs go beyond the options Docbook In Context offers, you can write your own module. For an example see Richard Rascher-Friesenhausen's m-docbook.tex. (Note that this is an example; several commands in the module are now part of Docbook In Context.)

EuroTeX2003: Presentation and Proceedings

At the EuroTeX2003 Conference in Brest (France), I gave a presentation on Docbook In Context, and I contributed an article to the Proceedings.


Ignorable white space

Context contains an XML parser. However, some tasks are beyond the power of an XML parser written in TeX. One such task is taking ignorable white space into account. Blank lines in the input XML file are read by TeX as paragraph separators. Usually it does not harm the XML mapping, but sometimes it presents an insurmountable obstacle. On such files preprocessing is the only solution. Here I offer two preprocessing tools to remove ignorable white space from an XML file.

Even if your XML file does not present problems with white space, it may be a interesting exercise to run it through one of these preprocessors, esp. the Normalizer document handler. Then browse through the preprocessed file with the idea that every space you see in it is meaningful white space. Is this really what you intend?

ConTeXt install script

Latest version: 8 March 2002

The installation script install_context.pl installs a new ConTeXt distribution in the requested TeX tree. The script works for a kpathsea TeX installation, and uses its properties to determine the best course of action. The script requires that the the unzip command is in the path for executables. It is recommended to use a texexec script that passes the formats directory to the fmtutil script of the TeX installation.

The script is written under the assumption that separate ConTeXt installs are done outside the main system tree of the TeX installation. It tries to place the new formats in the installation TeX tree, not in the default formats directory.

If the installation TeX tree exists, the existing ConTeXt distribution in it is removed. If the tree does not exist, it is created. By default, the languages of the existing ConTeXt distribution are reinstalled.

History

11/10/2002
better handling of the various unzip exit codes
04/12/2002
change $textree into an absolute path if given as a relative path
05/12/2002
added mktexlsr $textree command; protect against empty pattern in dirfiles
07/12/2002
added another mktexlsr $textree command after format making
08/03/2003
added tex/context/cont-*.ini files and context/user/cont-sys.rme to the list of existing context files; put the lists of existing context files in separate variables at the top
13/08/2003
changed context/user/cont-sys.rme to tex/context/user/cont-sys.rme

A modified version of texexec, which passes the formats directory to the ftmutil script of the TeX installation.