Contextual Menu Actions in Author Mode
Oxygen XML 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 framework-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 built-in document types include the following:
- Quick Fix ()
- This action is available when the contextual menu is invoked on a validation error where Oxygen XML can provide a Quick Fix. It displays a list of quick fix suggestions that are detected for the particular validation issue. Any detected quick fixes for the currently highlighted validation issue are also available by right-clicking the status bar at the bottom of the editor.
- Apply all default quick fix proposals
-
This action is available when the contextual menu is invoked on a document that has one or more quick fix proposals detected for reported validation errors. It can be used to apply quick fix proposals for all reported validation errors in the document. If multiple quick fixes are available for the same validation error, the default quick fix defined in the Schematron validation schema using the
sqf:default-fix
attribute is automatically selected to be applied. If no default quick fix is explicitly specified, the first quick fix proposal in the list is considered. All quick fix proposals are then automatically executed in bulk, one after the other.Important Notes to Consider:- To maintain the accuracy of the initially calculated error validation ranges, the quick fix proposals are applied in the reverse order of their selection.
- If two or more quick fixes act on the same "area" within the document, only one is applied (no changes can be made to changes already made).
- Quick fixes that involve "user-entered values" that normally present a dialog box to facilitate data entry will not be executed (the automatic process of applying all selected quick fixes cannot be interrupted by the presence of the respective dialog boxes).
Once the analysis of the impact of applying the quick fixes on the content is complete, a preview dialog box is presented that provides an overview of the content changes that will be made, according to the quick fixes that will be applied. If you agree with the changes presented, click Apply to trigger the quick fixes and update the content.Tip:This action is also available in the contextual menu when right-clicking the status bar at the bottom of the editor (if the currently highlighted validation issue has at least one detected quick fix suggestion available). Specific quick fix suggestions that are defined for the particular validation issue are also available in this menu. - Open Image
- Available when the contextual menu is invoked on an image. This action allows you to open an image in the Oxygen XML Image Viewer or in a default system application associated with the current image type.
- Show in Explorer (Show in Finder on macOS)
- Available when the contextual menu is invoked on an image. This action allows you to open the parent directory of an image in the system file explorer, and it selects the image file.
- Save image as
- Available when the contextual menu is invoked on a local, external, or embedded image. This action opens a dialog box where you can choose a location in the local file system where the image will be saved. It also includes an option (Update the reference to the image) that can be toggled to choose whether or not to update the path in existing references to the image.
- 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:
- Author Callout Actions
-
Available when the contextual menu is invoked on a callout. If the corresponding options in the Show review callouts section are selected in the Callouts preferences page, the callouts are displayed in Author mode for comments, tracked insertions, or tracked deletions.
- Insertion or Deletion Callout Actions
-
The following actions are available in the contextual menu when invoked on an insertion or deletion callout box:
- Edit Reference
- If the fragment that contains a callout is a reference, use this option to go to the reference and edit the callout.
- Comment Callout Actions
-
The following actions are available in the contextual menu when invoked on a comment callout box:
Edit Attributes
- Displays an in-place attributes editor that allows you to manage the attributes of an element.
- 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. A
- #x<hexadecimal value> - e. g. #x41
- &#x<hexadecimal value>; - e. g. A
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, preserving its XML structure.
- Paste As Text ()
- Pastes clipboard content, ignoring any structure or styling markup.
- 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 entire parent 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.
- 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.
- 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:
- 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.