Customizing Default Options

Creating an XML Options File

To create an options file, follow these steps:

1. It is recommended that you use a fresh install for this procedure, to make sure that you do not copy personal or local preferences.
2. Open Oxygen XML Editor plugin and open the Preferences dialog box .
3. Go through the options and set them to the desired defaults.
4. Go to back to the main preferences page and click Export Global Options to create an XML options file.

Using Customized Default Options

There are two methods that you can use to configure an Oxygen XML Editor plugin installation to use the customized default options from the created XML options file:

• Copy the XML Options File to the Installation Directory

  In the [OXYGEN_INSTALL_DIR], create a folder called preferences and copy the created XML options file into it (for example: [ECLIPSE-INSTALL-DIR]/plugins/com.oxygenxml.editor/preferences/default.xml, or if the plugin was installed as a drop-in: [ECLIPSE-INSTALL-DIR]/dropins/com.oxygenxml.editor/preferences/default.xml).

• Specify a Path to the XML Options File in a Startup Parameter

  Set the path to the XML options file as the value of the com.oxygenxml.default.options system property in the Eclipse configuration file ([ECLIPSE-INSTALL-DIR]/configuration/config.ini). The path can be specified with any of the following:

  • A URL or file path relative to the application installation folder. For example:

    com.oxygenxml.default.options=file\:default.xml

    This will make Oxygen XML Editor plugin look for default.xml inside the installation folder (for example: [ECLIPSE-INSTALL-DIR]/plugins/com.oxygenxml.editor/preferences/default.xml, or if the plugin was installed as a drop-in: [ECLIPSE-INSTALL-DIR]/dropins/com.oxygenxml.editor/preferences/default.xml).

  • A system variable that specifies the file path. For example:

    com.oxygenxml.default.options=file\:${system(CONFIG)}/default.xml

  • An environmental variable that specifies the file path. For example:

    com.oxygenxml.default.options=file\:${env(CONFIG)}/default.xml

  Note

  In the Eclipse configuration file, the backslash (\) is considered a special character. Therefore, use forward slashes for separators inside the file path.