Author

The Author preferences panel is opened from menu WindowPreferencesAuthor+Editor+Author

Figure 17.9. The <oXygen/> Author preferences panel

The <oXygen/> Author preferences panel

Show caret position tooltip

If checked, the position information tooltip will be displayed. More information about the position information tooltip can be found in the section Position information tooltip. The documentation tooltip can be disabled from the Content Completion Annotations preferences panel.

Show placeholders for empty elements

When checked, placeholders will be displayed for empty elements to make them clearly visible.

Show Author layout messages

If checked, all errors reported during layout creation will be presented in the Errors view.

Show block range

If checked, a block range indicator will be shown in a stripe located in the left side of the editor.

Hide comments

When checked, comments from the documents edited in Author mode will be hidden.

Hide processing instructions

When checked, processing instructions from the documents edited in Author mode will be hidden.

Hide doctype

When checked, doctype sections from the documents edited in Author mode will be hidden.

Show very large images

If unchecked, images larger than 6 megapixels(24MB uncompressed) will not be loaded and displayed in Author mode. Please be aware that this option is unchecked by default because of the large amounts of application memory that images of high resolution can occupy. As a result, an OutOfMemory error could occur which would practically make <oXygen/> unusable without a restart of the entire application.

Display referred content (e.g.: entities, XInclude, DITA conref, etc.)

When checked, the references(entities, XInclude, DITA conref, etc) will also display the content of the resources they refer.

Highlight caret proximity elements

In this option it is set the color that will be used for the background of the current element at cursor position or the background of two elements when the cursor is between two elements.

Format and indent

Here you can set the method of format and indent that is applied when a document is saved in Author mode:

Only the modified content

The save operation formats only the nodes that were modified in Author mode.

The entire document

The save operation applies formatting to the entire document regardless of the nodes that were modified in Author mode. If the checkbox Apply also the 'Text' page 'Format and Indent' action is selected the content of the document is formatted by applying the Format and Indent action on every switch from the author editor to the text editor of the same document.

Quick up/down navigation

Up and Down arrows will skip positions between blocks and will stop on the next/previous line only if the caret is vertical.

Tags display mode

Default display mode for element tags presented in Author mode. You can choose between Full Tags with Attributes, Full Tags, Block Tags, Inline Tags, Partial Tags and No Tags.

Tags background color

Allows you to configure the author tags background color.

Tags foreground color

Allows you to configure the author tags foreground color.

Schema aware

The Schema aware preferences panel is opened from menu WindowPreferencesAuthor+Editor+Author+Schema aware

Figure 17.10. The <oXygen/> Schema aware preferences panel

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 WindowPreferencesAuthorEditorFormatXML

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

Enable all schema aware editing options.

Off

Disable 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 behaviour 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.

If the Schema Aware Editing is On or Custom all actions that can generate invalid content will be forwarded first toward AuthorSchemaAwareEditingHandler.