DocBook to LaTeX Publishing

User Manual

Benoît Guillon

Reviewed by : Andreas Hoenen

v0.3.3

Revision History
Revision 012009/05/05B. Guillon

The manual does not include the change history anymore. The change history is now in the release note. The XSL Parameters are now described as reference entries.

Revision 022009/06/21B. Guillon

Add a section about the new set support, and a section about how to extend the verbatim rendering.

Revision 032011/07/03B. Guillon

Add a section about the new HTML table support, and a section about the PyPI distribution.


Table of Contents

Documentation
1. Introduction
What about DB2LaTeX?
Features
Version
Change History
Publishing Principles
Backend Drivers
XSL Stylesheets
Python Post Processing
LaTeX Style Package
2. Installing the Package
Content
Installing on Unix like Systems
Dblatex Packages
Dependencies
Installation
Installing on Windows
Dependencies
Installation
3. Using dblatex
Reference
dblatex — convert DocBook to LaTeX, DVI, PostScript, and PDF
Output Formatting Style
How it works
Adding a New Formatting Style
Publishing Outputs
Publishing a single document
Publishing a Set of Books
Global Page Setup
Figure Inclusion
Presentation
Converting on the fly
Paths Lookup
Creating Tables
Limitations
Table Width
Tables without colwidth
Tables with mixed colspec
Tables with proportional and fixed colwidth
Tables with fixed colwidths
Automatic Column Width
Informal Table LaTeX Styles
Tables with morerows
Landscape tables
Smaller tables
Coloured tables
HTML Tables
Writing Mathematics
Writing LaTeX Mathematical Equations
Writing MathML equations
Extending the Verbatim Rendering
Dblatex Specific Options
Formatting embedded elements
Creating a new Verbatim Environment
Creating an Index
Writing a Bibliography
Using Bibliography Entries
Using BibTeX Databases
Natbib Citations
Document Revisions
Locale Support
Document Encoding
Babel Languages
CJK Languages
Mixing the languages
Using XRefsyle and Olinks
Specific xrefstyle for ulink
4. Customization
Using XSL Parameters
Setting Command line Parameters
XSL User Stylesheet
Changing the XSL parameter values
Overriding some templates
Customized LaTeX style
Reusing an existing LaTeX style
Package options
Needed packages
DocBook interface
Debugging your Style
Latex post process script
Post latex compilations
Dblatex Configuration File
Configuration File Format
Configuration Paths
Customization Precedence
5. FAQ
6. Thanks
Sponsors
Contributors
Pioners
A. Dblatex XSL Parameter Reference
Admonitions
figure.caution — Figure to use to render a caution block.
figure.important — Figure to use to render a important block
figure.note — Figure to use to render a note block
figure.tip — Figure to use to render a tip block
figure.warning — Figure to use to render a warning block
Callouts
callout.linkends.hot — Hot links callout items
calloutlist.style — Callout list style to apply
callout.markup.circled — Use black circles for numbering the callout items?
co.linkends.show — Show the references to calloutlist items next to the markup
imageobjectco.hide — Hide the callout markups on the image
ToC/LoT/Index Generation
doc.lot.show — Specifies the Lists of Titles to display
doc.toc.show — Print the Table Of Contents
titleabbrev.in.toc — Should titleabbrev be put in the TOC instead of title?
toc.section.depth — How deep should recursive sections appear in the TOC?
bibliography.tocdepth — How bibliography section and subsections appear in TOC
colophon.tocdepth — How colophon section and subsections appear in TOC
dedication.tocdepth — How dedication section and subsections appear in TOC
preface.tocdepth — How preface section and subsections appear in TOC
glossary.tocdepth — How glossary section and subsections appear in TOC
index.tocdepth — How index section and subsections appear in TOC
refentry.tocdepth — How refentry section and subsections appear in TOC
Processor Extensions
alt.use — Always use alt to display equations
tex.math.in.alt — TeX notation used for equations
Automatic labelling
bibliography.numbered — Should bibliography headings be numbered?
glossary.numbered — Should glossary headings be numbered?
index.numbered — Should index headings be numbered?
refentry.numbered — Should refentry headings be numbered?
Meta/*Info
doc.pdfcreator.show — Set the PDF metadata Creator field
make.single.year.ranges — Print single-year ranges (e.g., 1998-1999)
make.year.ranges — Collate copyright years into ranges?
Reference Pages
funcsynopsis.decoration — Decorate elements of a funcsynopsis?
funcsynopsis.style — What style of funcsynopsis should be generated?
function.parens — Generate parens after a function?
refclass.suppress — Suppress display of refclass contents?
refentry.generate.name — Output NAME header before refnames?
refentry.xref.manvolnum — Output manvolnum as part of refentry cross-reference?
Tables
newtbl.autowidth — Table column widths sized by latex
newtbl.bgcolor.thead — Background color of the thead rows
newtbl.default.colsep — By default draw a vertical line between columns
newtbl.default.rowsep — By default draw a horizontal line between rows
newtbl.format.tbody — LaTeX formatting for body table cells
newtbl.format.tfoot — LaTeX formatting for foot table cells
newtbl.format.thead — LaTeX formatting for head table cells
newtbl.use.hhline — Draw the horizontal lines with the hhline package
table.default.position — Default table float placement policy
table.default.tabstyle — Default table style to apply
table.in.float — Use or emulate a float to display a formal table?
table.title.top — Title on top of the table float
default.table.rules — The default column and row rules for tables using HTML markup
default.table.width — The default width of tables
Linking
latex.hyperparam — Options/parameters passed to hyperref
Olink Parameters — Parameters to configure Olinks
Cross References
insert.xref.page.number — Turns page numbers in xrefs on and off
xref.hypermarkup — Wrap the entire the xref markups with an hyperlink?
Lists
term.breakline — Put the term description on the next line?
variablelist.term.separator — Text to separate terms within a multi-term varlistentry
QAndASet
qanda.defaultlabel — Sets the default for defaultlabel on QandASet.
Bibliography
biblioentry.item.separator — Text to separate bibliography entries
biblioentry.numbered — Should biblioentry item labels be numbered?
citation.default.style — Default natbib citation style to apply
citation.natbib.options — Specifies the natbib package options
citation.natbib.use — Use natbib to display citations
latex.bibfiles — Defines the default BibTeX database to use
latex.biblio.output — Defines how the BibTeX bibliographic entries are printed out
latex.biblio.style — Default BibTeX style to apply
latex.bibwidelabel — Template of the widest bibliography label
Glossary
glossterm.auto.link — Generate links from glossterm to glossentry automatically?
Miscellaneous
annotation.support — Enable the annotation support
doc.section.depth — Depth of the section numbering
equation.default.position — Default equation float placement to apply
example.default.position — Default example float placement to apply
figure.default.position — Figure float placement policy
figure.title.top — Title on top of the figure float
filename.as.url — Hyphenate a filename like if is was an URL
literal.layout.options — Override the options passed to the listing package
literal.lines.showall — Show the last empty lines in the literal environments?
literal.width.ignore — Ignore the literal environment width attribute
literal.class — Default class to apply to literallayout blocks
literal.role — Default role to apply to verbatim blocks
literal.environment — Latex environment used to format verbatim blocks
literal.extensions — Enable extended verbatim features
linenumbering.scope — Templates on which the global linenumbering setup applies
linenumbering.default — Default linenumbering setup for literal environments
linenumbering.everyNth — Indicate which lines should be numbered
mediaobject.caption.style — Font style of the mediaobject caption text
monoseq.hyphenation — Specifies one of the supported monseq hyphenation policy
monoseq.small — Use a smaller font to render monoseq portions of text
pdf.annot.options — PDF text annotations rendering options
seg.item.separator — Separator to use between several segitems
show.comments — Display remark elements?
texlive.version — Version of the installed Tex Live Distribution
ulink.footnotes — Generate footnotes for ulinks?
ulink.show — Display URLs after ulinks?
xref.with.number.and.title — Use number and title in cross references
Graphics
imagedata.boxed — Put the images into a framed box
imagedata.default.scale — Specifies the default image scaling properties
imagedata.file.check — Make the latex compilation robust to missing images
keep.relative.image.uris — Should image URIs be resolved against xml:base?
Chuncking
set.book.num — Select a single book or all the books to compile from a set
use.id.as.filename — Use ID value of chunk elements as the filename?
Pagination and General Styles
page.height — The height of the physical page
page.margin.bottom — The bottom margin of the page
page.margin.inner — The inner page margin
page.margin.outer — The outer page margin
page.margin.top — The top margin of the page
page.width — The width of the physical page
paper.type — Select the paper type
geometry.options — Raw options to pass to the geometry package
doc.alignment — Specifies the text alignement of the document
doc.collab.show — Print the document collaborators (authors, etc.) in a table
doc.layout — Specifies the overall document layout.
doc.publisher.show — Print the dblatex logo on the cover page?
draft.mode — Select draft mode
draft.watermark — Print a Watermak on each page in draft mode?
latex.engine.options — Extra arguments to pass to the TeX engine
latex.class.article — LaTeX document class to use for article documents
latex.class.book — LaTeX document class to use for book documents
latex.class.options — Options passed to the \documentclass command
latex.encoding — Encoding of the latex document to produce
latex.unicode.use — Use passivetex unicode support?
latex.output.revhistory — Print the revhistory table?
Font Families
cjk.font — Fonts to use in CJK environments
xetex.font — Specifies the fonts that XeTeX must use
Localization
korean.package — Package included when Korean language is used
latex.babel.language — Force the loaded babel language
latex.babel.use — Disable the use of babel, whatever the document language is
Prepress
crop.marks — Output crop marks?
crop.paper.type — Select the paper type for paper with crops
crop.page.width — The width of the physical crop page
crop.page.height — The height of the physical crop page
crop.mode — How to display crops
crop.options — Raw options passed to the crop package

List of Figures

1.1. Transforming Process
3.1. Parameter Lengths used for Page Setup

List of Examples

3.1. Choosing the DB2LaTeX style
3.2. Figure inclusion
3.3. Figure conversion
3.4. Figures lookup
3.5. Equation taken from TDG
3.6. Inlined Equation
3.7. Equation in a block
3.8. Equation in a float
3.9. Equation without a title
3.10. Index Entry
3.11. A Bibliography
3.12. Bibliography using BibTeX databases
4.1. Overriding templates
4.2. Reused LaTeX style
4.3. User Manual Configuration File
4.4. Customization Precedence
A.1. Configuring with latex.hyperparam

List of Equations

3.1. Simple Formula
3.1.