Besides the built-in formatting objects processor (Apache FOP) other external processors can
be configured and set in transformation scenarios for processing XSL-FO documents.
Oxygen XML Developer
has implemented an easy
way to add two of the most used commercial FO processors: RenderX XEP and Antenna House XSL
Formatter. You can easily add RenderX XEP as external FO processor if the user has the XEP
installed. Also, if you have the Antenna House XSL Formatter v4 or v5,
Oxygen XML Developer
uses the environmental
variables set by the XSL Formatter installation to detect and use it for XSL-FO
transformations. If the environmental variables are not set for the XSL Formatter
installation, you can browse and choose the executable just as you would for XEP.
The FO Processors preferences panel is opened from menu .
The FO Processors Preferences Panel
Apache FOP
The options for FO processors are the following:
External FO processors
In this section you can manage the external FO processors you want to use in transformation
scenarios. Press the New button to add a new external FO processor.
The following dialog is displayed:
The External FO Processor Configuration Dialog
- Name - The name displayed in the list of available FOP processors
on the FOP tab of the transformation scenario dialog.
- Description - A textual description of the FO processor displayed
in the FO processors table and in tooltips of UI components where the processor is
selected.
- Output Encoding - The encoding of the FO processor output stream
displayed in a results panel at the bottom of the
Oxygen XML Developer
window.
- Error Encoding - The encoding of the FO processor error stream
displayed in a results panel at the bottom of the
Oxygen XML Developer
window.
- Working directory - The directory where the intermediate and
final results of the processing is stored. Here you can use one of the following editor variables:
- ${homeDir} - The path to user home directory.
- ${cfd} - The path of current file directory. If the current
file is not a local file, the target is the user's desktop directory.
- ${pd} - The project directory.
- ${oxygenInstallDir} - The
Oxygen XML Developer
installation
directory.
- Command line - The command line that starts the FO processor,
specific to each processor. Here you can use one of the following editor variables:
- ${method} - The FOP transformation method:
pdf, ps or
txt.
- ${fo} - The input FO file.
- ${out} - The output file.
- ${pd} - The project directory.
- ${frameworksDir} - The path of the
frameworks subdirectory of the
Oxygen XML Developer
install
directory.
- ${oxygenInstallDir} - The
Oxygen XML Developer
installation
directory.
- ${ps} - The platform-specific path separator. It is used
between the library files specified in the class path of the command line.