Edit online

To access the DITA Preferences page, open the Preferences dialog box (Options > Preferences) 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 Author installation) to be used for validating and publishing DITA content. You can select from the following:

Built-in DITA-OT 3.x
Oxygen XML Author comes bundled with DITA-OT 3.4. By default, all defined DITA transformation/validation scenarios will run with this version. This also provides access to DITA 1.3 features (including document templates). The default DITA-OT 3.4 directory is: [OXYGEN_INSTALL_DIR]/frameworks/dita/DITA-OT3.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.
Important: Using a custom DITA Open Toolkit may disable certain features in the application. Examples of features that may not work properly:
  • If the custom DITA-OT is missing certain publishing plugins, default transformation scenarios such as DITA Map WebHelp Responsive or DITA Map PDF - based on HTML5 & CSS may no longer work properly.
  • Validation of Markdown documents using Schematron may not work because it is based on a certain DITA Open Toolkit plugin.
  • The DITA framework (defined in the Preferences > Document Type Associations page) will use the XML catalogs specified in the DITA-OT configured in the Preferences > DITA page to perform the validation of all DITA topic types. If this DITA-OT is different from the one that comes bundled with the Oxygen XML Author default distribution, you might encounter validation-related issues.
CAUTION: Oxygen XML Author support engineers cannot offer support and troubleshooting assistance for a custom DITA-OT. If you discover any issues or inconsistent behavior while using a custom DITA-OT, you should revert to the default built-in DITA-OT.
DITA Maps file patterns
Allows you to specify the extension types that will be handled as DITA maps when opened in Oxygen XML Author.
When opening a map
Oxygen XML Author can open a DITA map in the regular editor view or in the DITA Maps Manager. This option allows you to specify how a map will be opened. You can choose one of the following options:
  • 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.
When the last/first item is reached while navigating reviews
This option allows you to specify what should happen when you are navigating review items in the Review view and you reach the last or first review item. You can choose one of the following options:
  • Open the next/previous document (in the current DITA map hierarchy) that contains review items - If you reach the last/first review item in the document, clicking the Next or Previous navigation buttons will open the next/previous document (from the current DITA map hierarchy) that contains review items.
  • Do nothing - If you reach the last/first review item in the document, clicking the Next or Previous navigation buttons will do nothing.
  • Always ask - If you reach the last/first review item in the document, clicking the Next or Previous navigation buttons will open a dialog box asking if you want to open the next/previous document (from the current DITA map hierarchy) that contains review items.
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.
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.