7. Website customization

Remember that Website is a tailored version of Docbook. Docbook styling can be customized in various ways. In addition, being Docbook, a good deal of basic customization is available using Docbook customization. This section explains the basics and provides references to web resources where more can be found out.

The Website site offers some examples of customization

Example 16 shows a basic customization layer that does two items of customization. The purpose is to import the main Website stylesheet, and little more. What it does show is the place where customization takes place

Example 16. A basic customization layer

<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
 xmlns:html='http://www.w3.org/1999/xhtml'
                version="1.0">
  <xsl:import href="/sgml/docbook/website/xsl/chunk-website.xsl"/> 1
  <xsl:output method="html"/>

<!-- Insert a rule after the header on each page -->   2
<xsl:param name="header.hr" select="1"/>

<!-- Insert a rule before the footer on each page -->   3
<xsl:param name="footer.hr" select="1"/>

</xsl:stylesheet>

1

Import the main Website stylesheet

2

Add a rule after headers

3

And add one before footers


This example provides a minimal customization. For further information on more general Docbook customization see Bobs book which is far more complete.

For those into XSLT, take a look at the param.xsl file in the Website distribution.