The External Tools preferences panel is opened from menu .
A command-line tool can be started from the External Tools toolbar in
the
Oxygen XML Author
user interface as if from
the command line of the operating system shell. Such a tool must be configured first in this
preferences panel. The parameters of an external tool are set in the following dialog:
The External Tools Configuration Dialog
- Name - The name of the menu entry corresponding to this tool that
will be displayed in the menu and in the External Tools toolbar.
- Description - The description of the tool displayed as tooltip
where the tool name is used.
- Output Encoding - The encoding of the output stream of the external
tool that will be used by
Oxygen XML Author
to
read the output of the tool.
- Output content type - A list of predefined content type formats
that instruct
Oxygen XML Author
how to display
the generated output. For example, setting the Output content type to
text/xml enables the syntax coloring of XML output.
- Error Encoding - The encoding of the error stream of the external
tool that will be used by
Oxygen XML Author
to
read this error stream.
- Shortcut key - The keyboard shortcut that launches the external
tool.
- Working directory - The directory the external tool will use to
store intermediate and final results. Here you can use one of the following editor variables:
- ${homeDir} - The path (as file path) of the user
home folder.
- ${cfd} - Current file folder as file path, that is
the path of the current edited document up to the name of the parent folder.
- ${pd} - Current project folder as file path.
- ${oxygenInstallDir} -
Oxygen XML Author
installation folder as
file path.
- Command line - The command line that will start the external tool.
Here you can use one of the following editor variables:
- ${dbgXML} - The path to the current Debugger
source selection (for tools started from the XSLT/XQuery Debugger).
- ${dbgXSL} - The path to the current Debugger
stylesheet selection (for tools started from the XSLT/XQuery Debugger).
- ${homeDir} - The path (as file path) of the user
home folder.
- ${cfd} - Current file folder as file path, that is
the path of the current edited document up to the name of the parent folder.
- ${cfn} - Current file name without extension and
without parent folder.
- ${cfne} - Current file name with extension.
- ${cf} - Current file as file path, that is the
absolute file path of the current edited document.
- ${tsf} - The transformation result file.
- ${pd} - Current project folder as file path.
- ${oxygenInstallDir} -
Oxygen XML Author
installation folder as
file path.
- ${frameworksDir} - The path (as file path)
of the frameworks subfolder of the
Oxygen XML Author
installation folder.
- ${ps} - The path separator which can be used on
different operating systems between libraries specified in the class path.
- ${timeStamp} - Time stamp, that is the current
time in Unix format. It can be used for example to save transformation results in different
output files on each transform.