Extensions for Saxon and Xalan

The DocBook Saxon Extensions and DocBook Xalan Extensions are sets of DocBook-specific XSLT 1.0 extensions created by NormanWalsh for performing a variety of tasks:

The above tasks are either impractical or impossible to implement with standard XSLT 1.0 only.

The extensions are written in Java and they can be used with Saxon and Xalan-Java. For specific how-to instructions on using them, see the DocBook Saxon extensions and DocBook Xalan extensions sections in DocBook XSL: The Complete Guide.

Basically, to use the extensions, you need to:

  1. determine which extension jar file (in the extensions directory in the DocBookXslStylesheets distribution) corresponds most closely to the Java XSLT engine you use

  2. include the name of that jar file in your Java classpath
  3. set the correct XSLT extension parameters to enable the behavior you need. Here is documentation for the parameters for HTML output.

For example, if you are using Saxon 6.5.3, include the extensions/saxon65.jar file in your Java classpath, and (at a minimum) set the value of the use.extensions parameter to 1 (instead of the default 0).

Extensions for libxslt

There is no complete set of extensions that will work with the libxslt library (which is written in C and includes the xsltproc command line tool).

Currently, there is one libxslt extension: a Python implementation of a function that adjusts column-widths in CALS tables. See README.LIBXSLT for more information.

DocBookXsltExtensions (last edited 2011-03-17 13:08:39 by NormanWalsh)