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 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.
The contextual menu contains, in addition to the edit actions described above, the following
actions:
- Open in Editor - Opens in the editor the resources referred by the
selected nodes.
- 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 selected node.
- 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 definition.
- 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.
- Open Map in Editor with resolved topics - Opens the map in the main
editing area with all the topic references expanded in the map content.
- 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
(Ctrl) key (
(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.
Tip:
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 page and keep this setting as a
default.