Home >Online Product Documentation >Table of Contents >Saxon XSLT Settings
Saxon XSLT Settings
|
|
Support for Saxon schema-aware settings is available only in Stylus Studio XML Enterprise Suite.
|
You use the Saxon XSLT Settings dialog box to define settings that will be used by the Saxon processor when executing XSLT in Stylus Studio. These settings are also reflected in generated Java code.
For more information on using the Saxon processor, refer to the Saxon documentation: http://www.saxonica.com/documentation/contents.html.
Fields
Command line equivalents for Saxon XQuery settings are shown in parentheses following the field name where applicable.
Execution mode
Whether you want the Saxon processor to run in basic or schema-aware modes.
Tree model
Performance settings for document processing. Generally speaking, the Tiny Tree setting provides superior performance in most cases. For more information on this topic, see Choosing a Tree Model in the Saxon documentation.
Start Transformation
Allows you to specify the named template and mode in which you wish to start the XSLT transformation.
- by calling named template (-it) - The value of the
name=
attribute of the xsl:template
element. - in specified mode (-im) - The value of the
mode=
attribute of the xsl:template
element.
Support XML 1.1
Whether or not to allow XML 1.1 and XML Namespaces 1.1 constructs. This option must be set if source documents use XML 1.1, or if result documents are to be serialized as XML 1.1.
Suppress warning when running with an XSLT 1.0 stylesheet (-novw)
Suppresses warnings issued when running an XSLT 2.0 processor against an XSLT 1.0 stylesheet.
Recognize Saxon file extensions and query parameters (-p)
Whether or not you want the Saxon processor to recognize Saxon-specific file extensions and query parameters in URIs.
Validate source documents using DTD (-v)
Whether or not you want the source document and any documents referenced using the document()
function to be validated against a DTD.
Treat non-fatal errors as
How you want Stylus Studio to manage non-fatal errors encountered while processing the XSLT stylesheet:
- silent warnings (-w0) - Stylus Studio writes error messages to the Output window, but does not open it automatically. Processing continues.
- warnings (-w) - Stylus Studio writes error messages to the Output window and opens the window automatically. Processing continues.
- fatal errors (-w2) - Stylus Studio writes error messages to the Output window and opens the window automatically. Processing is interrupted.
Whitespace stripping
Whether or not whitespace-only text nodes are stripped from the source document.
- Ignorable (-signorable) - All ignorable whitespace text nodes are stripped from the source documents before any processing, regardless of any
xsl:strip-space
declarations in the stylesheet, or any xml:space
attributes in the source document. Whitespace text nodes are ignorable if they appear in elements defined in the DTD or XML Schema as having element-only content. - All (-sall) - All whitespace text nodes are stripped from the source documents before any processing, regardless of any
xsl:strip-space
declarations in the stylesheet, or any xml:space
attributes in the source document. - None (-snone) - No whitespace is stripped before processing.
Schema-aware Settings
These settings are available only if you are using Saxon-SA to execute your XSLT.
- Source document validation - Whether or not an XML Schema is required to validate the source document. Strict (-val) requires an XML Schema, and the source document must validate against that XML Schema. Lax (-vlax) validates the source document if an XML Schema is provided, and the source document must validate against that XML Schema; but if no XML Schema is provided, the source document passes validation.
- Treat validation errors on result document as warnings (-vw) - Whether or not to treat validation errors in result documents as warnings only.
For More Information
XSLT Processors
Overview of Scenario Features
Creating an XSLT Scenario