All of the options that appear on the Spell check tab of the Pro tool are described below.
By default certain types of words are not spell checked. This includes words that are all upper case (e.g. NASA), words that are mixed case (e.g. SpellCheck), words that contain digits (e.g. Homer6), words surrounded by characters other than quote marks (e.g. <table>), and words within <samp>, <code>, and <kbd> tags. Use the 'UPPER CASE words', 'MixeD CaSe words', and so on, options to include these types of words in the spell checking.
Words within attributes are also not normally checked. However you can use the 'Include attributes' option to spell check text within displayable attributes such as : alt, title, summary, label, prompt, and standby.
By default if the web page has a language specified and this language is not compatible with the language chosen for spell checking, then a warning is added to the page and the spell check skipped. But with the 'Ignore web page language' option you can force the spell check to proceed whatever the language of the web page. For reference:
- American or British spell check runs when web page language set to 'en' or 'eng'
- French spell check runs when web page language set to 'fr', 'fre', or 'fra'
- Italian spell check runs when web page language set to 'it' or 'ita'
- Spanish spell check runs when web page language set to 'es', 'esl', or 'spa'
- German spell check runs when web page language set to 'de', 'deu', or 'ger'
Enter the path to a file containing a list of your own words to supplement the standard dictionaries or to replace them. You can easily create such a file by clicking on the words in the validation results that are marked as not recognised.
If you select a language from the Spell check option then this dictionary will be used in addition to the standard dictionary for the selected language.
If you select 'Own dictionary' from the the Spell check option, then this dictionary will be the only one used for performing the spell check.
In this way you could either check against a language not currently supported, or add your own set of industry specific words for the area your website covers.
Your dictionary file must be a plain text file consisting of one word per line, with no duplicates, and must be saved using UTF-8 encoding.
When a word is not found in the dictionary a list of suggestions is normally presented. But with the 'Ignore suggestions' option you can suppress this list.
To allow you to quickly create your own dictionary of additional words the 'Save misspelt words' option will save all of the words not found by the spell checker into a separate file. This text file may then be edited and used as an extra dictionary.
Note that this file is reused each time you run a validation with this option and the result after each validation will be a sorted list of words with no duplicates. So you may wish to use a copy of this file as the extra dictionary. A file is created and used for each language and has the same name as the dictionary used for testing. It may be found within the 'dicts' subfolder next to the place where results pages are saved. For example: 'My Documents\TotalValidatorTool\dicts\ukenglish.dic.new'. Note that this file is saved using UTF-8 encoding.
When the spelling mistakes are highlighted on the validation results page, you can add these words to your own dictionary by clicking on them. This dictionary can then be specified as the Extra/Own dictionary so that the words are not highlighted in future.
Use the 'Corrections dictionary' field to enter the path to the file to store the words that will be added when you click on them on the results pages. This file must be UTF-8 encoded. If you do not enter anything here, words will be added to a file called 'own_dictionary.dic' within the 'dicts' subfolder next to the place where results pages are saved. For example: 'My Documents\TotalValidatorTool\dicts\own_dictionary.dic'. Note that this file is saved using UTF-8 encoding and words are de-duped and always stored in lower case.
As soon as you start the Pro tool it will start to listen on the 'Port' specified for clicks on results pages. The port is set to 9890 by default but can be any number in the range 1-65535. You must choose a number that does not conflict with any other service you use otherwise an error message will appear when you start the tool.
Because the tool listens for spell check corrections as soon as it is started, if you wish to change the 'Corrections dictionary' or the 'Port' you must restart the tool or click the 'Restart' button next to the 'Port' field to have any affect.
Also note that when you run a validation the value of the 'Port' is embedded in the results pages. So if you change the value of the 'Port' you must re-run your validation or when you click on the results it will not find the Pro tool.
Finally, if you do not wish to use this feature then you can turn it off using the 'Listen' checkbox.
Sometimes you may have whole pages, large areas of text, or even just individual words or phrases that you don't wish to spell check. You can achieve this by adding special instructions to your pages to tell the Total Validator to skip these special areas of text.