Customization of the DocBook XSL Stylesheets for the TCC |  |
Customization of the DocBook XSL Stylesheets for the TCC | |
One of the great benefits of the DocBook XSL Stylesheets is their modularity. If you don't like a style, you can start your own customization layer that makes changes to someone else's style, leaving intact the parts you don't want to change. The TCC standard style is a customization layer built on top of the stock, uncustomized DocBook XSL Stylesheets.
Specifically, you can do any of these things:
If you are writing TCC documentation, follow the procedures in Writing documentation with DocBook-XML 4.2.
If you don't like some parts of the TCC style, you can add your customization layer on top of the TCC's customization layer. The top-level TCC templates live in this directory:
/u/www/docs/tcc/doc/docbook42xep/ |
The root HTML customization file is named tcc_html.xsl and the root PDF file is named tcc_fo.xsl.
If you don't want any part of the TCC's style, you can build your own customization layer on top of the DocBook XSL Stylesheets. The stock stylesheets live in this directory:
/u/www/docs/tcc/doc/docbook42xep/mss/ |
The procedure for building a customization layer is well-described on p. 102 of Stayton. Briefly:
Create a file whose name ends in .xsl to hold your customization layer, and set up your Makefile or other procedures to use this file as input to xsltproc.
In this file, use xsl:import to read the layer you are building yours on—the TCC stylesheets or the stock DocBook XSL Stylesheets.
Write templates to replace the parts of the layer under you that you don't like.