The <xsltPackages> element
The xsltPackages
element contains zero or more package
elements, each of which defines an XSLT 3.0 package, or a version
of a package. The packages may be listed in any order.
Each package
element may have the following attributes:
Attribute |
Applies to |
Values |
Effect |
|
PE EE |
URI |
The package name. Must match the value in the |
|
PE EE |
string |
The package version. Required. The numeric part of the version number must match the value in the |
|
PE EE |
URI |
The original package name. Required only if the package name defined in the |
|
PE EE |
Relative URI |
The location (relative to the configuration file) of a representation of this package in SEF (stylesheet export format) form.
If this attribute is present then the SEF form will always be used in preference to the source form; the |
|
PE EE |
integer |
Used when there are several versions of a package available and the client does not specify which version to use. The value must be an integer. Versions with higher priority are preferred over versions with lower priority or unspecified priority; if the priorities are equal (or unspecified) then the highest available version is used. The rules for ordering of version numbers are given in section §3.5.1 of the W3C specification. |
|
PE EE |
string |
Any convenient short name for the package name/version combination. This can be used for convenience
as the value of the |
|
PE EE |
Relative URI |
The location (relative to the configuration file) of the source XSLT code of the top-level module of the package. |
The package
element may also have zero or more withParam
children supplying values of static stylesheet parameters
to be used during package compilation. If it is necessary to have different
sets of parameter bindings for a package in the same configuration, this should be achieved by use of different versions, for example "1.0-streamable"
versus "1.0-nonstreamable".
Each withParam
element must have the following attributes:
Attribute |
Applies to |
Values |
Effect |
|
PE EE |
EQName |
The parameter name. |
|
PE EE |
XPath expression |
An XPath expression that is evaluated to give the value of the parameter (so a boolean parameter might be written
|
The list of packages in the configuration file is used:
- When running XSLT from the command line, to resolve any packages used in
xsl:use-package
declarations. - When compiling an XSLT package using the s9api
XsltCompiler
, to resolve any packages used inxsl:use-package
declarations, unless they have already been compiled and imported explicitly using the sameXsltCompiler
.