For on-premise deployments, you can add support for more languages or dialects to
IXIA CCMS dictionary files in the /system/dicts
collection. For SaaS deployments, submit a support ticket to perform 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.
Note: The abbreviation used for renaming the dictionary in the following
procedure must match the language setting, such as xml:lang="en-us", within the prolog of a
map or topic.
To add a new language or dialect dictionary:
-
Locate the source of a Hunspell dictionary for a language or
dialect.
-
Open the downloaded zip file, and choose the appropriate
language folder.
-
Transfer the index.aff and
index.dic from that folder to your
local system.
-
Rename the index.aff and
index.dic files so that they are
identifiable as a separate language or dialect. The folder the files are derived
from provides the language code you should use.
For example, if you were adding the German dictionary, you could rename
index.aff and
index.dic to
de-de.aff and
de-de.dic. If you are adding a dialect,
such as British English, you could rename the files to
en-GB.aff and
en-GB.dic
instead.
Note: The name of these files should follow a 4-letter
convention similar to the ISO 639-2 language codes to describe each
language, followed by the dialect. You must use same
case for your filenames to match that of xml:lang within the map and topic templates.
-
Within TEXTML Administration, go to
/system/dicts.
-
Right-click on dicts,
select Insert documents.
-
Click Add file, select
the two renamed dictionary files located on your system, then click OK.
-
Place a second copy of these files in the /system/dicts/customs collection, which allows
you to add additional, customized words for that language.
-
Open the renamed [language].dic on your local system.
-
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.
-
Save the modified [language].dic file.
-
Within TEXTML Administration, go to
/system/dicts/customs.
-
Right-click on dicts, and
then select Insert documents.
-
Click Add file, select
the two renamed dictionary files located on your system, then click OK.
-
Within TEXTML Administration, go to
/system/conf and open languages.xml.
-
If the new language/dialect is not present, add the following
lines, where
[language] equals the 4-letter
code used by the xml:lang within the topic
templates:
<language groups="[language group name]" name="[full name of language or dialect]">
<code type="ISO-639-1">[language]</code>
<code type="ISO-639-2/B">[language]</code>
</language>
For more information on the [language group name] and [full
name of language or dialect], examine the other examples within this file,
or review the ISO-639-2 code list, available from: loc.gov/standards/iso639-2/php/code_list.php.
Note: When you add a new, active language to this file, users
automatically receive a prompt to choose the language when creating a new
map or topic. The user's selection is expressed in the xml:lang for that map or topic.
The dictionaries you added are now active.
