6.8. Tools options

6.8.1. Master document options

Master documents

Lists all XML documents which should be automatically made master documents. This list applies to documents which otherwise would not be automatically made master documents, typically DocBook modular documents.

Maps (e.g. DITA map, DocBook assembly) are automatically made master documents

If checked, maps of all kinds (that is, DITA maps, DocBook 5.1 assemblies and Ebooks) are automatically made master documents.

Default: checked.

Except for the following maps

Lists all XML documents which should not be automatically made master documents. If above "Maps are automatically made master documents" is checked, this list applies to maps which otherwise would be automatically made master documents.

Click Remove to remove selected entry from a list. Click Remove All to clear a list.

Note that removing an entry from a list has no immediate effect on an already opened master document. You'll have to close the master document and then reopen it to see the effect.

6.8.2. Validate options

Filter duplicate ID errors found in modular documents

Pasting in a document two references to the same element will cause the Validity tool to display duplicate ID errors. This is a problem because the author didn't do any mistake by pasting these two references and because too many of these ``false'' duplicate ID errors may hide real duplicate ID errors. That's why turning on this option will discard such ``false'' duplicate ID errors from the Validity tool.

Default: checked.

Automatically show Validity tool

Document validity is automatically checked each time a document is opened or saved to disk. If this toggle is checked, when validity errors are found in the document to be opened or saved, the Validity tool “tab” is automatically selected in order to display the error messages.

Default: checked.

Only for the most severe validity errors

Ignored unless "Automatically show Validity tool" is checked. If this toggle is checked, do not automatically select the Validity tool “tab” when the document being checked for validity has just cross-reference errors or semantic warnings.

Default: checked.

6.8.3. Spell options

Activation of the automatic (AKA on-the-fly) spell checker:

Never activate the automatic spell checker

When a document is opened, never activate the automatic spell checker, even if this is specified in the configuration file associated to the opened document.

Default: not checked.

Always activate the automatic spell checker

When a document is opened, always activate the automatic spell checker, even if this is not specified in the configuration file associated to the opened document.

Default: not checked.

Activate if this is specified in the configuration file

When a document is opened, activate the automatic spell checker if this is specified in the configuration file associated to the opened document (using the spellCheckOptions configuration element, see Section 29, “spellCheckOptions” in XMLmind XML Editor - Configuration and Deployment).

Default: checked.

6.8.4. Revisions options

You may need to enable this group of options by checking "Enable the 'Tools|Revisions' Submenu" in OptionsPreferences, General|Features section.

When a document is created or opened:
Do not automatically keep information about revisions

Do not do anything special to deal with document revisions when a document is created or opened in XXE.

Default: checked.

Automatically enable the comparison of revisions

When a document is created or opened in XXE, automatically add information[8] allowing to compare two revisions of this document.

Default: not checked.

Automatically store all revisions in the document

When a document is created or opened in XXE, start storing all the revisions[9] in the XML file containing this document.

Turning on this option implies turning on option "Automatically enable the comparison of revisions". If all revisions are stored in the XML file, then you'll be able to use open them using ToolsRevisionsOpen Revision and to compare them using ToolsRevisionsCompare Revisions.

Default: not checked.

6.8.5. Helper applications options

File types

List of file types. Each file type has an associated helper application. This helper application is assumed to be able to open files detected as having this type. A helper application may be a viewer or an editor.

The following buttons may be used to modify this list:

Add

Displays the "Helper Application Editor" dialog box in order to add a new file type to the list.

Edit

Displays the "Helper Application Editor" dialog box in order to view or modify selected file type.

Remove

Removes selected file type from the list.

Default viewer

Specifies which default viewer to use in case the type of the file to be opened has not been detected. In practice, commands making use of the default viewer typically assumes that it is in fact a Web browser. This implies that these commands assume that a default viewer can open URLs as well as filenames and that it can open text, HTML, GIF, PNG and JPEG files.

This field must contain a command line interpreted by the native shell of the platform: cmd.exe on Windows and /bin/sh on the Mac and on Unix.

This command line must reference one of these two substituted variables: %U and %F. In principle, %U is replaced by the URL of the file to be opened by the helper application and %F is replaced by a filename. In practice, %U is just a hint meaning: the helper application can open URLs as well as filenames.

Default: depends on the platform:

  • On Windows: start "" "%U"

  • On the Mac: open "%U"

  • On Unix: dynamically detected. For example: firefox "%U"

The following buttons may be used to modify this field:

Reset

Resets the field to its default value (see above).

Choose

Displays the standard file chooser in order to specify an application (e.g. a .exe or a .bat file on Windows). String " "%F"" is automatically appended to the chosen application.

See also Helper applications on the Mac.