Using Check Spelling

The Check Spelling option ( XMLCheck Spelling (Ctrl+Shift+Q) or the toolbar button Check spelling ) enables you to perform the check spelling on the current document:

Figure 20.2. Check Spelling Dialog

Check Spelling Dialog

Complete the dialog as follows:

Unrecognized Word

Contains the word that cannot be found in the selected dictionary. The word is also highlighted in the XML document.

Replace with

The character string which is suggested to replace the unrecognized word.

Guess

Displays a list of words suggested to replace the unknown word. Double clicking a word in this list automatically inserts it in the document and continues the spell checking process.

Dictionary

Displays a list with the available dictionaries.

Replace

Replaces the currently highlighted word in the XML document, with the selected word in the "Replace with" field.

Replace All

Replaces all occurrences of the currently highlighted word in the XML document, with the selected word in the "Replace with" field.

Ignore

Allows you to continue checking the document while ignoring the first occurrence of the unknown word. The same word will be flagged again if it appears in the document.

Ignore all

Ignores all instances of the unknown word in the whole document.

Learn

Includes the unrecognized word in the list of valid words so that the spell checker will not consider it for correction.

Options

Sets the configuration options of the Spell Checker.

Begin at caret position

When checked, the spell checker begins checking from the current cursor position.

OK

Closes the Spell Checker dialog.

Adding a spell dictionary

There are two spell checking engines available in <oXygen/>: Hunspell and AZ Check. For the Hunspell checker <oXygen/>comes with the following built-in dictionaries: English (US), English (UK), French, German (both old and new orthography), Spanish. For the AZ Checker the following language dictionaries are available: English (US), English (UK), English (Canada), French (France), French (Belgium), French (Canada), French (Switzerland), German (old orthography), German (new orthography), Spanish.

The format of the spell dictionary files is different for the two engines. If you want to add a dictionary for a language that is not supported by the built-in dictionaries you have to add the dictionary file as specified below and restart <oXygen/> for using the new dictionary.

Adding a Hunspell dictionary

The Hunspell spell checker is open source and has LGPL license. The format of the Hunspell spell dictionary is supported by the applications Mozilla, OpenOffice and Chrome browser. If your language is not included in the list of built-in dictionaries you can probably have a dictionary for your language you can add it with the following steps.

You add a Hunspell dictionary with the following steps:

Procedure 20.1. Add Hunspell dictionary

  1. Download the archive with the files of your language dictionary. A dictionary has two files with the same name and different extensions: a file with .dic extension and a file with .aff extension.

  2. If it is a new dictionary (not available as built-in dictionary in <oXygen/>) you copy the .aff and .dic files to the spell subfolder of the <oXygen/> preferences folder, that is the folder [APPLICATION-DATA-FOLDER]/com.oxygenxml/spell. For example on Windows XP APPLICATION-DATA-FOLDER is C:\Documents and Settings\[LOGIN-USER-NAME]\Application Data, on Windows Vista APPLICATION-DATA-FOLDER is C:\Users\[LOGIN-USER-NAME]\AppData\Roaming, on Mac OS X APPLICATION-DATA-FOLDER is [USER-HOME-FOLDER]/Library/Preferences.

  3. If it is an existing dictionary you copy the .aff and .dic files into the folder [OXYGEN-INSTALL-FOLDER]/dicts.

  4. Restart the application after copy the dictionary files.

Adding an AZ Check dictionary

AZ Check dictionaries are in the form of .dar files located in the directory [oXygen-install-dir]/dicts. A pre-built dictionary can be added by copying the corresponding .dar archive to the same directory and restarting <oXygen/>. A dictionary can be built with the tool available at http://www.xmlmind.com/spellchecker/dictbuilder.shtml.

Learned words are stored into an persistent learned-words dictionary with the .tdi extensions located in:

  • directory on Windows XP

    Note

    If you cannot find the com.oxygenxml folders, please check the Roaming folder from the Application Data.

  • directory on Windows Vista

  • directory on Mac OS X