Contextual Menu Actions in Author Mode

Oxygen XML Editor includes powerful support for editing XML documents through actions included in the contextual menu. When editing XML documents in Author mode, the contextual menu includes general actions that are available for all of the recognized document types and document type-specific actions that are configured for each document type.

General Contextual Menu Actions in Author Mode

The general actions that are available in the contextual menu (some of them are also available in the submenus of the Document menu) for all document types include the following:

Quick Fix (Alt 1 (Meta Alt 1 on OS X))

Available when the contextual menu is invoked on an error where Oxygen XML Editor can provide a quick fix.

Open Image

Available when the contextual menu is invoked on an image. This action allows you to open an image in the Oxygen XML Editor's Image Viewer or in a default system application associated with the current image type.

Track Changes Actions

Available when the Track Changes feature is enabled and the contextual menu is invoked on a change. The following options are available:

Accept Change(s): Accepts the tracked change located at the cursor position. If you select a part of a delete or insert change, only the selected content is accepted. If you select multiple changes, all of them are accepted. For an insert change, it means keeping the inserted text and for a delete change, it means removing the content from the document.
Reject Change(s): Rejects the tracked change located at the cursor position. If you select a part of a delete or insert change, only the selected content is rejected. If you select multiple changes, all of them are rejected. For an insert change, it means removing the inserted text and for a delete change, it means preserving the original content from the document.
Comment Change: Opens a dialog box that allows you to add a comment to an existing tracked change. The comment appears in a callout box and a tooltip (when hovering over the change).

Author Callout Actions

Available when the contextual menu is invoked on a callout. If enabled in the Callouts preferences page, the callouts are displayed in Author mode for comments, tracked insertion changes, or tracked deletion changes.

The following actions are available in the contextual menu of an insertion or deletion callout:

Accept Change(s): Accepts the tracked change located at the cursor position. If you select a part of a delete or insert change, only the selected content is accepted. If you select multiple changes, all of them are accepted. For an insert change, it means keeping the inserted text and for a delete change, it means removing the content from the document.
Reject Change(s): Rejects the tracked change located at the cursor position. If you select a part of a delete or insert change, only the selected content is rejected. If you select multiple changes, all of them are rejected. For an insert change, it means removing the inserted text and for a delete change, it means preserving the original content from the document.
Comment Change: Opens a dialog box that allows you to add a comment to an existing tracked change. The comment appears in a callout box and a tooltip (when hovering over the change).
Edit Reference: If the fragment that contains a callout is a reference, use this option to go to the reference and edit the callout.
Callouts Options: Select this option to open a preferences page where you can configure the callout options.

The following actions are available in the contextual menu of a comment callout:

Edit comment: Opens the Edit Comment dialog box that allows you to edit the selected comment.
Remove comment: Removes a selected comment.
Callouts Options: Select this option to open a preferences page where you can configure the callout options.

Edit Attributes

Displays an in-place attributes editor that allows you to manage the attributes of an element.

Edit Profiling Attributes

Allows you to change the profiling attributes defined on all selected elements.

Cut

Deletes the currently selected content and copies it to the clipboard.

Copy

Copies the currently selected content to the clipboard.

Paste

Pastes the content of the clipboard at the current cursor location.

Paste special submenu

This submenu includes special paste actions that are specific to each framework, as well as the following general paste actions:

Paste As XML: Pastes clipboard content that is considered to be XML.
Paste As Text: Pastes clipboard content, ignoring any structure or styling markup.

Insert submenu

This submenu includes insert actions that are specific to each framework, along with the following general action:

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

Select submenu

This submenu allows you to select the following:

Element: Selects the entire element at the current cursor position.
Content: Selects the entire content of the element at the current cursor position, excluding the start and end tag. Performing this action repeatedly will result in the selection of the content of the ancestor of the currently selected element content.
Parent: Selects the parent of the element at the current cursor position.

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. 0034

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.

Convert Hexadecimal Sequence to Character (Alt X (Meta Shift X on OS X))

Converts a sequence of hexadecimal characters to the corresponding Unicode character. A valid hexadecimal sequence can be composed of 2 to 4 hexadecimal characters, preceded or not by the 0x or 0X prefix. Examples of valid sequences: 0x0045, 0X0125, 1253, 265, 43.

To convert a hexadecimal sequence to a character, do one of the following:

place the cursor at the right side of a valid hexadecimal sequence, then press Alt X (Meta Shift X on OS X) on your keyboard
select a valid hexadecimal sequence, then press Alt X (Meta Shift X on OS X) on your keyboard

Refactoring submenu

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

Toggle Comment

Encloses the currently selected text in an XML comment, or removes the comment if it is commented.

Move Up

Moves the current node or selected nodes in front of the previous node.

Move Down

Moves the current node or selected nodes after the successive node.

Split Element

Splits the content of the closest element that contains the position of the cursor. Thus, if the cursor is positioned at the beginning or at the end of the element, the newly created sibling will be empty.

