In general, to produce a local customization of the DocBook-XSL Stylesheets,
we need only write an XSLT file (with file extension
.xsl) that imports the DocBook-XSL Stylesheets
and then adds local customizations.
However, there is another significant complication.
Customizing the title page format for either HTML or FO
output is a two-stage process. First, one must create an
XML template file that describes the format of the title
page. Then, one runs it through xsltproc using a special
stylesheet, template/titlepage.xsl in the DocBook-XSL Stylesheets, that converts it
into an XSL file, which is the part of the local
customization layer that describes the title page layout.
Here, we are using an XSL file to transform an XML file
into XSL.
Our title customization files are called html-titlepage.xml and
fo-titlepage.xml for the HTML and FO versions, respectively. The
transformed files are html-titlepage.xsl and fo-titlepage.xsl. These
transformed files are referenced by the base stylesheets.
These are the principal components of the TCC's local
customization layer for the Modular Stylesheets. All file
references are relative to the root of our current customization
layer, which is currently at /u/www/docs/tcc/doc/docbook43/ on infohost.
The tcc_html.xsl file is the root customization file for
producing HTML output. See Section 7, “tcc_html.xsl: HTML
customization layer”.
The html-titlepage.xml file describes the HTML title page
format. It is transformed by the template/titlepage.xsl file
to produce the html-titlepage.xsl file that actually generates
the HTML title page. See Section 8, “html-titlepage.xml:
HTML title page template”.
The tcc_fo.xsl file is the root customization file for
producing PDF output. See Section 10, “tcc_fo.xsl: PDF customization
layer”.
The fo-titlepage.xml file describes the PDF title page
format. It is transformed by template/titlepage.xsl to produce
the fo-titlepage.xsl file that generates the PDF title page.
See Section 11, “fo-titlepage.xml: PDF title
page template”.