Configuring Bilingual Spell Checking

Steps described in this section are applicable only for the Server version of WebSpellChecker and 16 supported default languages except Ukrainian. 

If your WebSpellChecker products setup is configured to perform spell checking on large amount of content in several languages, you may want to improve your web apps performance. A workaround for it can be reducing the number of errors by consolidating two or more languages into a single dictionary following the procedure described in this section. 

Let’s assume that we have mixed content containing the words both in English and French. In this scenario you will most likely prefer to: 

• check the text for words in English as it is set as a primary language for checking; 
• hide the suggestions and underlining for words in French as the suggestions are provided for the similar English words which is not correct for French. 

WebSpellChecker provides the spelling suggestions for two languages while the grammar suggestions are provided for English language only. To check the words in French, you need to change the language so that these words are processed the same way as the words in English. To do so, we will create a bilingual dictionary, namely, English-French. In this dictionary: 

• one of the languages will be used as a dictionary for grammar suggestions; 
• combination of two languages which is English-French while and French-English will be used for checking.

To create bilingual dictionaries:

1. Stop AppServer before making any changes to AppServerX.xml file.

2. Locate and open the AppServerX.xml configuration file. The default path to AppServerX.xml file is <WebSpellChecker_Installation_Path>/AppServer/AppServerX.xml

3. Add a new language named English-French by specifying the following settings:

• Language used for grammar checking
• Language used for spell checking
• Dictionaries used to generate spelling suggestions

To do so, in the file, scroll down to the section with Languages tag parameters and add the following inside this tag:

<Language Id="en_FR">
	<!-- English French -->
	<GrammarCheckProviderOptions>en-US</GrammarCheckProviderOptions>
	<SpellEngineOptions>
		<SpellCheckProvider>ssce</SpellCheckProvider>
		<!--American English dictionaries -->
		<Dictionary FullPath="ssceam2.clx">
			<ForSuggest>no</ForSuggest>
		</Dictionary>
		<Dictionary FullPath="ssceam2s.clx">
			<ForSuggest>yes</ForSuggest>
		</Dictionary>
		<Dictionary FullPath="sscema2.clx"/>
		<Dictionary FullPath="keywords.clx"/>
		<Dictionary FullPath="ssceam.tlx"/>
		<!--French dictionaries -->
		<Dictionary FullPath="sscefr2.clx">
			<ForSuggest>no</ForSuggest>
		</Dictionary>
		<Dictionary FullPath="sscefr.tlx">
			<ForSuggest>no</ForSuggest>
		</Dictionary>
	</SpellEngineOptions>
</Language>
           
<Language Id="fr_EN">
	<!-- French English -->
	<GrammarCheckProviderOptions>fr</GrammarCheckProviderOptions>
	<SpellEngineOptions>
		<SpellCheckProvider>ssce</SpellCheckProvider>
		<Options>
		<SplitContractedWords>1</SplitContractedWords>
		</Options>
	<!-- French dictionaries -->
	<Dictionary FullPath="sscefr2.clx"/>
	<Dictionary FullPath="sscefr.tlx"/>
	<!-- American English dictionaries -->
	<Dictionary FullPath="ssceam2.clx">
		<ForSuggest>no</ForSuggest>
	</Dictionary>
	<Dictionary FullPath="sscema2.clx">
		<ForSuggest>no</ForSuggest>
	</Dictionary>
	<Dictionary FullPath="keywords.clx">
		<ForSuggest>no</ForSuggest>
		</Dictionary>
		<Dictionary FullPath="ssceam.tlx">
			<ForSuggest>no</ForSuggest>
		</Dictionary>
	</SpellEngineOptions>
</Language>

4. Disable grammar checking by removing the GrammarCheckProviderOptions tag for the specific language if you have discovered any issues with grammar checking. For example, if you need to disable grammar for English-French bilingual dictionary, remove the <GrammarCheckProviderOptions>en-US</GrammarCheckProviderOptions> tag from the corresponding language parameters group in the Language tag.

5. Locate and open text_en_US.txt file in the WebSpellChecker installation folder on your server. This file contains language locale settings and enables specifying the language of WProofreader Languages tab. The default path to text_en_US.txt file is <WebSpellChecker_Installation_Path>/WebSpellChecker/WebComponents/WebInterface/text.

6. Add the following to the text_en_US.txt file:

en_FR = English French
fr_EN = French English

7. As soon as the modifications are completed, start AppServer for the changes to take effect.