DITA Preferences

To access the DITA Preferences page, open the Preferences dialog box and go to DITA. This preferences page includes the following sections and options:

DITA Open Toolkit Section

This section allows you to specify the default directory of the DITA Open Toolkit distribution (bundled with the Oxygen XML Editor installation) to be used for validating and publishing DITA content. You can select from the following:

Built-in DITA-OT 1.8 - This is the default setting and the default DITA OT directory is: [OXYGEN_DIR]/frameworks/dita/DITA-OT.
Built-in DITA-OT 2.x (with experimental DITA 1.3 support) - All defined DITA transformation scenarios will run with DITA-OT 2.x. This also gives you access to new DITA 1.3 file templates when you create new documents from templates. The default DITA OT directory is: [OXYGEN_DIR]/frameworks/dita/DITA-OT2.x.
Custom - In the Location field, you can either provide a new file path for the specific DITA OT that you want to use or you can select a previously used one from the drop-down list.

The DITA Maps file patterns option allows you to set the extension of the files that will be handled as DITA maps when opened in Oxygen XML Editor. Oxygen XML Editor can open a DITA map in the regular editor view or in the DITA Maps Manager.

The following options are available When opening a map:

Always open in the DITA Maps Manager - A DITA map file is always opened in the DITA Maps Manager view.
Always open as XML - A DITA map file is always opened in the XML editor.
Always ask - When opening a DITA map, you are prompted to choose between opening it in the XML editor panel or in the DITA Maps Manager view.

The Show console output option allows you to specify when to display the console output log. The following options are available:

When build fails - displays the console output log if the build fails.
Always - displays the console output log, regardless of whether or not the build fails.

The following options are available for the Insert Reference and Edit Properties operations:

Always fill values for attributes - Allows you to specify that in the Insert Reference\Edit Properties dialog box, the values for these attributes will be automatically populated with a detected value (based on the specifications), even if it is the same as the default value.
- Format - If enabled, the Format attribute will always be populated automatically .
- Scope - If enabled, the Scope attribute will always be populated automatically.
- Type - If enabled, the Type attribute will always be populated automatically.

At the bottom of the page there is a link to the Profiling Attributes preferences, where you can configure how profiling and conditional text is displayed in Author mode.