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 in English and French. In standard scenario, if English is set as a language for checking, only English words will be processed properly, while the French words will be underlined, and the suggestions will be given from the similar English ones which is not correct. To check the words in French, you need to change the language so that WebSpellChecker starts processing these words the same way as the words in English. Using the example below you can create a bilingual dictionary, for example, English-French where one of the languages will be used as a dictionary for suggestions and combination of two languages, namely English-French and French-English will be used for checking.

For our example, the suggestions will be available only for the main language we have specified while we still perform checking for two languages and provide suggestions only for one. We may need this when you have a text in English with some add-ons in French. You may need to check the text in English and want to hide the suggestions and underlining for words in French. But you can still have the spelling suggestions for two languages while the grammar suggestions are provided for one language only.

To create bilingual dictionaries:

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

2. 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>

3. 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.

4. 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.

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

en_FR = English French
fr_EN = French English

6. As soon as the modifications are completed, restart AppServer, namely stop and then start it for the changes to take effect.