One can configure transformation engines other than the ones which come with the <oXygen/> distribution. Such an external engine can be used for XSLT / XQuery transformations within <oXygen/>, in the Editor perspective, and is available in the list of engines in the dialog for editing transformation scenarios.
The Custom Engines preferences panel is opened from menu → → +XML+XSLT/FO/XQuery+Custom Engines
The following parameters can be configured for a custom engine:
- Engine type
Combo box allowing you to choose the transformer type. There are two options: XSLT engines and XQuery engines.
- Name
The name of the transformer displayed in the dialog for editing transformation scenarios
- Description
Text description of the transformer
- Output Encoding
The encoding of the characters sent to the output stream of the transformer
- Error Encoding
The encoding of the characters sent to the error stream of the transformer
- Working directory
The start directory of the transformer executable program. The following editor variables are available for making the path to the working directory independent of the input XML file:
${homeDir}- the user home directory in the operating system${cfd}- the path to the directory of the current file${pd}- the path to the directory of the current project${pn}- the name of the current project${oxygenInstallDir}- the <oXygen/> install directory
- Command line
The command line that must be executed by <oXygen/> to perform a transformation with the engine. The following editor variables are available for making the items of the command line (the transformer executable, the input files) independent of the input XML file:
${xml}- the XML input document as a file path${xmlu}- the XML input document as a URL${xsl}- the XSL / XQuery input document as a file path${xslu}- the XSL / XQuery input document as a URL${out}- the output document as a file path${outu}- the output document as a URL