5.7. Tools options

5.7.1. 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 the document is saved to disk. If this toggle is checked, when validity errors are found, the Validity tool ``tab'' is automatically selected in order to display the error messages.

Default: not checked.

5.7.2. Document Set options

The following options specify which actions are to be automatically performed by XXE after a document set is opened using FileDocument SetOpen Document Set and/or after a document set is explicitly refreshed using Refresh.

Automatically update all inclusions in member documents

Turning on this option is useful only if your DITA topics make use of attribute conkeyref.

Default: not checked.

Automatically redraw member documents

Turning on this option is useful only if your DITA topics make use of attribute keyref and when some of the keyrefs point to image files.

Default: not checked.

Automatically validate member documents

Turning on this option is generally recommended.

Default: checked.

5.7.3. Spell options

Options used by both the automatic and ``traditional'' spell checkers:

Ignore case

If this toggle is checked, ignore capitalization errors.

Default: not checked.

Ignore mixed-case words

If this toggle is checked, do not check words containing case mixing (e.g. "SpellChecker").

Default: not checked.

Ignore words with digits

If this toggle is checked, do not check words containing digits (e.g. "b2b").

Default: checked.

Ignore URL-like words

If this toggle is checked, ignore words looking like URLs or file names (e.g. "www.xxx.com" or "c:\boot.ini").

Default: checked.

Ignore duplicate words

If this toggle is checked, do not signal two successive identical words as an error.

Default: not checked.

Check punctuation

If this toggle is checked, punctuation checking is enabled: misplaced white space and wrong sequences, like a dot following a comma, are detected.

Default: not checked.

Allow compounds words

If this toggle is checked, all words formed by concatenating two legal words with an hyphen are accepted. If the language allows it, two words concatenated without hyphen are also accepted.

Default: checked.

Allow general prefixes

If this toggle is checked, a word formed by concatenating a registered prefix and a legal word is accepted. For example if "mini-" is a registered prefix, accepts "mini-computer".

Default: checked.

Allow file extensions

If this toggle is checked, accepts any word ending with registered file extensions (e.g. "myfile.txt", "index.html", etc).

Default: checked.

Favor quality over speed

For use on a fast computer. Does not influence the number of suggestions (always limited to 15).

Default: not checked.

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

This group of options is present only in XMLmind XML Editor Professional Edition.

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 26, “spellCheckOptions” in XMLmind XML Editor - Configuration and Deployment).

Default: checked.

5.7.4. 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.

Default: the "text/plain" file type:

  • On Windows: text/plain:txt:::notepad "%F"

  • On the Mac:

    • for a version older than Mac OS X 10.5 (e.g. Tiger): open -t "%F",

    • starting from Mac OS X 10.5 (Leopard): open -W -n -t "%F".

    See also Helper applications on the Mac.

  • On Unix: text/plain:txt:::xterm -e vi "%F"

Buttons acting on 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. By default: firefox "%U"

Buttons acting on 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.

5.7.5. Spreadsheet options

This group of options is available only in XMLmind XML Editor Professional Edition, where it is hidden by default. You need to enable it by checking "Enable the Integrated Spreadsheet Engine" in OptionsPreferences, Features section.

Open spreadsheets in auto-update mode

Specifies that spreadsheets are to be opened in auto-update mode.

In manual update mode, only newly inserted formulas are computed. To force a full calculation, the user has to explicitly use ToolsSpreadsheetUpdate.

In auto-update mode, a full calculation is automatically performed, if needed to, when the editing context changes. For example: type some text in a paragraph, then click in (or tab to) another paragraph to trigger a spreadsheet calculation.

Note that in both modes, a full calculation is automatically performed, if needed to, before validating or saving the document.

Using manual update mode is recommended if you have a slow computer or if you have inserted a lot of formulas in your document or if your formulas access many external documents.

Default: checked.

Maximum number of iterations allowed for calculations in spreadsheet

Specifies the maximum number of iterations allowed for calculations in spreadsheet. This limit is used to prevent the spreadsheet engine from looping in case of cycles in formulas.

Default: 20.