Add a new language dictionary for CCMS Desktop spell checking

For on-premise deployments, you can add support for more languages or locales to IXIA CCMS dictionary files in the /system/dicts collection. For SaaS deployments, submit a support ticket to perform this task.

Before you begin

Ensure the language for which you are adding the new dictionary is configured in the languages.xml configuration file. You need to know the language code used there for this procedure.

About this task

Two dictionary files per language handle dictionary processing.

  • [language].aff handles the rules, such as hyphenation, prefixes, and affixes, related to the target language
  • [language].dic contains a word list for the target language

At least one default language dictionary already exists.

Important: Make configuration changes in a test environment and confirm they work before copying them to a production environment.

Procedure

  1. Download the Hunspell dictionary for a language or dialect.
    A popular resource for the Hunspell dictionaries can be found on SourceForge. Go to: https://github.com/wooorm/dictionaries, and then click Clone or download > Download ZIP.
  2. Open the downloaded zip file, and choose the appropriate language folder.
  3. Transfer the index.aff and index.dic from that folder to your local system.
  4. Rename the index.aff and index.dic files so that they are identifiable as a separate language or dialect.
    The filename you choose must exactly match the language code used for that language and locale in the languages.xml configuration file.

    For example, if you are adding the German dictionary, rename index.aff and index.dic to de-de.aff and de-de.dic. If you are adding a locale, such as British English, you could rename the files to en-gb.aff and en-gb.dic if those are the codes used in languages.xml.

  5. In TEXTML Administration, go to /system/dicts.
  6. Right-click on dicts, select Insert documents.
  7. Click Add file, navigate to and select the two renamed dictionary files located on your local system, then click OK.

    These are the default spelling dictionaries for the language. They do not change as users add new terms.

  8. In TEXTML Administration, go to /system/dicts/customs.
  9. Right-click on customs, and then select Insert documents.
  10. Click Add file, navigate to and select the two renamed dictionary files located on your local system, then click OK.

    These are the custom spelling dictionaries for the language. When users add new terms, they are added to these files. Spell checking is performed using a merge of the default and custom dictionaries.

  11. Open the renamed [language].dic in /system/dicts/customs.
  12. Select all of the content within the file, and delete it. Replace it with 0 in the first line of the file, followed by a carriage return. The content of the file should look like the following:
    0				
    				

    This tells the system that there are zero lines to read from in this file. This automatically increases as writers add new terms to the dictionary.

  13. Save the modified [language].dic file.
  14. Refresh the Web Server.