Edit online

DITA Map Author Mode Actions

A variety of actions are available for DITA map documents that can be found in DITA menu, toolbar, contextual menu, and the Content Completion Assistant.

DITA Map Toolbar and Menu Actions

When a DITA map is opened in Author mode, the following default actions are available on the DITA Map toolbar (by default, they are also available in the DITA menu and in various submenus of the contextual menu):

Insert New DITA Resource: Opens a New DITA file dialog box where you can choose the type of DITA document to create and inserts a reference to it at the current position within the map.
Insert Topic Reference: Opens the Insert Reference dialog box where you can configure a topic reference and inserts it at the current position within the map.
Insert Key Definition with Keyword: Opens a dialog box where you can choose the name of a key and its keyword value and inserts the key definition at the current position within the map.
Reuse Content: Opens the Reuse Content dialog box that allows you to insert and configure a content reference (@conref), or a content key reference (@conkeyref) at the cursor position.
Insert Topic Heading: Opens the Insert Reference dialog box that allows you to insert a topic heading at the cursor position.
Insert Topic Group: Opens the Insert Reference dialog box that allows you to insert a topic group at the cursor position.
Insert Relationship Table: Opens a dialog box that allows you to configure the relationship table to be inserted. The dialog box allows you to configure the number of rows and columns of the relationship table, if the header will be generated and if the title will be added.
Relationship Table Properties: Allows you to change the properties of rows in relationship tables.
Insert Relationship Row: Inserts a new table row with empty cells. The action is available when the cursor position is inside a table.
Insert Relationship Column: Inserts a new table column with empty cells after the current column. The action is available when the cursor position is inside a table.
Delete Relationship Column: Deletes the table column where the cursor is located.
Delete Relationship Row: Deletes the table row where the cursor is located.
Move Up: Moves the selected node up one position on its same level.
Move Down: Moves the selected node down one position on its same level.
Promote(): Moves the selected node up one level to the level of its parent node.
Demote(): Moves the selected node down one level to the level of its child nodes.

DITA Map Contextual Menu Actions

The following actions are available in the contextual menu when editing in Author mode (most of them are also available in the DITA menu at the top of the interface):

Insert submenu

This submenu includes the following insert actions that are specific to the DITA Map framework:

Insert New DITA Resource

Opens a New DITA file dialog box where you can choose the type of DITA document to create and inserts a reference to it at the current position within the map.

Insert Topic Reference

Opens the Insert Reference dialog box where you can configure a topic reference and inserts it at the current position within the map.

Insert Key Definition with Keyword

Opens a dialog box where you can choose the name of a key and its keyword value and inserts the key definition at the current position within the map.

Reuse Content

Opens the Reuse Content dialog box that allows you to insert and configure a content reference (@conref), or a content key reference (@conkeyref) at the cursor position.

Insert Topic Heading

Opens the Insert Reference dialog box that allows you to insert a topic heading at the cursor position.

Insert Topic Group

Opens the Insert Reference dialog box that allows you to insert a topic group at the cursor position.

Insert Entity

Allows you to insert a predefined entity or character entity. Surrogate character entities (range #x10000 to #x10FFFF) are also accepted. Character entities can be entered in one of the following forms:

#<decimal value> - e.g. #65
&#<decimal value> - e.g. &#65
#x<hexadecimal value> - e.g. #x41
&#x<hexadecimal value> - e.g. &#x41

Relationship Table > Insert Relationship Table

Opens a dialog box that allows you to configure the relationship table to be inserted. The dialog box allows you to configure the number of rows and columns of the relationship table, if the header will be generated and if the title will be added.

Search References

Finds the references to the @href or @keys attribute value of the topic/map reference element at the current cursor position, in all the topics from the current DITA map (opened in the DITA Maps Manager view). The current topic/map reference element must have an @href or @keys attribute defined to complete the search.

Text submenu

This submenu contains the following actions:

To Lower Case: Converts the selected content to lower case characters.
To Upper Case: Converts the selected content to upper case characters.
Capitalize Sentences: Converts to upper case the first character of every selected sentence.
Capitalize Words: Converts to upper case the first character of every selected word.
Count Words: Counts the number of words and characters (no spaces) in the entire document or in the selection for regular content and read-only content.
Note:
The content marked as deleted with change tracking is ignored when counting words.

Refactoring submenu

Contains a series of actions designed to alter the XML structure of the document:

Review submenu

This submenu includes the following actions:

Track Changes: Enables or disables the Track Changes support for the current document.
Accept Change(s) and Move to Next
Accept All Changes
Reject Change(s) and Move to Next
Reject All Changes

Highlight: Enables the highlighting tool that allows you to mark text in your document.
Colors: Allows you to select the color for highlighting text.
Stop highlighting: Use this action to deactivate the highlighting tool.
Remove highlight(s): Use this action to remove highlighting from the document.



Manage Reviews: Opens the Review view.

Folding submenu

This submenu includes the following actions:

About Element > Go to Definition

Moves the cursor to the definition of the current element.

Inspect Styles

Opens the CSS Inspector view that allows you to examine the CSS rules that match the currently selected element.

Options

Opens the Author mode preferences page where you can configure various options with regard to the Author editing mode.

Floating Contextual Toolbar for DITA

Oxygen XML includes a dynamic feature where certain editing contexts will trigger a floating toolbar with common actions that are available in the current editing context.

The floating contextual toolbar is automatically displayed when editing DITA map documents when a <topicref> element is selected and it includes actions for moving the topic reference node up or down (or promoting/demoting the node).

DITA Map Drag/Drop Actions

Dragging a file from the ProjectProject Explorer view or DITA Maps Manager view and dropping it into a DITA map document that is edited in Author mode creates a link to the dragged file (a <topicref> element, <chapter>, <part>, etc.) at the drop location.

Opening a Topic from a DITA Map in Author Mode

If a DITA map is open in the Author visual editing mode, you can open a referenced topic by clicking the icon to the left of the particular topic. The source topic is opened in a new tab in the main editor.

Note: