tbtolatex -- tbook XML to LaTeX conversion


tbtolatex [-t] {filename} [parameter = value...]


tbtolatex takes an XML file that must have been created according to the tbook DTD and converts it to a LaTeX file. This LaTeX file can be processed via 'plain' LaTeX or pdfLaTeX. For the latter case, a PDF with proper hyperlinks is produced.


This option makes sense only if you also use tbtohtml, because some batch scripts generated by tbtolatex are also used for tbtohtml. It denotes not to create XHTML, but HTML 4 files. This implies some simplifications in the CSS layout, a different file extension (.html), and other minor adjustments.


name of the XML file to be processed. It must be given without its `.xml' extension.


name of an XSLT parameter that is passed to the XSLT processor, see below.


new value you want to assign to the XSLT parameter, see below. It mustn't be an empty string.

The output file has the same name as filename but the extension `.tex'.

Note that tbtolatex may depend on the output of other programs, namely the 'make??' files that are created in the current directory by tbtolatex itself. They are responsible for graphics, bibliography, etc.

XSLT Parameters

Only the more important ones are listed. For a complete list, see tbookman.pdf

adr-filename (default: 'adrbook.xml')

filename of the address book file

anti-aliasing (default: 'true')

default is 'false' for OS/2. With 'true', graphics for HTML output are smoothed. Needs the p?m* programs for the PNM image format.

assume-os (default: 'linux')

assumed operating system. Possible values are linux, unix, windows and os2.

create-image-comments (default: current value of anti-aliasing)

if 'true', in all HTML images copyright notices are inserted. In PNGs even image description data. Needs active smoothing, because the p?m* tools are used.

css-file (default: '')

filename of a CSS file (XML format)

css-mode (default: 'careful')

If 'standard', non-simplified CSS are created. On the other hand, 'very-careful' makes very much simplified CSS for ancient browsers like Netscape4.

cp (default: 'cp -f')

Shell command for file copying.

debug (default: 'false')

If 'true', you see all LaTeX messages.

desperate-measures (default: false)

if true, ``desperate measures'' are applied, see tbookdtd.dtx.

docbook-equations (default: 'text')

If 'mathml', DocBook XML+MathML is created.

document-fontsize (default: '10pt')

global font size. 10pt, 11pt or 12pt.

equation-resolution (default: value of html-resolution)

Dpi resolution of the bitmap equations.

dvips-offset (default: 0pt,0pt)

Dvips offset for the gallery processes.

graphics-fontsize (default: 'default')

font size assumed for all graphics. Default means ``same of document''. 10pt, 11pt or 12pt. See ``basefontsize'' in tbookman.

gs (default: 'gs')

How to invoke Ghostscript.

html-equations (default: 'mathml')

With 'bitmaps' all formulae become bitmaps for HTML.

html-extension (default: '.xhtml')

Assumed file extension for the HTML file.

html-resolution (default: 100)

dpi resolution for HTML graphics. You can also use it for global HTML image scaling.

include-image-dimensions (default: current value of anti-aliasing)

'true' or 'false'. With 'true', all dimensions of included graphics are written into the HTML output for faster display. Only with active smoothing.

include-originals (default: 'true')

If 'true', you can click on bitmaps in HTML and get a view of the original JPEG.

jpeg-quality (default: 75)

JPEG quality of the HTML output in the usual JPEG unit between 0 and 100.

latex-quiet-option (default: '-interaction=batchmode')

How to keep TeX calm.

maximal-alt-length (default: 50)

maximal number of characters in the alt attribute popup rectangle in HTML, if you are over the image with the mouse.

mkdir (default: 'mkdir -p')

Shell command for creating a sub directory.

mv (default: 'mv -f')

Shell command for file renaming.

preview-latex (default: 'false')

'true' makes the equation bitmaps generating process much faster. But it needs the `preview' package and more disk space.

rm (default: 'rm -f')

default is del for Windows & OS/2. File deletion command.

shift-equations (default: 'true')

Should bitmap equations have a corrected baseline? ('false' necessary for Netscape 4.77).

split-level (default: 'none')

If 'chapter', the HTML file is divided into file chunks for every chapter.

sty-file (default: 'tbook-pl')

filename of a LaTeX style file, '(none)' for don't use any

transparent-pngs (default: 'false')

Should all white in PNGs become transparent? (Also applies to equation bitmaps.)

two-columns (default: 'false')

If 'true', the document is set with two columns.

See Also

tbtohtml(1), tbtodocbk(1), tbprepare(1), tbook(7), tbook homepage.


Written by Torsten Bronger

Reporting Bugs

Please report bugs on tbook's homepage at Sourceforge: http://tbookdtd.sourceforge.net


Copyright 2002 Torsten Bronger

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.