DITA Maps Preferences
To access the DITA Maps preferences page, open the Preferences dialog box and go to . This preferences page includes the following options:
- Expand references to other maps when opening a map in Author mode
- Enabling this option will improve performance (decrease the loading time) when opening
maps in Author mode (particularly maps that contain a large
amount of submaps). This option is disabled by default.Note: You must close and reopen the map to see the effects of enabling/disabling this option.
DITA Maps Manager section
- If selected and there is a
@navtitleattribute set on a<topicref>, then the@navtitleis used to render the title of the topic in the DITA Maps Manager. - Allow referenced submaps to be edited
- If selected, all DITA maps referenced directly or indirectly in a DITA map that is
open in the DITA Maps Manager view will be fully editable. You
will be able to add new topic references, modify properties, and move topic references
from one submap to another. Saving the main DITA map will also save the contents of
the modified submaps.Attention: The documents must be reopened to apply a change to this option.
- Local files only
- If selected, only submaps that are located on local disk drives will be editable. As for maps located in remote locations (e.g. content management systems), the save operation might not work on all submaps. This checkbox is selected by default.
Inserting Topic References section
- Always set values for the following attributes
- 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
@formatattribute will always be automatically populated with a detected value. - Scope - If selected, the
@scopeattribute will always be automatically populated with a detected value. - Type - If selected, the
@typeattribute will always be automatically populated with a detected value. - Navigation title - If selected, the
@navtitleattribute will always be automatically populated with a detected value.
- Format - If selected, the
- Use the file name as the value of the "keys" attribute
- If selected, when inserting a topic reference into a map, the file name will be used
as the value of the
@keysattribute for the new<topicref>. This option has a slightly different effect depending on the method used for inserting the topic reference:- Drag/Drop or Copy/Paste in the DITA Maps Manager - If you drag or copy a
resource from another view (or outside Oxygen XML Editor Eclipse plugin) and drop or paste
it into the DITA Maps Manager and a key is already defined
for that resource, a
@keyrefattribute will be inserted instead. This even works for two consecutive drag/drop or copy/paste operations without saving the file and it works for multiple selections of topic references. - Drag/Drop or Copy/Paste in a Map opened in Author Mode - If you drag or
copy a resource from another view (or outside Oxygen XML Editor Eclipse plugin) and drop or
paste it into a map that is open in Author mode, and a key
is already defined for that resource, a
@keyrefattribute will be inserted instead.Restriction: In this particular scenario, if you perform two identical, consecutive drag/drop or copy/paste operations without saving the file between operations, the value of the@keysattribute will be the same for both inserted topic references. The workaround for this limitation is to simply save the map after each drag/drop or copy/paste operation. - Using the Fast Create Topics or Duplicate Actions - If you use the Fast Create Topics
feature or Duplicate action to insert topic references,
the newly created
<topicref>elements will contain the@keysattribute with its value set depending on the file name. - Using the Insert Topic Reference Dialog Box from the
DITA Maps Manager - If you use an action in the DITA Maps
Manager to insert topic references (e.g. ), a
@keysattribute will be set for each inserted topic reference and the value depends on the file name. You can see the value in the Define keys field from the Keys tab of the Insert Reference dialog box and you can change it.
Note: This option also has an effect on image references. When inserting a reference to an image in a DITA map and this option is selected, a<keydef>element is created if it is allowed by the schema. If it is not allowed (or this option is deselected), a specific topic reference element is created with the value of the@processing-roleattribute set to resource-only. - Drag/Drop or Copy/Paste in the DITA Maps Manager - If you drag or copy a
resource from another view (or outside Oxygen XML Editor Eclipse plugin) and drop or paste
it into the DITA Maps Manager and a key is already defined
for that resource, a
Reference