Join Elements

Joins two adjacent elements that have the same name. The action is available only when the cursor position is between the two adjacent elements. Also, joining two elements can be done by pressing the Delete or Backspace keys and the cursor is positioned between the boundaries of these two elements.

Surround with Tag

Selected text in the editor is marked with the specified start and end tags.

Rename Element

The element from the cursor position and the elements that have the same name as the current element can be renamed according with the options from the Rename dialog box.

Delete Element Tags

Deletes the tags of the closest element that contains the position of the cursor. This operation is also executed if the start or end tags of an element are deleted by pressing the Delete or Backspace keys.

Remove All Markup

Removes all the XML markup inside the selected block of content and keeps only the text content.

Remove Text

Removes the text content of the selected block of content.

Attributes submenu

Contains predefined XML refactoring operations that pertain to attributes. Oxygen XML Editor considers the editing context to get the names and namespaces of the element or attribute for which the contextual menu was invoked, and uses this information to preconfigure some of the parameter values for the selected refactoring operation.

Add/Change attribute: Allows you to change the value of an attribute or insert a new one.
Delete attribute: Allows you to remove one or more attributes.
Rename attribute: Allows you to rename an attribute.
Replace in attribute value: Allows you to search for a text fragment inside an attribute value and change the fragment to a new value.

Elements submenu

Contains predefined XML refactoring operations that pertain to elements. Oxygen XML Editor considers the editing context to get the names and namespaces of the element or attribute for which the contextual menu was invoked, and uses this information to preconfigure some of the parameter values for the selected refactoring operation.

Delete element: Allows you to delete elements.
Delete element content: Allows you to delete the content of elements.
Insert element: Allows you to insert new elements.
Rename element: Allows you to rename elements.
Unwrap element: Allows you to remove the surrounding tags of elements, while keeping the content unchanged.
Wrap element: Allows you to surround elements with element tags.
Wrap element content: Allows you to surround the content of elements with element tags.

Fragments submenu

Contains predefined XML refactoring operations that pertain to XML fragments. Oxygen XML Editor considers the editing context to get the names and namespaces of the element or attribute for which the contextual menu was invoked, and uses this information to preconfigure some of the parameter values for the selected refactoring operation.

Insert XML fragment: Allows you to insert an XML fragment.
Replace element content with XML fragment: Allows you to replace the content of elements with an XML fragment.
Replace element with XML fragment: Allows you to replace elements with an XML fragment.

Review submenu

This submenu includes the following actions:

Track Changes: Enables or disables the track changes support for the current document.
Accept Change(s): Accepts the tracked change located at the cursor position. If you select a part of a delete or insert change, only the selected content is accepted. If you select multiple changes, all of them are accepted. For an insert change, it means keeping the inserted text and for a delete change, it means removing the content from the document.
Reject Change(s): Rejects the tracked change located at the cursor position. If you select a part of a delete or insert change, only the selected content is rejected. If you select multiple changes, all of them are rejected. For an insert change, it means removing the inserted text and for a delete change, it means preserving the original content from the document.
Comment Change: Opens a dialog box that allows you to add a comment to an existing tracked change. The comment appears in a callout box and a tooltip (when hovering over the change).
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 disable the highlighting tool.
Remove highlight(s): Use this action to remove highlighting from the document.
Add Comment: Inserts a comment at the cursor position. The comment appears in a callout box and a tooltip (when hovering over the change).
Remove comment: Removes a selected comment.
Manage Reviews: Opens the Review view.

Manage IDs submenu

This submenu is available for XML documents that have an associated DTD, XML Schema, or Relax NG schema. It includes the following actions:

Rename in: Renames the ID and all its occurrences. Selecting this action opens the Rename XML ID dialog box. This dialog box lets you insert the new ID value and choose the scope of the rename operation.
Search References: Searches for the references of the ID. By default, the scope of this action is the current project. If you configure a scope using the Select the scope for the Search and Refactor operations dialog box, this scope will be used instead.
Search References in: Searches for the references of the ID. Selecting this action opens the Select the scope for the Search and Refactor operations.
Search Occurrences in file: Searches for the occurrences of the ID in the current document.

Folding submenu

This submenu includes the following actions:

Toggle Fold: Toggles the state of the current fold.
Collapse Other Folds (Ctrl NumPad / (Meta NumPad / on OS X)): Folds all the elements except the current element.
Collapse Child Folds (Ctrl NumPad . (Meta NumPad . on OS X)): Folds the elements indented with one level inside the current element.
Expand Child Folds: Unfolds all child elements of the currently selected element.
Expand All (Ctrl NumPad * (Meta NumPad * on OS X)): Unfolds all elements in the current document.

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 options page.

Document Type-Specific Contextual Menu Actions in Author Mode

Other document type-specific actions are available in the contextual menu of Author mode for the following document types (click the links to see the default actions that are available for each specific document types):