Pipeline Script: DTBook to LaTeX [BETA]

Overview

This script converts a DTBook 2005 document to LaTeX.

The script can be used to produce LaTeX which can be rendered to PDF and used for Large Print.

The main reason this script is still in "BETA" is to indicate that the maintainer welcomes any feedback, requests or even bug reports.

Input Requirements

No specific requirements beyond that the input needs to be a valid DTBook 2005 document.

Output

The script generates LaTeX output which can be transformed to PDF. A modern version of LaTeX is recommended as the generated output requires XeTeX which has features for Unicode and TrueType font handling. The best bet is probably to install TeX Live which should include XeTeX and many fonts.

On Linux you need to invoke xelatex to produce PDF from the generated LaTeX document. For instructions on how to invoke xelatex on Windows consult the TeX Live documentation.

It is also recommended that you install the Tiresias LPfont which is well suited for large print publications.

Please note that the PDF generated by LaTeX is not tagged and hence not accessible. For producing hard copy Large Print however this script is perfectly fine.

Configuration

Input DTBook
Required. The input DTBook document; the grammar version needs to be in the 2005 series.
Output XHTML
Required. Resulting XHTML 1.O document.
Font size
Optional. The font size to be used for the generated LaTeX. See also the documentation of the extsizes package (http://www.ctan.org/tex-archive/macros/latex/contrib/extsizes).
Font
Optional. The font to be used for the generated LaTeX. Make sure you have the specified fonts installed on your system. See also the TeX Live documentation.
Page style
Optional. The page style to use for the document. The three possible values are:
Plain
This is the simplest style. It contains no headers, a very simple footer with the page number. Page numbers of the original document are not displayed and the sections are not numbered.
With original page numbers
This style is similar in simplicity to the 'Plain' style but page numbers of the original document are displayed.
Scientific
This is a more fancy page style that contains the section title and the page number in the header. Page numbers of the original are shown and the sections are numbered. It corresponds to the standard LaTeX book style.
Alignment
Optional. The alignment to use for standard text. Normally text is normally best read if it is justified. However under some circumstances text can be easier read if it is left aligned. It will also have less hyphenated words.
Default language
Optional. The language to use for the babel package if no xml:lang tag specifies it. For all valid values check the babel documentation (http://www.ctan.org/get/macros/latex/required/babel/babel.pdf).
Paper size
Optional. The paper size to be used for the generated LaTeX.
XML Validation Report
Optional. Path to a file to store a validation XML report in.

Appendix: List of Transformers used

The documents linked below are parts of the Transformer technical documentation. These are developer and systems-administrator centric documents.

  1. DTBook 2 LaTeX