The External Tools preferences panel is opened from menu .
A command-line tool can be started from the External Tools toolbar in
the Oxygen 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 to
read the output of the tool.
- Output content type - A list of predefined content type formats
that instruct Oxygen 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 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 to user home directory.
- ${cfd} - The path of current file directory.
- ${pd} - The project directory.
- ${oxygenInstallDir} - The Oxygen installation
directory.
- 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 to the user home directory.
- ${cfn} - The current file name without extension.
- ${cfne} - The current file name with extension.
- ${cf} - The path of the currently edited file.
- ${cfd} - The path of the current file directory.
- ${tsf} - The transformation result file.
- ${pd} - The project directory.
- ${oxygenInstallDir} - The installation directory of the
application.
- ${frameworksDir} - The directory where the Oxygen frameworks are
located.
- ${ps} - The path separator which can be used on different
operating systems between libraries specified in the class path.
- ${timeStamp} - The current time stamp in Unix format which can
be used for example to save transformation results in different output files on each
transform.