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 Developer plugin installation) to be used for
validating and publishing DITA content. You can select from the following:
- Built-in DITA-OT 1.8
- If this is set, all defined DITA transformation scenarios will run with
DITA-OT 1.8.5. The built-in DITA OT 1.8.5 directory is:
[OXYGEN_INSTALL_DIR]/frameworks/dita/DITA-OT. - Built-in DITA-OT 2.x (with support for DITA 1.3 and Lightweight DITA)
- Starting with Oxygen 18.0, this is the default setting. All defined DITA
transformation scenarios will run with DITA-OT 2.3.3. This also gives you access to DITA 1.3
file templates when you create new documents
from templates. The default DITA OT 2.3.3 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 enabled and there is a
navtitleattribute set on atopicref, then thenavtitleis 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 , 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 enabled, the attribute will always be automatically populated with a detected value.
- Scope - If enabled, the
sattribute will always be automatically populated with a detected value.formatcope - Type - If enabled, the
typeattribute will always be automatically populated with a detected value. - Navigation title - If enabled, the
navtitleattribute 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 enabled, the
formatattribute will always be automatically populated with a detected value. - Scope - If enabled, the
scopeattribute will always be automatically populated with a detected value. - Type - If enabled, the
typeattribute 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.
- Format - If enabled, the