The Schema Aware preferences panel is opened from menu .
The Oxygen Schema Aware
Preferences Panel
- Schema aware normalization, format and indent - When opening a
document in Author, white spaces can be normalized or removed in order to obtain a more
compact display. The reverse process takes place when saving the document in the Author. By
default this algorithm is controlled by the CSS display property.
If this
option is checked then this process will be schema aware so the algorithm will take into
account if the element is declared as element-only or mixed. It will also take into
account options Preserve space elements, Default space elements, Mixed
content elements from option page
- Indent blocks-only content - If checked, even if an element is
declared in the schema as being mixed but it has a blocks-only content (as specified by the
CSS property display of its children), it will be treated as being
element-only.
- Schema Aware Editing - Editing in Author will take into account the schema.
- On - Enables all schema aware editing options.
- Off - Disables all schema aware editing options.
- Custom -
- Delete element tags with backspace and delete - Controls
the behaviour for deleting element tags using delete or backspace keys. Available
options:
- Smart delete - If the result of the delete action is
invalid, different strategies will be applied in order to keep the document
valid. If backspace / delete is pressed at the beginning / end of an element the
action that should take place is unwrap (the element will be deleted and its
content will be put in its place). If its content is not accepted by the schema
in that position, you can keep a valid document by applying different strategies
like:
- Search for a preceding (backspace case)/following (delete case) element in
which you can append that content.
- If the tag markers of the element to unwrap are not visible a caret move
action in the delete action direction will be performed.
- Reject action when its result is invalid - If checked
and the result of the delete action is invalid, the action will not be
performed.
- Paste and Drag and Drop - Controls the behavior for paste
and drag and drop actions. Available options:
- 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, different strategies are applied to find an appropriate insert position:
- If the sibling element can accept the content, then a new element with the
same name as the sibling is created in which the content will be
inserted.
- You will iterate to the left or to the right of the insertion position,
without leaving the current context, and try to insert the fragment in one
of the encountered elements (that accepts the content to be inserted).
- Reject action when its result is invalid - If checked
and the result of the paste or drop action is invalid, the action will not be
performed.
- Typing - Controls the behaviour that takes place when
typing. Available options:
- Smart typing - If the typed character cannot be
inserted at element from the caret position then a sibling element that can
accept it will be searched for. If the sibling element can accept the content,
then a new element with the same name as the sibling is created in which the
content will be inserted.
- 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 behaviour that takes
place when inserting elements using content completion. Available options:
- Allow only
insertion of valid elements and attributes - If checked, only
elements or attributes form the content completion proposals list can be
inserted in the document through content completion.
- 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:
- Delete Element Tags - If checked, when the Delete Element Tags action will
result in an invalid content, a warning message will be displayed in which the
user is asked if the operation should continue.
- Join Elements - If checked, when the Join Elements action will result in
an invalid content, a warning message will be displayed in which the user is
asked if the operation should continue.
- Convert external content on paste - when checked, Oxygen preserves the
formatting style when you paste content copied from external applications (like web browsers
or Office-like applications). This option is enabled by default and applies only to the
major document type frameworks (DocBook, DITA, TEI, XHTML).
If the Schema Aware Editing is On or Custom all actions that can generate
invalid content will be forwarded first toward AuthorSchemaAwareEditingHandler.