Page History

The suggestion prioritization mechanism is designed to allow the admins to influence and change the default behavior of how the corrections are generated and showed shown to end users. Using this mechanism, the admins can create a list of rules which will be used during the process of generating corrections.

...

• Common spelling errors (e.g. “teh” –> “the”)
• Synonyms and alternatives

Rules

...

categories

There is a list of main categories that can be used to create your custom rules for the suggestion prioritization.

Syntax and

...

configuration File

All the rules should be written in a special *.ini configuration file. 

Configuration

...

file

The configuration file for the suggestion prioritization mechanism must match the next requirements.

• File format: *.ini
• Encoding: UTF-8
• Target location: [WebSpellChecker_Installation_Folder]/AppServer/
• Example of file name: “suggestions_prioritization_rules_lang_shortcode.ini”. Here is a list of all available languages with their short codes.

You can have more than one configuration file with rules for different languages. Also, you can reuse a single file with rules for a list of languages which might have the same rules (e.g. English dialects).

Syntax

The syntax of the configuration file with rules for the suggestion prioritization must follow the next requirements.

...

END_OF_THE_WORD
z s
ENTIRE_WORD
teh the

Getting

...

started

Once a new configuration file with the rules is ready and placed in the [WebSpellChecker_Installation_Folder]/AppServer/ folder. The next step is to enable the suggestion prioritization mechanism in the AppServerX.xml file.

...

3. In the list of all available parameters for AppServer, locate the SuggestionsPrioritization (previously CustomSuggestionsPrioritization) tag which is responsible for the suggestion prioritization mechanism. By default, the tag is commented.

4. Uncomment the section with the CustomSuggestionsPrioritization tag and fill in the information in the sub-tags as follows:

• LangID (previously Lang) – this parameter sets the short code of the language for which the suggestion prioritization mechanism with the defined configuration file will be applied.
• ConfigFile (previously ConfigFileName)– this parameter specifies the name of the configuration file which will be used for the suggestion prioritization mechanism.
• AdvancedSearch – this parameter enables the advanced search of the suggestions using not only the initial suggestion list given by the engine but also the language dictionaries, global custom and personal user dictionaries.

...
<CustomSuggestionsPrioritization>
<SuggestionsPrioritization>
     <PrioritizationEnable>true</PrioritizationEnable>
<!-- Rules for each language -->
     <PrioritizationLang>
   <Lang>en  <LangId>en_US</Lang>LangId>
       <ConfigFileName>suggestions<ConfigFile>suggestions_prioritization_rules_en_US.ini</ConfigFileName>ConfigFile>
     <AdvancedSearch>ON<<AdvancedSearch>true</AdvancedSearch>
     </CustomSuggestionsPrioritization>PrioritizationLang>
</SuggestionsPrioritization>
...

If you want to use the suggestion prioritization mechanism for several languages and have separate configuration files, you need to duplicate the CustomSuggestionsPrioritization PrioritizationLang tag (see example below). 

...
<CustomSuggestionsPrioritization>
<SuggestionsPrioritization>   
     <PrioritizationEnable>true</PrioritizationEnable> 
      <!-- Rules for each language -->
     </PrioritizationLang>
     <Lang>en   <LangId>en_US</Lang>LangId> 
      <ConfigFileName>suggestions  <ConfigFile>suggestions_prioritization_rules_en_US.ini</ConfigFileName>ConfigFile>
       <AdvancedSearch>ON< <AdvancedSearch>true</AdvancedSearch>
     </CustomSuggestionsPrioritization>PrioritizationLang>

<CustomSuggestionsPrioritization>
     <PrioritizationLang>
         <Lang>fr<LangId>ar_FR<SA</Lang>LangId>
       <ConfigFileName>suggestions  <ConfigFile>suggestions_prioritization_rules_frar_FRSA.ini</ConfigFileName>ConfigFile>
        <AdvancedSearch>ON< <AdvancedSearch>true</AdvancedSearch>
     </PrioritizationLang>
</CustomSuggestionsPrioritization>SuggestionsPrioritization>
...

5. Once all the changes are done, save the file and start AppServer.