From ffa46293a72182f0d40d9ba69418e2bdcd87d33a Mon Sep 17 00:00:00 2001 From: Mauritz Jeanson Date: Sat, 17 Nov 2007 14:33:59 +0000 Subject: [PATCH] Removed obsolete paragraph saying that profiling stylesheets are needed for HTML Help, JavaHelp, or Eclipse. Added info about the warning message that is output if the stylesheets are unable to add @xml:base. Changed Saxon 8 to Saxon 9. --- docbook/relaxng/docbook/howto/howto.xml | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/docbook/relaxng/docbook/howto/howto.xml b/docbook/relaxng/docbook/howto/howto.xml index 1e9ed7aea..5d4d24de3 100644 --- a/docbook/relaxng/docbook/howto/howto.xml +++ b/docbook/relaxng/docbook/howto/howto.xml @@ -577,7 +577,8 @@ with some limitations. You can process DocBook V5.0 documents with the DocBook XSL stylesheets exactly the same way as you process DocBook V4.x documents. You do not need special software, you can stick to your preferred -XSLT processor, be it Saxon, xsltproc, Xalan or whatever else. +XSLT processor, be it Saxon, xsltproc, Xalan or whatever else (but see +the note about the lost base URI below). During document processing, the stylesheets strip namespaces from DocBook V5.0 to get a document which will be @@ -604,13 +605,13 @@ features. The unsupported features include: During namespace stripping, the base URI of the document is lost. This means that in rare situations, relatively referenced resources like images or programlistings can be processed incorrectly. -The stylesheets attempt to compensate for this problem, but it is -possible that there are corner cases where they will fail. +The stylesheets attempt to compensate for this problem, but that is not always +possible. When an XSLT processor other than Saxon or Xalan is used, a warning +message is generated: + +WARNING: cannot add @xml:base to node set root element. Relative paths may not work. + -If you want to use HTML Help, JavaHelp or Eclipse stylesheets -with DocBook V5.0 you have to use profiling variants of those -stylesheets (their name is starting with -profile-). @@ -665,16 +666,16 @@ have, there's no specific schedule. But, if you want to try the new stylesheets, grab a snapshot of the development version from -and unpack it somewhere. Then download and install Saxon 8 from . To transform a DocBook V5.0 document to a single HTML page use the command: -java -jar /path/to/saxon8.jar -o output.html document.xml /path/to/docbook-xsl2-snapshot/html/docbook.xsl +java -jar /path/to/saxon9.jar -o output.html document.xml /path/to/docbook-xsl2-snapshot/html/docbook.xsl To transform a DocBook V5.0 document to a set of chunked HTML pages use the command: -java -jar /path/to/saxon8.jar document.xml /path/to/docbook-xsl2-snapshot/html/chunk.xsl +java -jar /path/to/saxon9.jar document.xml /path/to/docbook-xsl2-snapshot/html/chunk.xsl -- 2.50.1