<oXygen/> XML Editor User Guide

XML editor specific actions

<oXygen/> offers a group of actions for working on single XML elements. They are available from the Document menu and the context menu of the main editor panel.

Select actions

  • Document+Select->Select element: Selects the entire current element;

  • Document+Select->Select content: Selects the current element, excluding the start tag and end tag;

  • Document+Select->Select attributes: Selects all the attributes of the current element;

[Note]Note

The Select actions are enabled when the caret is positioned inside a tag name.

Source actions

  • Document+Source->Shift Right (Tab): Shifts the selected block to the right;

  • Document+Source->Shift Left (Shift+Tab): Shifts the selected block to the left;

  • Document+Source->Escape Selection ...: Escapes a range of characters by replacing them with the corresponding character entities.

  • Document+Source->Unescape Selection ...: Replaces the character entities with the corresponding characters;

  • Document+Source->Indent selection:Corrects the indentation of the selected block of lines.

  • Document+Source->Pretty-Print Element: Pretty prints the element that surrounds the caret position;

  • Document+Source->Import entities list : Shows a dialog that allows you to select a list of files as sources for external entities. The DOCTYPE section of your document will be updated with the chosen entities. For instance, if choosing the file chapter1.xml, and chapter2.xml, the following section is inserted in the DOCTYPE:

    <!ENTITY chapter1 SYSTEM "chapter1.xml">
    <!ENTITY chapter2 SYSTEM "chapter2.xml">

XML document actions

  • Document+XML Document->Uncomment selection : Removes <!-- --> comment brackets from currently selected comment.

  • Document+XML Document->Comment selection : Places <!-- --> comment brackets around current selection or cursor position.

  • Document+XML Document->Go to the matching tag (Ctrl+Shift+G): Moves the cursor to the end tag that matches the start tag, or vice versa.

XML Refactoring actions

  • Document+XML Refactoring->Surround with <tag> (Ctrl+/): Selected Text in the editor is marked with start and end tags of the last 'Surround in' action.

  • Document+XML Refactoring->Surround with tag... (Ctrl+E): Selected Text in the editor is marked with the specified start and end tags.

  • Document+XML Refactoring->Surround with <![CDATA[]]> : Selected Text in the editor is marked with a CDATA tag.

  • Document+XML Refactoring->Rename element (Alt+Shift+R): The element from the caret position and the elements that have the same name as the current element can be renamed according with the options from the Rename dialog.

  • Document+XML Refactoring->Split element (Ctrl+Alt+D): Split the element from the caret position in two identical elements. The caret must be inside the element

  • Document+XML Refactoring->Join elements (Ctrl+Alt+J): Joins the left and the right elements relative to the current caret position. The elements must have the same name, attributes and attributes values.

  • Document+XML Refactoring->Delete element tags (Ctrl+Alt+X): Deletes the start tag and end tag of the current element.