Important: References can be made either by using the href
attribute or by using the new keyref attribute to point to a key defined in
the map. Oxygen XML Editor tries to
resolve both cases. keyrefs are solved relative to the current map.
In additional to being available on the toolbar and on the contextual
menu, more navigation actions and all edit actions appear in the DITA
Maps menu. The menu is only available when the view is active on screen.
In addition to the edit actions described above, the contextual menu contains the following
- Open - opens in the editor the resources referred by the nodes you
- Append Child/Insert After - sub-menus containing the following actions:
- Reference - appends/Inserts a topic reference as a
child/sibling of the selected node;
- Reference to the current edited file -
appends/Inserts a topic reference to the current edited file as a child/sibling of the
- New topic - create a new topic from
templates, saves it on disk and adds it into the DITA map;
- Anchor Reference, Key Definition,
Map Reference, Topic Reference,
Topic Set, Topic Set Reference - allows
you to insert a reference to a topic file, a map file, a topic set, or a key
- Topic heading - appends/Inserts a topic heading as a
child/sibling of the selected node;
- Topic group - appends/Inserts a topic group as a child/sibling
of the selected node;
- Find/Replace in Files - find and replace in
files using the scope of the current edited map;
- Check Spelling in Files - checks the spelling of the files in the
scope of the current edited map;
- Search References - finds in the current map all references to the
selected topic reference (topicref or mapref element) and
to each element with an ID attribute contained in the selected topic. If the current
selection in the DITA Maps Manager view is a keydef
element the action will find any element with an attribute idref,
keyref, conref or conkeyref that points
to the selected keydef. A shortcut
can be set for this action in the Menu Shortcut Keys preferences.
- Cut, Copy, Paste, Undo, Redo - common edit actions with the same
functionality as those found in the text editor;
- Paste Before, Paste After - pastes the content of the clipboard
before, respectively after, the selected node;
You can also arrange the nodes by dragging and dropping one or more nodes at a time. Drop
operations can be performed before, after or as child of the targeted node. The relative
location of the drop is indicated while hovering the mouse over a node before releasing the
mouse button for the drop.
Drag and drop operations allow you to:
- Copy - select the nodes you want to copy and start dragging them.
Before dropping them in the appropriate place, press and hold the
(Meta key on Mac). The mouse pointer changes
to indicate that a copy operation is performed;
- Move - select the nodes you want to move and drag and drop them in
the appropriate place;
- Promote Alt+Left Arrow / Demote Alt+Right
Arrow - you can move nodes between child and parent nodes which
ensures both PromoteAlt+Left Arrow and
DemoteAlt+Right Arrow operations.
Apart from the above actions, the contextual menu of the root of the map contains the
following two options:
You can open and edit linked topics easily by double clicking the references or by
right-clicking and choosing Open in editor. If the referenced file
does not exist you are allowed to create it.
By right clicking the map root element you can open and edit it in the main editor area for
more complex operations.
You can decide to open the reference directly in the Author mode and keep this setting as a