Content Completion Preferences

Oxygen XML Author plugin provides a Content Completion Assistant that list available options at any point in a document and can auto-complete structures, elements, and attributes. These options control how the Content Completion Assistant works.

To configure the Content Completion preferences, open the Preferences dialog box and go to Editor > Content Completion.

The following options are available:

• Auto close the last opened tag - Oxygen XML Author plugin closes the last open tag when you type </.
• Automatically rename/delete/comment matching tag - If you rename, delete, or comment out a start tag, Oxygen XML Author plugin automatically renames, deletes, or comments out the matching end tag.
  Note: If you select Toggle comment for multiple starting tags and the matching end tags are on the same line as other start tags, the end tags are not commented.
• Use content completion - Turns content completion on or off.
• Close the inserted element - When you choose an entry from the Content Completion Assistant list of proposals, Oxygen XML Author plugin inserts both start and end tags.
  • If it has no matching tag - The end tag of the inserted element is automatically added only if it is not already present in the document.
  • Add element content - Oxygen XML Author plugin inserts the required elements specified in the DTD, XML Schema, or RELAX NG schema that is associated with the edited XML document.
    • Add optional content - Oxygen XML Author plugin inserts the optional elements specified in the DTD, XML Schema, or RELAX NG schema.
    • Add first Choice particle - Oxygen XML Author plugin inserts the first choice particle specified in the DTD, XML Schema, or RELAX NG schema.
• Case sensitive search - When enabled, the search in the content completion assistant window when you type a character is case-sensitive ('a' and 'A' are different characters).
  Note: This option is ignored when the current language itself is not case sensitive. For example, the case is ignored in the CSS language.
• Cursor position between tags - When selected, Oxygen XML Author plugin automatically moves the cursor between start and end tag after inserting the element. This only applies to:
  • Elements with only optional attributes or no attributes at all.
  • Elements with required attributes, but only when the Insert the required attributes option is disabled.
• Show all entities - Oxygen XML Author plugin displays a list with all the internal and external entities declared in the current document when you type the start character of an entity reference (for example, &).
• Insert the required attributes - Oxygen XML Author plugin inserts automatically the required attributes taken from the DTD or XML Schema. This option is applied also in the Author mode of the XML editor.
• Insert the fixed attributes - Oxygen XML Author plugin automatically inserts any FIXED attributes from the DTD or XML Schema for an element inserted with the help of the Content Completion Assistant. This option is applied also in the Author mode of the XML editor.
• Show recently used items - when checked, Oxygen XML Author plugin remembers the last inserted items from the Content Completion Assistant window. The number of items to be remembered is limited by the Maximum number of recent items shown list box. These most frequently used items are displayed on the top of the content completion window their icon is decorated with a small red square.. This option is applied also in the Author mode of the XML editor.
• Maximum number of recent items shown - limits the number of recently used items presented at the top of the Content Completion Assistant window. This option is applied also in the Author mode of the XML editor.
• Learn attributes values - Oxygen XML Author plugin learns the attribute values used in a document. This option is applied also in the Author mode of the XML editor.
• Learn on open document - Oxygen XML Author plugin automatically learns the document structure when the document is opened. This option is applied also in the Author mode of the XML editor.
• Learn words (Dynamic Abbreviations, available on Ctrl Space (Command Space on OS X)) - When selected, Oxygen XML Author plugin learns the typed words and makes them available in a content completion fashion by pressing Ctrl Space (Command Space on OS X) om your keyboard;
  Note: In order to be learned, the words need to be separated by space characters.