Editor

The Editor preferences panel is opened from menu WindowPreferencesAuthor+Editor

Use these options to configure the visual aspect of the text editor. The same options panel is available in the restricted version of the Preferences dialog.

Figure 15.6. The Editor preferences panel

The Editor preferences panel

Editor background color

Use this option to set the background color of the editor.

Completion proposal background

Use this option to set the background color for the content completion window.

Completion proposal foreground

Use this option to set the foreground color for the content completion window.

Documentation window background

Use this option to set the background color for the window containing documentation for the content completion elements.

Documentation window foreground

Use this option to set the foreground color for the window containing documentation for the content completion elements.

Line Wrap (disables folding)

This option will do a soft wrap of long lines, that is automatically wrap lines in edited documents. When this option is checked line folding will be disabled.

Highlight matching tag

This option enables highlight for the tag matching the one on which the caret is situated.

Enable folding when opening a new editor

If checked, it enables folding when a new editor is opened.

Minimum fold range (only for XML)

If "Enable folding when opening a new editor" is checked, you can specify the minimum number of lines for folding. If you modify this value, you'll notice the changes when you open/reopen the editor.

Author

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

Figure 15.7. The oXygen Author preferences panel

The oXygen Author preferences panel

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.

Show caret position info

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.

Delete tag action

Specifies the default behavior when you delete the start or end marker of an element. You can choose between:

  • Always ask

  • Always join

  • Always unwrap

You can read more about this in Editing the XML markup section.

Show author page warning

When checked, a warning dialog will be displayed when switching to Author mode. The warning reminds you that the whitespaces from the text content are evaluated according to the value of the CSS white-space property associated to the enclosing elements.

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.

Show confirmation when opening a reference from the DITA Maps Manager

If checked a dialog will be shown allowing the user to choose if he wants to open the referred topic in the text or author page when the topic is opened from the DITA Maps Manager.