23. spellCheckOptions

<spellCheckOptions
  useAutomaticSpellChecker = boolean
  languageAttribute = QName
  defaultLanguage = language
  checkComments = boolean
  checkedProcessingInstructions = list of Names
  checkedAttributes = list of XPath (subset)
  skippedElements = list of XPath (subset)
/>

Specifies, on a per document type basis, options for the spell checker. Used by both the automatic (AKA on-the-fly) and the ``traditional'' spell checkers.

useAutomaticSpellChecker

If true, the automatic spell checker must be automatically activated each time a document of that type is opened.

Default: false; see language lookup.

This setting may be overridden by the user with Options|Preferences, Tools|Spell section, Automatic Spell Checker radio buttons.

languageAttribute

Specifies which attribute, if any, specifies the language of an element and all its descendants. This is typically xml:lang or lang.

Default: there is no such attribute; see language lookup.

defaultLanguage

Specifies the default language of a document of that type. (This option is rarely used.)

Default: no default language; see language lookup.

Note

XMLmind XML Editor determines the language of an element by examining, in that order:

  1. the value of the attribute specified by option languageAttribute. Note that the attribute lookup starts at current element and ends at the root element of the document,

  2. the value of option defaultLanguage,

  3. the value selected in the Default language combobox of the Spell tool.

checkComments

Specifies whether comments must be checked for spelling.

Default: do not check comments.

checkedProcessingInstructions

Specifies the targets of processing instructions which must be checked for spelling. May be an empty list, which means: do not check processing instructions.

Default: do not check processing instructions.

checkedAttributes

Specifies the XPaths (subset) of attributes which must be checked for spelling. May be an empty list, which means: do not check attributes.

For efficiency reasons, an XPath whose last step does not test an attribute name is ignored. For example, "foo/@*" is ignored.

Default: do not check attributes.

skippedElements

Specifies the XPaths (subset) of elements which must be automatically skipped by the spell checker. May be an empty list, which means: do not skip any element.

For efficiency reasons, an XPath whose last step does not test an element name is ignored. For example, "foo//*" is ignored.

Default: do not skip any element.

Examples (DocBook V4, XHTML, XHTML/RELAX NG):

 <cfg:spellCheckOptions xmlns=""
    useAutomaticSpellChecker="true"
    languageAttribute="lang"
    skippedElements="address funcsynopsisinfo classsynopsisinfo 
                     literallayout programlisting screen synopsis" />

  <cfg:spellCheckOptions xmlns=""
    useAutomaticSpellChecker="true"
    languageAttribute="xml:lang"
    skippedElements="pre style script" />

  <cfg:spellCheckOptions xmlns:html="http://www.w3.org/1999/xhtml"
    useAutomaticSpellChecker="true"
    languageAttribute="xml:lang"
    skippedElements="html:pre html:style html:script" />

Note that a spellCheckOptions element does not replace the spellCheckOptions element previously found in a configuration file. When a configuration file contains several spellCheckOptions elements, these spellCheckOptions elements are merged.

Example:

<cfg:spellCheckOptions xmlns=""
    useAutomaticSpellChecker="true"
    languageAttribute="xml:lang"
    skippedElements="pre script" />
        .
        .
        .
<cfg:spellCheckOptions xmlns=""
    languageAttribute="xml:lang"
    defaultLanguage="en-US"
    checkComments="true"
    checkedProcessingInstructions="annotation remark"
    checkedAttributes="@alt table/@summary table/@title" />

is equivalent to:

<cfg:spellCheckOptions xmlns=""
    useAutomaticSpellChecker="true"
    languageAttribute="xml:lang"
    defaultLanguage="en-US"
    checkComments="true"
    checkedProcessingInstructions="annotation remark"
    checkedAttributes="@alt table/@summary table/@title"
    skippedElements="pre script">