DITA Preferences
Edit online

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 plugin installation) to be used for validating and publishing DITA content. You can select from the following:
Built-in DITA-OT 2.x (with support for DITA 1.3 and Lightweight DITA)
Starting with Oxygen XML Editor plugin 18.0, this is the default setting. All defined DITA transformation/validation scenarios will run with DITA-OT 2.5.4. This also gives you access to DITA 1.3 document templates. The default DITA OT 2.5.4 directory is: [OXYGEN_INSTALL_DIR]/frameworks/dita/DITA-OT2.x.
Custom
Allows you to specify a custom directory for your DITA OT distribution.
Location
You can either provide a new file path for the specific DITA OT that you want to use or select a previously used one from the drop-down list. You can specify the path by using the text field, the Insert Editor Variables button, or the Browse button.
Prefer navigation title for topicref rendering
If selected and there is a navtitle attribute set on a topicref, then the navtitle is used to render the title of the topic in the DITA Maps Manager.
Insert topic reference section
Allows you to specify that when inserting a topic reference (using the Insert Reference dialog box and Edit Properties dialog box), the values for certain attributes will always be automatically populated with a detected value (based on the specifications), even if it is the same as the default value. You can choose to always populate the values for the following attributes:
  • Format - If selected, the format attribute will always be automatically populated with a detected value.
  • Scope - If selected, the scope attribute will always be automatically populated with a detected value.
  • Type - If selected, the type attribute will always be automatically populated with a detected value.
  • Navigation title - If selected, the navtitle attribute will always be automatically populated with a detected value.
Insert link section
Allows you to specify that when a link reference is inserted (using actions in the Link drop-down menu), the values for certain attributes will always be automatically populated with a detected value (based on the specifications), even if it is the same as the default value. You can choose to always populate the values for the following attributes:
  • Format - If selected, the format attribute will always be automatically populated with a detected value.
  • Scope - If selected, the scope attribute will always be automatically populated with a detected value.
  • Type - If selected, the type attribute will always be automatically populated with a detected value.
Use '.' instead of the ID of the parent topic (DITA 1.3)

When addressing a non-topic element within the topic that contains the URI reference, the URI reference can use an abbreviated fragment-identifier syntax that replaces the topic ID with "." (#./elementId). For more information, see https://www.oxygenxml.com/dita/1.3/specs/index.html#archSpec/base/uri-based-addressing.html.

Profiling Attributes link
Opens the Profiling/Conditional Text preferences page where you can configure profiling attributes and condition sets.