For each of the formats used by the framework, a stylesheet driver
file exists in the DocBook Framework in src/styles
.
These files are pdf.xsl
, html.xsl
and htmlsingle.xsl
.
The driver files are intended to reference the actual style sheet customization and to add some framework specific elements through filtering. This two step process has been chosen because html and htmlsingle are very similar and it makes no sense to maintain two sets of stylesheet customizations that are virtually identical.
Before usage, these files are copied to
target/tmp
using an ant filter set. This allows you
to use the following replacements in the driver files:
Table 4.1. ant filter tokens in the stylesheet customization files
Filter token | Default Value | Token function | ||
---|---|---|---|---|
@file.prefix@ |
| Prefix for loading a file through the XSL processor. | ||
@docbook.xml@ | (computed at runtime) | Location of the DocBook XML files | ||
@docbook.xsl@ | (computed at runtime) | Location of the DocBook XSL style sheets | ||
@src.dir@ | ${basedir}/src | Location of the source files (DocBook, Images etc.) | ||
@tmp.dir@ | ${basedir}/target/tmp | Directory for temporary (scratch) files | ||
@<type>.target.dir@ (type is pdf for PDF, html for multi-page HTML and htmlsingle for single-page HTML) | (computed at runtime) | Points to the target directory into which the document is rendered |
Please refer to the provided driver files in
src/styles
in the DocBook Framework on how to use the
filter set.