Preferences

Once the application is installed you can use the Preferences dialog accessed from OptionsPreferences to customize the application for your requirements and network environment.

There is a search field available in the dialog for selecting only the preferences panels containing required words in the panel title or in the text of a label or a button contained in the panel.

 

Figure 17.1. The Search field from the Preferences dialog

The Search field from the Preferences dialog

You can always revert modifications to their default values by using the Restore Defaults button, available in each preference page.

 Global

 

Figure 17.2. The Global preferences panel

The Global preferences panel

Automatic Version Checking

When enabled, checks the availability of new <oXygen/> versions at http://www.oxygenxml.com. .

Language

The application supports a number of languages for localization of the GUI. Select OptionsPreferencesGlobal+Language drop-list to display the language choices.

[Note]Note

After restarting the application, if some GUI labels are not rendered correctly you will need to install the corresponding language pack from your OS installation kit.

Other language

To change the user interface language of <oXygen/> you must set here the properties file with all the user interface messages and labels translated to your preferred language. For details about creating this file see the section describing the creation process. After setting the file you have to restart <oXygen/> in order to change the user interface language to your preferred language.

Look and Feel

Use this option to change graphic style (look and feel) of the GUI.

Styles

On Windows there are available the following styles:

  • Office 2003

  • Vsnet

  • Eclipse

  • Xerto

  • Default

[Note]Note

After changing the style one has to restart the application in order for the modification to take effect.

On Linux there are available the following styles:

  • Eclipse

  • Default

[Note]Note

After changing the style one has to restart the application in order for the modification to take effect.

On Mac OS X this option is not available.

Themes

On Windows this option is enabled only if the Office 2003 or Default styles. In these cases, the following themes are available:

  • NormalColor

  • HomeStead

  • Metallic

  • Default

  • Gray

On Linux this option is not available.

On Mac OS X this option is not available.

Encoding for non XML files

This option defines the default encoding to be used when opening non XML documents.

BOM handling

This option defines how to handle the BOM (Byte Order Mark) on document save.

The available options are:

  • Don't Write - Don't write the BOM bytes, the loaded BOM bytes are ignored;

  • Write - Write the BOM bytes accordingly with chosen encoding;

  • Keep - If the loaded document has BOM then write them accordingly with chosen encoding. This is the default option.

Encoding errors handling

This option defines how to handle characters that cannot be represented in the specified encoding of the document when the document is opened. The available options are:

  • REPORT - Show an error dialog with the character that cannot be represented in the specified encoding and allow the user to decide how to continue (ignore that character, replace it with a standard replacement character). This is the default option.

  • IGNORE - The character is ignored and it will not be included in the document displayed in the editor panel.

  • REPLACE - Replace the character with a standard replacement character. For example if the encoding is UTF-8 the replacement character has the Unicode code FFFD, and if the encoding is ASCII the character code is 63.

Line separator

This option defines line separator to be used. The System Default choice sets the line separator from the platform.

Detect the line separator on file open

When this option is checked the editor will detect the line separator when the edited file is loaded and it will use it when the file is saved. The new files are saved using the line separator defined by the "Line separator" option.

Default Internet browser

The path to a web browser executable. The browser is used to open XSLT or PDF transformation results, to open the <oXygen/> home page or to point to specific paragraphs in the W3C recommendation of XML Schema on the W3C website in case of validation errors.

Open last edited files from project

When enabled, <oXygen/> will open the last edited files from project at start-up. Filer larger than 50 KB are not opened.

Beep on operation finished

If checked, it notifies the user through a beep that an action has ended. It will notify the user only at the end of validate, wellformed and transform actions.

Show Java vendor at startup

Sun Microsystems Java VM or Apple Computer Java VM (on Mac OS X) is required to run <oXygen/>. If a different VM is used, then a warning is generated. This option allows the user to choose whether the warning dialog is shown in this case or not.

Auto synchronize unmodified editors with file system changes

If checked, the synchronization of the unmodified editors with the system changes is done automatically, without the user's interaction.

Last visited directory

The dialog used for opening files remembers the last visited directory and the next time it starts directly in this directory.

Directory of the edited file

The dialog used for opening files starts in the directory where the currently edited file is stored.

Consider application bundles to be directories when browsing

This option is available only on the Mac OS X platform. When checked the file browser dialog allows browsing inside an application bundle as in a regular folder. When unchecked the file browser dialog does not allow browsing inside an application bundle, as the Finder application does on Mac OS X. The same effect can be obtained by setting the property apple.awt.use-file-dialog-packages to true or false in the Info.plist descriptor file of the <oXygen/> application by adding two lines in this descriptor file:

<key>apple.awt.use-file-dialog-packages</key>
<string>false</string>