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. keyref
s are solved relative to
the current map.
The following general actions can be performed on an opened DITA Map:
Allows opening the DITA Map in the DITA Maps Manager view. You can also open a DITA Map by dragging it in the DITA Maps Manager from the file system explorer.
Allows opening remote DITA Maps in the DITA Maps Manager view. See Open URL for details.
Allows saving the currently opened DITA Map.
Allows the user to start the DITA ANT Transformation scenario associated with the opened map. For more transformation details see here.
Allows the user to configure a DITA ANT Transformation scenario for the opened map. For more transformation details see here.
Sometimes after a topic was edited and its title changed the topic's title needs to be also updated in the DITA Maps manager view. You can use this action to refresh and update titles for all referred topics.
For complex operations which cannot be performed in the simplified DITA Maps view (like editing a relationship table) you can open the map in the main editing area. See more about editing a map in the main edit area here.
Open the map in the main editing area with all the topic references expanded in the map content.
The additional edit toolbar can be shown by clicking the "Show/Hide additional toolbar" expand button located on the general toolbar.
The following edit actions can be performed on an opened DITA Map:
Inserts a reference to a topic file. See more about this action here.
Inserts a topic heading. See more about this action here
Inserts a topic group. See more about this action here.
Edit the properties of a selected node. See more about this action here.
Edits all the attributes of a selected node. A dialog is presented allowing the user to see and edit the attributes of the selected node. See here for more details about editing attributes.
Deletes the selected nodes.
Moves the selected nodes in front of their respective previous siblings.
Moves the selected nodes after their next respective siblings.
Moves the selected nodes after their respective parents as a siblings.
Moves the selected nodes as children to their respective previous siblings.
The contextual menu contains, in addition to the edit actions described above, the following actions:
Check spelling for the files in the scope of the current edited DITA Map. See more details here.
Open in the editor the resources referred by the selected nodes
Open the map in the main editing area with all the topic references expanded in the map content.
Common edit actions with the same functionality as those found in the text editor
Will paste the content of the clipboard before respectively after the selected node.
Append/Insert a topic reference as a child/sibling of the selected node
Append/Insert a topic reference to the current edited file as a child/sibling of the selected node
Append/Insert a topic heading as a child/sibling of the selected node
Append/Insert a topic group as a child/sibling of 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:
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 should change to indicate that a copy operation will be performed.
Select the nodes you want to move and drag and drop them in the appropriate place.
You can move nodes between child and parent nodes which ensures both Promote and Demote operations.
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 will be 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.
Some of the common actions from the main application menu/toolbar also apply to the DITA Maps Manager when it has focus. These actions are:
Save, Save As, Save to URL, Save All, Print, Print preview, Close, Close others, Close all
Undo, Redo, Cut, Copy, Paste, Delete
The Save all action applies to all editors opened in either <oXygen/> work area or the DITA Maps Manager.