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= atttribute of the xsl:template element.
  • in specified mode (-im) - The value of the mode= atttribute 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.

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 soucre 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 soucre 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

 
Free Stylus Studio XML Training:
W3C Member