Schema-Aware Preferences

Oxygen XML Author can use the schema of your XML language to improve the way the Author mode editor handles your content. To configure the Schema Aware options, open the Preferences dialog box and go to Editor > Edit modes > Author > Schema aware.

• Schema aware normalization, format, and indent

  When you open or save a document in Author mode, white space is normalized using the display property of the current CSS stylesheet and the values of the settings for Preserve space elements, Default space elements, and Mixed content elements. When this option is selected, the schema will also be used to normalize white space, based on the content model (element-only, simple-content, or mixed) . Note that the schema information takes precedence.

• Indent blocks-only content

  To avoid accidentally introducing inappropriate white space around inline elements, Oxygen XML Author does not normally apply indenting to the source of an element with mixed content. If this option is selected, Oxygen XML Author will apply indenting to the source of mixed content elements that only contain block elements.

• Schema Aware Editing

  This setting determines how Oxygen XML Author will use the schema of a document to control the behavior of the Author mode.

  • On - Enables all schema-aware editing options.
  • Off - Disables all schema-aware editing options.
  • Custom - Allows you to select custom schema-aware editing options from the following:
    • Delete element tags with backspace and delete

      Controls what happens when you attempt to delete an element tag. The options are:

      • Smart delete

        If deleting the tag would make the document invalid, Oxygen XML Author will attempt to make the document valid by unwrapping the current element or by appending it to an adjacent element where the result would be valid. For instance, if you delete a bold tag, the content can be unwrapped and become part of the surrounding paragraph, but if you delete a list item tag, the list item content cannot become part of the list container. However, the content could be appended to a preceding list items.

      • Reject action when its result is invalid

        A deletion that would leave the document in an invalid state is rejected.

    • Paste and Drag and Drop

      Controls the behavior for paste and drag and drop actions. Available options are:

      • Smart paste and drag and drop
        If the content inserted by a paste or drop action is not valid at the caret position, according to the schema, Oxygen XML Author tries to find an appropriate insert position. The possibilities include:

        • Creating a sibling element that can accept the content. (For example, if you tried to paste a paragraph into an existing paragraph.)
        • Inserting the content into a parent or child element. (For example, if you tried to paste a list item into an existing list item, or into the space above or below and existing list.)
        • Inserting the content into an ancestor element where it would be valid.
      • Reject action when its result is invalid

        If this option is enabled and the Smart paste and drag and drop option is disabled, Oxygen XML Author will not let you paste content into a position where it would be invalid.

    • Typing

      Controls the behavior that takes place when typing. Available options:

      • Smart typing

        If typed characters are not allowed in the element at the caret position, but the previous element does allow text, then a similar element will be inserted, along with your content.

      • Reject action when its result is invalid

        If checked, and the result of the typing action is invalid, the action will not be performed.

    • Content Completion

      Controls the behavior that takes place when inserting elements using content completion. Available options are:

      • Allow only insertion of valid elements and attributes

        If selected, the content completion list shows only the elements that can be inserted at the current position and will not allow you to enter any other element.

      • Show all possible elements in the content completion list

        If selected, the content completion list will show all the elements in the schema, even those that cannot be entered validly at the current position. If you select an element that is not valid at the current position, Oxygen XML Author will attempt to find a valid location to insert it and may present you with several options.

    • Warn on invalid content when performing action
      A warning message will be displayed when performing an action that will result in invalid content. Available options are:

      • Delete Element Tags

        If selected, a warning message will be displayed if the Delete Element Tags action will result in an invalid document. You will be asked to confirm the deletion.

      • Join Elements

        If selected, a warning message will be displayed if the Join Elements action will result in an invalid document. You will be asked to confirm the join.

• Convert external content on paste

  If selected, turns on smart paste for external content.