Editing actions

[Important]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 following general actions can be performed on an opened DITA Map:

Open

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.

Open URL

Allows opening remote DITA Maps in the DITA Maps Manager view. See Open URL for details.

Save

Allows saving the currently opened DITA Map.

Apply Transformation Scenario

Allows the user to start the DITA ANT Transformation scenario associated with the opened map. For more transformation details see here.

Configure Transformation Scenario

Allows the user to configure a DITA ANT Transformation scenario for the opened map. For more transformation details see here.

Refresh References

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.

Open map in editor

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 map in editor with resolved topics

Open the map in the main editing area with all the topic references expanded in the map content.

[Tip]Tip

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:

Insert Topic Reference

Inserts a reference to a topic file. See more about this action here.

Insert Topic Heading

Inserts a topic heading. See more about this action here

Insert Topic Group

Inserts a topic group. See more about this action here.

Edit properties

Edit the properties of a selected node. See more about this action here.

Edit other attributes

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.

Delete

Deletes the selected nodes.

Move Up

Moves the selected nodes in front of their respective previous siblings.

Move Down

Moves the selected nodes after their next respective siblings.

Promote

Moves the selected nodes after their respective parents as a siblings.

Demote

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:

Find/Replace in Files

Find Replace in files using the scope of the current edited DITA Map. See more details here.

Check Spelling in Files

Check spelling for the files in the scope of the current edited DITA Map. See more details here.

Open in editor

Open in the editor the resources referred by the selected nodes

Open Map in Editor with resolved topics

Open 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

Will paste the content of the clipboard before respectively after the selected node.

Append Child/Insert After
Topic reference

Append/Insert a topic reference as a child/sibling of the selected node

Topic reference to the current edited file

Append/Insert a topic reference to the current edited file as a child/sibling of the selected node

Topic heading

Append/Insert a topic heading as a child/sibling of the selected node

Topic group

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:

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 should change to indicate that a copy operation will be performed.

Move

Select the nodes you want to move and drag and drop them in the appropriate place.

Promote / Demote

You can move nodes between child and parent nodes which ensures both Promote and Demote operations.

[Tip]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 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.

[Note]Note

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:

File actions

Save, Save As, Save to URL, Save All, Print, Print preview, Close, Close others, Close all

Edit actions

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.