7.10. General options

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.

Note

  • On a Mac or on a Windows computer having a HiDPI (Retina®, UHD, “4K”, etc) screen, always use system settings; do not use custom settings.

  • On a Linux computer having a HiDPI screen, HiDPI is not automatically detected, so you'll anyway have to use custom settings.

  • Only the “system” Look&Feel supports 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 does not 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: the “system” Look&Feel. On Linux computers, the “system” Look&Feel is considered to be the cross-platform Look&Feel (AKA Metal).

7.10.1. Features Options

Tip

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.

Enable the "File|Folder" Submenu

Check this toggle to enable the FileFolder 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 Include Tool

Check this toggle to enable EditReferenceReplace By Reference, EditReferenceInsert Reference Before, EditReferenceInsert Reference, EditReferenceInsert 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 "View|Display Images" Submenu

Check this toggle to enable the ViewDisplay 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 ToolsUse 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.

Important

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 ToolsRemark 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 ToolsRevisions submenu and the OptionsPreferences, 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 ToolsRecord Macro submenu and the ToolsExecute 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 the "Window|New Window" menu item

Check this toggle to enable the WindowNew Window menu item.

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

Feature name: NewWindow.

Enable the "XML|Convert Document" submenu

Check this toggle to enable the "Convert Document" submenu found in DocBook, XHTML and DITA Topic, Map, BookMap menus.

Enabling this feature is recommended you use XMLmind XML Editor to convert XML documents to other formats (EPUB, PDF, RTF, etc).

Feature name: ConvertDocument.

Enable the Developer Tools

Check this toggle to enable OptionsReload All Configurations and HelpMouse and Key Bindings.

Enabling this feature is recommended if you are developing an XXE configuration and want to reload it without having to restart the application.

Feature name: DeveloperTools.

Enable 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. More information about this indicator in Document cache.

Enabling this feature is recommended if you author modular documents and experience some unexplained slowness during validation.

Feature name: DocumentCacheTool.