The XSL part

The first two sections of the configuration file tell the XSLT processor where to find the DocBook XSL style sheets (these are imported) and which parts of your documents should be marked with annotation anchors.

The most important element is the xsl:import with its href attribute, you tell the XSLT processor the path to your DocBook XSL style sheet. You can choose chunked output here if you want.

Example 3.1. Style sheet configuration

<xsl:import
      href="/usr/local/share/xsl/docbook/html/docbook.xsl"/>

Example 3.2. Style sheet configuration for chunked output

<xsl:import
      href="/usr/local/share/xsl/docbook/html/chunk.xsl"/>

The other thing to be configured is the list of elements that shall be annotatable. To change them, change the value of the match attribute, separating the tag names with a "|" character:

Example 3.3. Configuration of the annotatable elements

<xsl:template match="para|simpara|programlisting|note|important|warning|caution|tip">
  <xsl:apply-imports /> 
  <xsl:call-template name="annotate"/> 
</xsl:template>

Example 3.4. Making only chapters annotatable

<xsl:template match="chapter">
  <xsl:apply-imports />
  <xsl:call-template name="annotate"/>
</xsl:template>