The Author preferences page is opened from menu .
The following options are available:
- Author default background color - Default background color of the
Author editing mode. The background-color CSS property set in the CSS file
associated with the current edited document overwrites this option.
- Author default foreground color - Default foreground color of the
Author editing mode. The color CSS property set in the CSS file associated
with the current edited document overwrites this option.
- Highlight elements near caret - Defines the background color of the
element or elements at caret position.
- Show caret position tooltip - If enabled, the caret position
information tooltip is 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
Annotations preferences
panel.
- Show placeholders for empty elements - When
enabled, placeholders are displayed for empty elements to make them clearly visible. A
placeholder is rendered as a light grey box displaying the element name.
- Show Author layout messages - If enabled, all errors reported
during layout creation are presented in the Errors view.
- Hide comments - Hides comments from the documents edited in Author
mode.
- Hide processing instructions - Hides processing instructions from
the documents edited in Author mode.
- Hide doctype - Hides doctype sections from the
documents edited in Author mode.
- Show very large images - Enables
the very large (bigger than 6 megapixels) images support in Author mode.
Disabled by default.
Important: If you enable this option and your document
contains many such images, Oxygen XML may consume all
available memory, throwing an OutOfMemory error. This means that you need to
restart the application after you increase the
available memory limit.
- Display referred content (e.g.: entities, XInclude, DITA conref,
etc.) - When enabled, the references (like entities, XInclude, DITA conref)
also display the content of the resources they refer. If you toggle this option while
editing, reload the file for the modification to take effect. Enabled by default.
- Format and indent - Here you can set the format and indent method
that is applied when a document is saved in Author mode, or when switching the editing mode
(from Text to Author or vice versa):
- Only the modified content - The Save
operation only formats the nodes that were modified in Author mode.
The rest of the
document preserves its original formatting. Selected by default.
- The entire document - The Save operation
applies formatting to the entire document regardless of the nodes that were modified in
Author mode.
If the Apply also 'Format and Indent' action as in 'Text'
edit mode option is enabled, the content of the document is formatted by
applying the Format and Indent rules from the Editor/Format/XML
option page. In this case, the result
of the Format and indent operation will be the same as when it
is applied in Text editing mode.
- Quick up/down navigation - Speeds up navigation when using up /
down keys. The cursor jumps from line to line, without stopping at intermediate positions
between element tags.
- Tags display mode - Default display mode for element tags presented
in Author mode. You can choose between:
- Full Tags with Attributes - This mode reveals the entire XML
markup, easing the transition from a Text based editing to an Author mode editing. Tags
contain element names, attribute names, and attribute values.
- Full Tags - Displays name tags that enclose block and inline
elements.
- Block Tags - Displays a mix of element name tags that enclose
block elements and compact tags that enclose the inline elements.
- Inline Tags - Displays only name tags that enclose the inline
elements.
- Partial Tags - Displays compact tags that enclose the inline
elements.
- No Tags - No tags are displayed. This representation is as
close as possible to the document published content.
- Tags background color - Allows you to configure the Author tags
background color.
- Tags foreground color - Allows you to configure the Author tags
foreground color.