From: Michael Smith Date: Fri, 28 Jun 2002 10:28:48 +0000 (+0000) Subject: updates: use.extensions parameter name, saxon versions, fixed hyperlinks X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=9668fa84581e625eb58b7fb4cb48ccd0c0c42f51;p=docbook-dsssl updates: use.extensions parameter name, saxon versions, fixed hyperlinks --- diff --git a/xsl/docsrc/extensions.xml b/xsl/docsrc/extensions.xml index beb104492..7e32510b3 100644 --- a/xsl/docsrc/extensions.xml +++ b/xsl/docsrc/extensions.xml @@ -2,11 +2,38 @@ Extensions -Extensions are supported in recent releases of Saxon and Xalan. - -These extensions enable callouts, numbered program listings, and -the direct inclusion of text: - + The DocBook XSL Stylesheets distribution includes a set of + DocBook-specific XSLT extensions (currently implemented in Java) + for performing a variety of functions that would be impractical to + implement with standard XSLT only: + + + embed callouts in verbatim environments (program + listings, for example) + + + add line numbers to verbatim environments (program + listings, for example) + + + adjust the width of table columns in HTML output to + match specs in the CALS table source + + + directly include contents of a text file in rendered + output + + + determine the intrinsic size of an image + + + + + The line numbers and callouts in the following example are + made possible through the use of the DocBook XSLT extention + functions. + + A program listing with line numbering and callouts @@ -71,68 +98,69 @@ both a line and a column.) + +
-Saxon Extensions - -The DocBook XSL Stylesheets include a set of Java extensions for -Saxon. - -
Installation - -The extensions are included in the distribution in -extensions/saxon642.jar and -extensions/saxon643.jar. Use the former for Saxon -version 6.4.2 and the latter for Saxon 6.4.3 or Saxon 6.4.4. Saxon -version 6.4.1 and all prior releases contained a significant bug, they -are not supported. - -Just make sure that the right jar file is in your CLASSPATH when -you run Saxon. - -
- -
Using the Extensions - -For compatibility with other processors, the extensions are disabled -by default. To enable the extensions, turn on -$saxon.extensions, for example by passing -saxon.extensions=1 to Saxon. - -For more control over the specific extensions, see -. -
-
- -
-Xalan Extensions - -The DocBook XSL Stylesheets include a set of Java extensions for -XalanJ version 2. Extensions are not provided for XalanC at this time. - -
Installation - -The extensions are included in the distribution in -extensions/xalan2.jar. -Xalan 1 is not supported. - -Just make sure that the jar file is in your CLASSPATH when -you run Xalan. - -
- -
Using the Extensions - -For compatibility with other processors, the extensions are disabled -by default. To enable the extensions, turn on -$xalan.extensions, for example by passing --PARAM xalan.extensions 1 to Xalan. - -For more control over the specific extensions, see -. -
-
- - +Using the Extensions + + The extensions are included in the DocBook XSL Stylesheets + distribution in the extensions directory. + + + To use the extensions, you need to: + + Determine which extension jar file (in the extensions)corresponds mostly + closely to the Java XSLT engine you use. + + + Include the name of that jar file in your Java + CLASSPATH. + + + Set the correct XSLT extension + parameters to enable the behavior you need. (For + compatibility with other processors, the extensions are + disabled by default.) + + + + + For example, if you're using Saxon 6.4.4, include the + extensions/saxon644.jar file in your Java + classpath. If you're using Xalan-Java 2, include the + extensions/xalan2.jar file in your + classpath. + + + The DocBook XSLT extensions are not supported for + Xalan-Java 1 or for versions of Saxon prior to 6.4.3. And + because the only current implementation of the extensions is + written in Java, you can't yet use them with xsltproc (which + is a written in C) or with the Xalan-C++. + + + + At a minimum, you'll also need to set the value of the use.extensions + parameter to 1 (instead of the default + 0). + + Enabling the Extensions from the Command Line + To enable the extensions for the command line, you need to + pass the the use.extensions parameter + to your XSLT engine. Here's an example of how to do that with Saxon: + +java com.icl.saxon.StyleSheet filename.xml docbook/html/docbook.xsl use.extensions=1 > output.html + + and here's an example of how to do it with Xalan: + +java org.apache.xalan.xslt.Process -IN filename.xml -XSL docbook/html/docbook.xsl -PARAM use.extensions 1 -OUT output.html + + + + + + \ No newline at end of file