6.10. General options

6.10. General options
	6. The "Preferences" dialog box

Use a unique instance of XMLmind XML Editor

If this toggle is checked, a unique instance of XMLmind XML Editor is used to open all your XML documents. For example, if you double-click on the icon of an XML document in the file ``explorer'', the running instance is used to open this XML document. When this toggle is not checked, a new instance of XXE is started in order to load the document clicked upon.

If there is no running instance of XXE, a new instance is started. If the running instance is hidden by other windows or is iconified, it is made visible before opening the requested document.

This feature also works fine from the command line. For example, on Linux, if this toggle is checked, executing "xxe mydoc.xml &" will cause the running instance to be used to open mydoc.xml.

If you need to change this option, make sure to close all running instances expect one. Then change the option in the last instance and close it. Then restart XXE.

Default: not checked.

Port

Specifies the TCP/IP port used by different instances of XXE to communicate with each other. It is highly recommended to use a port in the dynamic/private range: 49152 to 65535.

Default: 49987

Automatically reopen last opened documents

This option is examined just after XXE is started, when no documents to be opened have been explicitly specified (e.g. by double-clicking on an XML file or by using command line options).

When turned on, this option forces XXE to reopen all the last documents opened during the preceding editing session. The tab order and view layout of these documents, as well as which document was the active one, are restored too. However note that if several main windows were opened, it's only the session of the last closed main window which is restored.

See also the -last command line option for a simpler alternative.

Display scaling

May be used to globally change the size of all the items comprising the user interface of XXE.

Default: system settings.

When Java™ natively supports the HiPDI screen of the computer running XXE, the "Use custom settings" slider is disabled (grayed). When this is the case, the only way to change the display scaling of XXE is to change the display scaling of the operating system using the control panel.
On some Linux computers having HiDPI screens, HiDPI is not automatically detected nor natively supported by Java™. When this is the case, you'll have to use the "Use custom settings" slider. Fortunately, this setting is done once for all.
Only the “system” Look&Feel is guaranteed to support a display scaling larger than 100%. This system Look&Feel corresponds to the "(default)" choice of the Style combobox. For example, the Nimbus Look&Feel is not guaranteed to support a display scaling larger than 100%.

Locale

May be used to force the language used in XXE menus and dialog boxes. For example, may be used to force the use of English on a machine where the default locale is German.

Default: default locale of the machine running XXE.

Style

May be used to change the Look&Feel of XXE user interface.

Default: on Linux, "FlatLight", that is, the FlatLaf Look & Feel and its light theme. This Look & Feel is found in the "FlatLaf Look and Feel" add-on which installed by default. On any other platform, the “system” Look&Feel.

6.10.1. Features Options


	Most features are preselected by default. If you don't need a feature, it's strongly recommended to uncheck the corresponding toggle and then restart XXE. Doing this simplifies the user interface and slightly improves XXE startup time.

Evaluate XMLmind XML Editor Professional Edition features

This check box is found only in XMLmind XML Editor Personal Edition™. This check box is initially checked to make it easy evaluating the features implemented by the File → Import DOCX menu entry and the Convert Document submenus.

However, if you are not evaluating XMLmind XML Editor Professional Edition and just want to use a free, streamlined, fully functional, XML editor, simply uncheck this check box, restart XXE and the File → Import DOCX menu entry and the Convert Document submenus will go away.

Feature names: ImportDOCX, ConvertDocument.

Enable the "Window|New Window" menu item

Check this toggle to enable the Window → New Window menu item.

Enabling this feature is recommended if you work on many documents at the same time.

Feature name: NewWindow.

Enable the "File|Folder" submenu

Check this toggle to enable the File → Folder submenu.

Enabling this feature is recommended if you routinely have to manipulate many files or if you need to search files by their names and/or by their XML contents or if your files are stored on remote servers.

Feature name: OpenFolder.

Enable the "Edit|Force Deletion" menu item

Check this toggle to enable the Edit → Force Deletion menu item and also the "Force Removal" popup menu item in the Attributes tool.

Enabling this feature is not recommended as it is almost never useful and can make your document invalid.

Feature name: ForceDeletion.

Enable the Include Tool

Check this toggle to enable Edit → Reference → Replace By Reference, Edit → Reference → Insert Reference Before, Edit → Reference → Insert Reference, Edit → Reference → Insert Reference After and the Include tool.

Enabling this feature is recommended if you need to insert boilerplate content in your documents.

Feature name: IncludeTool.

Enable the "Search|Web Search" submenu

Check this toggle to enable the Search → Web Search submenu.

Enabling this feature is recommended if you are looking for very convenient writing tools.

Feature name: WebSearch.

Enable the "View|Display Images" submenu

Check this toggle to enable the View → Display Images submenu.

Enabling this feature is recommended if your documents include many high-resolution images.

Feature name: ImageViewportMode.

In the styled view, render audio and video elements by embedding a media player

When this feature is enabled, XHTML 5, DITA and DocBook 5.1 audio and video elements are rendered by embedding a media player in the styled view. This media player is similar to those found in Web browsers.

Enabling this feature has no effect whatsoever if the Java™ runtime used to run XXE does not support JavaFX®, hence is older than version 1.8.0_40.

Also note that JavaFX® is not supported on Windows XP because Java™ 1.8 is not officially supported by Oracle® on this operating system.

Feature name: MediaPlayer.

Enable the "Tools|Use as Master Document" menu item

Check this toggle to enable the Tools → Use as Master Document menu item.

Enabling this feature is recommendedRecommended if you author modular documents as this feature makes it easy and safe creating and checking cross-references in module documents.


	This feature is required if you use attributes `keyref` and/or `conkeyref` in your DITA documents.

Feature name: MasterDocument.

Enable the "Tools|Remark" submenu

Check this toggle to enable the Tools → Remark submenu.

Enabling this feature is recommended if you need to comment documents written by others.

Feature name: Remark.

Enable the "Tools|Revisions" submenu

Check this toggle to enable the Tools → Revisions submenu and the Options → Preferences, Tools|Revisions group of options.

Enabling this feature is recommended if you need to review the changes made to your documents by others.

Feature name: Revisions.

Enable the "Tools|Record Macro" submenu

Check this toggle to enable the Tools → Record Macro submenu and the Tools → Execute Command menu item.

Enabling this feature is recommended if you are a power user who wants to automate sequences of actions.

Feature name: Macro.

Enable all advanced tools including the Document Cache Indicator

Check this toggle to display in the status bar an indicator allowing to monitor the activity of the document cache of XMLmind XML Editor. Enabling this feature is recommended if you author modular documents and experience some unexplained slowness during validation. More information about this indicator in Document cache.

Enabling this feature also adds a few menu entries for some of the XXE configurations. For example, it adds CSS stylesheet "Show info about included elements" to the View menu when DITA, DocBook, XHTML documents are opened in XXE.

Feature name: AdvancedTools.


6.9. Install add-ons options		6.11. Advanced options