The Advanced Tab

The Advanced tab allows you to specify advanced options for the transformation scenario.

Figure: Advanced Settings Tab

You can specify the following parameters:

• Custom build file - If you use a custom DITA-OT build file, you can specify the path to the customized build file. If empty, the build.xml file from the dita.dir parameter that is configured in the Parameters tab is used. An editor variable can be inserted for the file path by using the Insert Editor Variables button.
• Build target - Optionally, you can specify a build target for the build file. If no target is specified, the default init target is used.
• Additional arguments - You can specify additional command-line arguments to be passed to the Ant transformation (such as -verbose).
• Ant Home - You can choose between the default or custom Ant installation to run the transformation. The default path can be configured in the Ant preferences page.
• Java Home - You can choose between the default or custom Java installation to run the transformation. The default path is the Java installation that is used by Oxygen XML Developer.
  Note: It may be possible that the used Java version is incompatible with the DITA Open Toolkit engine. For example, DITA OT 1.8.5 and older requires Java 1.6 or later, while DITA OT 2.0 and newer requires Java 1.7 or newer. Thus, if you encounter related errors running the publishing, consider installing a Java VM that is supported by the DITA OT publishing engine and using it in the Java Home text field.
• JVM Arguments - This parameter allows you to set specific parameters for the Java Virtual Machine used by Ant. For example, if it is set to -Xmx384m, the transformation process is allowed to use 384 megabytes of memory. When performing a large transformation, you may want to increase the memory allocated to the Java Virtual Machine. This will help avoid Out of Memory error messages (OutOfMemoryError).
• Libraries - By default, Oxygen XML Developer adds (as high priority) libraries that are not transformation-dependent and also patches for certain DITA Open Toolkit bugs. You can use this button to specify additional libraries (jar files or additional class paths) to be used by the Ant transformer.