Editing Actions

Oxygen XML Web Author allows you to not only review documents, but to also make changes to them. On mobile devices, to activate the editing mode, tap or click the Edit button in the upper toolbar (or swipe left). A variety of editing actions are available on the toolbar, and on the desktop version, from the contextual menu.

Oxygen XML Web Author also has a panel on the right side of the screen that includes useful views and a variety of editing actions. If this panel is not displayed, use the Toggle Side Panel button from the upper right-side corner (or swipe from right to left on mobile devices).

Figure: Web Author Right-Side Menu Panel

The following views can be accessed from the panel on the right side of the editor:
  • Review - Displays the tracked changes and comments that have been added to the document by you or other content authors. Each change or comment includes actions such as Reply, Mark as Done, Accept or Reject changes, and Change or Remove comments.
  • Attributes - Displays all possible attributes and their values. Change or Remove comments. See the How to Perform Common Review Tasks topic for more information.
  • Search - Provides Search and Replace actions for searching the current document.

Review Actions Toolbar

The Review toolbar contains actions to assist you with review tasks. On the desktop version, some of these actions are also available in the contextual menu. These actions include:
Toggle Change Tracking
Toggles change tracking mode on or off.
Accept Change
Available on changes when Change Tracking is enabled. It accepts the tracked change located at the cursor position. 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
Available on changes when Change Tracking is enabled. Rejects the tracked change located at the cursor position. For an insert change, it means removing the inserted text and for a delete change, it means preserving the original content from the document.
Add comment
Allows you to insert a comment on a selected fragment of text.
Edit Comment
Opens the Edit Comment dialog box that allows you to edit the selected comment.
Remove Comment
Removes a selected comment.
Previous Marker
Navigates to the previous change or comment.
Next Marker
Navigates to the next change or comment.

Framework-Specific Actions Toolbar

Depending on the type of document you are editing, the toolbar contains a series of actions defined at framework level. On the desktop version, some of these actions are also available in the contextual menu. Oxygen XML Web Author includes built-in actions for DITA, DITA Map, DocBook, TEI, and XHTML document types. These actions include:
Styling actions
Most common styling actions, such as Bold, Italic, Underline.
Insert actions
Actions that allows you to insert a variety of framework-specific objects, such as , images, equations, tables, paragraphs, cross references (DITA & DocBook), topic references (DITA map), relationship tables (DITA map), and others.
List actions
Actions that allow you to create ordered and unordered lists, and add new items in them.
Table actions
Actions that allow you to create a table and manage its structure (insert and delete rows and columns).
Choose DITA Map
For DITA documents, the toolbar includes a Choose DITA Map button that opens a dialog box where you can enter a URL for the DITA Map that you want to be associated with the current document.

Contextual Menu Actions (Desktop Version)

In a desktop web browser, the contextual menu also offers the following actions, along with framework-specific actions:
Copy
Opens a dialog box that allows you to preview the content to be copied. You can then use the Ctrl + C (Command + C on OS X) keyboard shortcut to copy the selected content to the clipboard (or invoke the contextual menu from that dialog box and choose the Copy action).
Paste Special
Opens a dialog box that allows you to choose how to paste copied content. You have to use the Ctrl + V (Command + V on OS X) keyboard shortcut (or select Paste from the contextual menu) to paste the copied content into the preview window in this Paste Special dialog box and then you can choose to paste it into your document with one of the following choices:
  • Smart Paste - Oxygen XML Web Author will paste the copied content while trying to preserve its structure and if the current location is invalid, Oxygen XML Web Author will attempt to find a possible solution.
  • Paste as Text - The copied content will be pasted as text content.
  • Paste as XML - Copied content that is considered to be valid XML will be pasted with its XML structure preserved.
Cut
Opens a dialog box that allows you to preview the content to be cut. You can then use the Ctrl + X (Command + X on OS X) keyboard shortcut to cut the selected content and copy it to the clipboard (or invoke the contextual menu from that dialog box and choose the Cut action).
Undo
This action is available after you make a change.
Redo
This action is available when you use the Undo action.
Insert Element
Inserts an element at current position.
Rename Element
Renames the current element.
Surround With
Allows you to choose a tag to enclose the selected content.
Accept Change
Available on changes when Change Tracking is enabled. It accepts the tracked change located at the cursor position. 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
Available on changes when Change Tracking is enabled. Rejects the tracked change located at the cursor position. For an insert change, it means removing the inserted text and for a delete change, it means preserving the original content from the document.
Add comment
Allows you to insert a comment on a selected fragment of text.
Remove Comment
Removes a selected comment.
Edit Comment
Opens the Edit Comment dialog box that allows you to edit the selected comment.