Oxygen XML Author plugin 13.2.0

Transforming Documents | 292• Transformer - This combo box contains all the transformer engines available for applying the stylesheet. These arethe built-in engines and the external engines defined in the user preferences. If you want to change the default selectedengine just select other engine from the drop down list of the combo box. For XSLT/XQuery files only, if no validationscenario is associated, the transformer engine will also be used in validation process, if it has validation support.• Parameters - Opens the dialog for configuring the XSLT parameters. In this dialog you set any global XSLTparameters of the main stylesheet set in the XSL URL field or of the additional stylesheets set with the buttonAdditional XSLT stylesheets. If the XSLT transformer engine is custom defined this dialog cannot be used toconfigure the parameters sent to the custom engine. In this case you can copy all parameters from the dialog usingthe contextual menu actions and edit the custom XSLT engine to include in the command line the necessary parameters.• Append header and footer - Opens a dialog for specifying an URL for a header HTML file added at the beginningof the result of an HTML transformation and a URL for a footer HTML file added at the end of the HTML result ofthe transformation.• Additional XSLT stylesheets - Opens the dialog for adding XSLT stylesheets which are applied on the result of themain stylesheet specified in the XSL URL field. This is useful when a chain of XSLT stylesheets must be appliedto the input XML document.• Extensions - Opens the dialog for configuring the XSLT/XQuery extension jars or classes which define extensionJava functions or extension XSLT elements used in the XSLT/XQuery transformation.•Advanced options - Configure advanced options specific for the Saxon HE / PE / EE engine. They are the sameoptions as the ones set in the user preferences but they are configured as a specific set of transformation options foreach transformation scenario. By default if you do not set a specific value in the transformation scenario each advancedoption has the same value as the global option with the same name set in the user preferences.The advanced options include two options that are not available globally in the user preferences: the initial XSLTtemplate and the initial XSLT mode of the transformation. They are Saxon specific options that allow imposing thename of the first XSLT template that starts the XSLT transformation or the initial mode of transformation.The advanced options specific for Saxon HE / PE / EE are:• Mode ("-im") - Specifies to the transformer the initial template mode• Template ("-it") - Specifies the name of the initial template to the transformer. When specified, the XML inputURL for the transformation scenario is optional.• Use a configuration file ("-config") - The URL input points to a Saxon advanced options configuration file.• Version warnings ("-versmsg") - Warns you when the transformation is applied to an XSLT 1.0 stylesheet.• Line numbering ("-l") - Error line number is included in the output messages.• Debugger trace into XPath expressions (applies to debugging sessions) - Instructs the XSLT Debugger to stepinto XPath expressions.• DTD validation of the source ("-dtd") - The following options are available:• On, requests DTD-based validation of the source file and of any files read using the document() function;• Off (default setting) suppresses DTD validation.• Recover, performs DTD validation but treats the errors as non-fatal.Note that any external DTD is likely to be read even if not used for validation, because DTDs can contain definitionsof entities.• Recoverable errors ("-warnings") - Policy for handling recoverable errors in the stylesheet: Allows you to choosehow dynamic errors are handled. One of the following options can be selected:• Recover silently ("silent") ;• Recover with warnings ("recover") - default setting;• Signal the error and do not attempt recovery ("fatal").• Strip whitespaces ("-strip") - Strip whitespaces feature can be one of the following three options:• All ("all") - Strips all whitespace text nodes from source documents before any further processing, regardlessof any xsl:strip-space declarations in the stylesheet, or any xml:space attributes in the source document.