Home
Publishing
Details about transformation scenarios and customizing various types of output
Transformation Scenarios
Creating New Transformation Scenarios
Ant Transformation
This type of transformation allows you to configure the options and parameters of an Ant build script.

Introduction
Welcome to the User Manual of Oxygen XML Editor Eclipse plugin 26.1
Getting Started
Information and resources to help you get started using Oxygen XML Editor Eclipse plugin as quickly as possible
Installation
The requirements and installation instructions for each platform
Configuration
Description of all of the options that allow you to configure Oxygen XML Editor Eclipse plugin
Perspectives
The Editor, XSLT Debugger, XQuery Debugger, and Database perspectives
Editing Modes
The Text, Grid, Author, and Schema Design editing modes
Working With Documents
General information about features available when working with documents
Editing Supported Document Types
Details about the various types of supported documents and their unique editing features
Built-in Frameworks (Document Types)
The editing frameworks that are supported in Oxygen XML Editor Eclipse plugin
Additional XML Editing Frameworks (Document Types)
The custom frameworks that are supported in Oxygen XML Editor Eclipse plugin
Publishing
Details about transformation scenarios and customizing various types of output
- Transformation Scenarios
  - Built-in Transformation Scenarios
  - Creating New Transformation Scenarios
    - XML Transformation with XSLT
      This type of transformation specifies the transformation parameters and location of an XSLT stylesheet that is applied to the edited XML document. This scenario is useful when you develop an XML document and the XSLT document is in its final form.
    - XML Transformation with XQuery
      This type of transformation specifies the transform parameters and location of an XQuery file that is applied to the edited XML document.
    - XML to PDF Transformation with CSS
      This type of transformation uses the Oxygen PDF Chemistry processing engine to obtain PDF output by applying CSS styling to the edited XML document. This scenario is useful for those who are familiar with CSS and want to obtain PDF output as its final form.
    - DITA-OT Transformation
      This type of transformation specifies the parameters for an Ant transformation that executes a DITA-OT build script. Oxygen XML Editor Eclipse plugin includes a built-in version of Ant and a built-in version of DITA-OT, but other versions can be set in the scenario.
    - Ant Transformation
      This type of transformation allows you to configure the options and parameters of an Ant build script.
    - JSON Transformation with XSLT
      This type of transformation specifies the transformation parameters and location of an XSLT stylesheet that is applied to the edited JSON document. This scenario is useful when you develop a JSON document and the XSLT document is in its final form.
    - XSLT Transformation on XML
      This type of transformation specifies the parameters and location of an XML document that the edited XSLT stylesheet is applied on. This scenario is useful when you develop an XSLT document and the XML document is in its final form.
    - XSLT Transformation on JSON
      This type of transformation specifies the parameters and location of a JSON document that the edited XSLT stylesheet is applied on. This scenario is useful when you develop an XSLT document and the JSON document is in its final form.
    - XProc Transformation
      This type of transformation specifies the parameters and location of an XProc script.
    - XQuery Transformation
      This type of transformation specifies the parameters and location of an XML source that the edited XQuery file is applied on.
    - SQL Transformation
      This type of transformation specifies a database connection for the database server that runs the SQL file associated with the scenario. The data processed by the SQL script is located in the database.
  - Editing a Transformation Scenario
  - Duplicating a Transformation Scenario
  - Applying Associated Transformation Scenarios
  - Configure Transformation Scenario(s) Dialog Box
  - Batch Transformations
  - Sharing Transformation Scenarios
  - Transformation Scenarios View
- WebHelp Output Customization
- DITA to PDF Output Customization
- DocBook to PDF Output Customization
Working with XPath Expressions
Information about using XPath Expressions in Oxygen XML Editor Eclipse plugin
Working with Archives
Describes how to use the Archive Browser to work with various type of archives
Databases and SharePoint
Connecting to supported databases and integrating Oxygen XML Editor Eclipse plugin with SharePoint
Importing Data
Information about how to import data from external sources into XML documents
XSLT/XQuery Debugging
The debugging interface that detects problems with XSLT and XQuery transformations
Framework and Author Mode Customization
Tutorials and details about customizing frameworks and the visual Author editing mode
Extension Points for the Oxygen Eclipse Plugin
A list of extension points available for the Oxygen Eclipse plugin
Tools
Specifics about the various tools that are included in Oxygen XML Editor Eclipse plugin
Troubleshooting
A compilation of common problems and their solutions
DITA Authoring
A guide to help content authors who create and publish DITA content
Scripting Oxygen
Details about the scripting possibilities that are available with Oxygen XML Editor Eclipse plugin
Glossary
Copyright
Legal information

Ant Transformation

This type of transformation allows you to configure the options and parameters of an Ant build script.

An Ant transformation scenario is usually associated with an Ant build script. Oxygen XML Editor Eclipse plugin runs an Ant transformation scenario as an external process that executes the Ant build script with the built-in Ant distribution (Apache Ant version 1.9.8) that is included with the application, or optionally with a custom Ant distribution configured in the scenario.

Tip: Certain Ant tasks require additional JAR libraries (for example, Ant mail tasks). The additional libraries can be added by editing the Ant transformation scenario, and in the Output tab, click the Libraries button in the bottom right corner. This opens a dialog box where you can add JAR libraries. For a list of library dependencies, see https://ant.apache.org/manual/install.html#librarydependencies.

To create an Ant transformation scenario, use one of the following methods:

Use the Configure Transformation Scenario(s) (Alt + Shift + T, C (Command + Option + T, C on macOS)) action from the toolbar or the XML menu. Then click the New button and select ANT transformation.
Go to Window > Show View and select Transformation Scenarios to display this view. Click the New Scenario drop-down menu button and select ANT transformation.

Both methods open the transformation configuration dialog box.

The upper part of the dialog box allows you to specify the Name of the transformation scenario.

The lower part of the dialog box contains several tabs that allow you to configure the options that control the transformation.