Computers & Writing Systems

SIL HOME | SIL SOFTWARE | SUPPORT | DONATE | PRIVACY POLICY

You are here: Encoding > Conversion > Utilities
Short URL: https://scripts.sil.org/SILConverters25_doc

SIL Converters 2.5 documentation

Kent Spielmann, 2007-02-21

Contents of this page

SIL Encoding Converters 2.5 Setup

Besides being available from the SIL Software CD-ROMs, starting with SIL Converters version 2.5, there is a new web-based Master Installer that allows you to choose the features you want and then install them from the internet. The Master Installer is currently available from this link:  http://downloads.sil.org/EncodingConverters/setup.exe. The Master Installer is a small program that runs on your machine that runs a series of installers:

1. Software prerequisites—Necessary system updates and add-ons are installed on your computer.
2. SIL Encoding Converters2.5 Setup—Conversion applications are installed and conversion Maps and Tables are copied to your hard drive.
3. SIL Converters for Office 2003—A misnamed installer that installs one additional operating system update.
4. Converter Installer—A utility that allows you to activate the conversion Maps and Tables you want to use.

For further instructions on running the Master Installer and for initial running of SIL Encoding Converters2.5 Setup of refer to the installation documentation SIL Converters 2.5 Installation.

The following instructions assume you have already installed SIL Encoding Converters2.5 and want to understand and use additional features of the program.

Initial dialog windows

• If you have already run the master installer program and are sure all the prerequisites are installed you may "accept the risk" and click  Next 

Application maintenance

Once Encoding converters is installed, the set up program displays an application maintenance screen that gives you the option to  Modify ,  Repair  or  Remove  your installation.

• To modify your installation simply click  Next .

Select Features

The following section briefly describes most of the boxes in Figure 1 and links you to further information about how use the different utilities and applications for different text transduction applications. The information in this table is organized around the different components available in the SIL Converters Installer.

Feature overview

As you can see from Figure 3, there are four main categories of features that you can choose from when installing SIL Converters:

SIL Converters’ client application

This feature node contains some of the programs at the top layer of Figure 1, which are generally of the most interest to end users. These programs and utilities allow you to convert text data (e.g. Word documents, SFM documents, XML Documents, data on the system clipboard) using the text processing capabilities provided by the various transduction engines at the bottom of Figure 1.

Transduction Engines

This feature node contains the different transduction engine components that provide text processing capabilities at the lowest layer of Figure 1.

Most users should accept the defaults for this feature to insure that the proper transduction engines are installed. Otherwise, you must make sure you have the required transduction engines installed for the different text processing tasks you want to do.

Examples:

• If you intend to do encoding conversions, you probably need to install the TECkit and/or Consistent Changes (CC) transduction engines.
• If you want to use an ICU transliterator, you need to install the IBM Components for Unicode transduction engine.
• If you want to write Perl expressions or call Python script functions for text processing, you need to install one or both of those transduction engines (both of which require separately available program distributions—see below)

Maps and Tables

This feature node contains several groupings of instances of conversion maps and tables (e.g. for TECkit and/or CC) which provide the input to the transduction engines (e.g. the SIL IPA93<>UNICODE map)

A few of the subfeature items are useful for all users, such as the Basic Converters and ICU Transliterators sets. Otherwise, you can only install those converter sets you expect to need (e.g. based on your entity).

If you would like to add a package of converters to the SIL Converters’ installer, contact .

Additional TECkit applications

Since the SILConverters installer installs TECkit (a subfeature of the Transduction Engine feature node discussed above), this feature node adds the rest of the content of the TECkit download from the TECkit site (i.e. the documentation and other TECkit client applications). A new TECkit map Unicode Editor assists in the creation of TECkit maps available from this feature node.

The following sections describe the sub-features available in each of these four nodes.

SIL Converters’ client applications

This installer installs the following of SIL Converters client applications directly (see Figure 1).

• Bulk SFM Converter
• Clipboard Encoding Converter
• XML Data Converter
• MS Word Converters

The FieldWorks and AdaptIt client applications have separate install programs.

Bulk SFM Converter

Use this application to convert the data in Standard Format Marker (SFM) fields using converters from the EncConverters’ repository and to convert the encoding of data in Shoebox, Toolbox, and Paratext (SFM) documents. You can also open multiple SFM documents for processing at the same time.

Clipboard Encoding Converter

After starting up the Clipboard EncConverter, click the icon on the Windows Task Bar to convert text copied to the Windows clipboard.

XML Data Converter

Use this application to convert the data (attributes or elements) in an XML document using converters from the EncConverters’ repository for example,

• to convert the data in an AdaptIt Knowledge Base from a legacy encoding to Unicode, or
• to convert the text in a Word document saved as XML. (This requires some knowledge of WordML and XPath syntax.)

MS Word converters

You can use SILConverters directly in MS Word. The converters are macros contained in three Microsoft Word document templates (DOTs). These macros use the EncConverters repository to accomplish different tasks.

• Data Conversion Macro in Data Conversion Macro xxxx.dot
• SpellingFixer in SpellFixer.dot
• Consistency Spelling Checker in Consistent Spelling Checker xxxsc.dot

If you select the WordDOTs feature node, the SILConverters’ installer will put these templates into your Templates folder (normally C:Documents and Settings<user>Application DataMicrosoftTemplates).

Data Conversion Macro

Use the Data Conversion Macro to convert text in any arbitrary Word document based on Font name, Style, or even the current selection using converters from the EncConverters’ repository. It also supports SFM documents. Open the document template for more instructions.

SpellingFixer

Use the SpellingFixer document template to correct misspelled words or make certain orthographic changes based on a user-defined database of bad-good spelling pairs. This is particular useful when you want

• to condition spelling changes to be at either a beginning or ending word boundary, or
• to convert a portion of a word (as opposed to full word forms).

Once you have a database of such spelling fixes (or consistent changes), use one of the Correct Whole Document menu commands to go through all the words in the document to search for misspelled words. See the document template for instructions.

Consistency Spelling Checker

Use the Consistency Spelling Checker document template for a simple way of working with data (in any language, and any script) in Microsoft Word documents, Plain Text files or any Toolbox database to:

• Check consistency of spelling (semi-automatically) based on linguistic principles
• Apply global spelling changes:
  • to multiple documents which are currently open
  • by generating a CC table of changes to be applied to one or more plain text databases (such as Toolbox files)
• Create a character inventory with frequency count
• Create unique wordlists from one or more Word documents as:
  • a Word document table with frequency counts, or
  • a Toolbox (MDF-formatted) database for starting a lexicon

SIL Converters’ Transduction Engines

Several of the transduction engines in Figure 1 are provided by the EncConverters’ repository object itself (i.e. the code page converter, the AdaptIt Knowledge Base Lookup, and the Compound and Primary-Fallback meta converters) and are always available. The rest depend on external programs (SIL and other Open Source programs) and installation is optional, depending on your need.

Most end users will not need to concern themselves with these details except to be sure that the necessary transduction engine is installed for the converters they want to use. Chances are that someone in your entity has already created a map file that you can use to convert the encoding of your data. In this situation, you need to be sure that you install the proper transduction engine required by the map or table that implements the conversion you want.

TECkit

Other applications use TECkit, a low-level toolkit, to perform encoding conversions (e.g., when importing legacy data into a Unicode-based application). The primary component of the TECkit package is a library that performs conversions. This is the “TECkit engine”. The engine relies on mapping tables in a specific binary format (see TECkit documentation). A compiler creates such tables from a human-readable mapping description (a simple text file).

In EncConverters, you can select either the compiled *.tec file or the uncompiled, human-readable *.map) to be the converter. If you choose the latter, EncConverters will automatically compile an out-of-date .tec file when it is used to convert data.

See Adding converters: TECkit map below for details about adding TECkit maps to the system repository.

Consistent Changes (CC)

Use Consistent Change tables to find all occurrences of specified characters, words, or phrases in a string of text, and then change them in a consistent way. The change may be done in every occurrence or only when certain conditions are met.

CC is like the find-and-replace feature in a text editor, but much more powerful. It allows you

• to make changes which take context into consideration, and
• to make a whole set of changes at once.

SpellFixer is also available. This is a user-friendly graphical user interface for creating consistent change tables. This interface is primarily available via the SpellFixer.dot Microsoft Word document template mentioned above in SILConverters’ client applications.

See Adding converters: Consistent Changes (CC) below for details about adding CC tables to the system repository.

International Components for Unicode (ICU) 3.4

Three distinct EncConverters-related features as well as other features of ICU used by other client are applications that must be installed as a unit.

For SILConverters, three transduction engines are included in this feature:

• ICU Transliterators: provides a series of transliterators for various ranges of Unicode (c.f. Devanagari to Latin) as well as the ability to write custom rules for doing transliteration. See  http://icu.sourceforge.net/userguide/Transform.html for more details on the use and syntax of ICU Transliterators.
• ICU Converters: provides comprehensive character set conversion services, mapping tables, and implementations for many encodings. Since ICU uses Unicode (UTF-16) internally, all converters convert between UTF-16 (with the endianness according to the current platform) and another encoding. This converter includes other Unicode encodings. These are typically of more interest to programmers than end-users. See  http://icu.sourceforge.net/userguide/conversion.html for more details on ICU converters.
• Regular Expression: provides applications with the ability to apply regular expression matching to Unicode string data. The regular expression patterns and behavior are based on Perl's regular expressions. See  http://icu.sourceforge.net/userguide/regexp.html for more details on the syntax of ICU Regular Expressions.

Perl Expressions 5.8.7

The Perl Expressions 5.8.7 transduction engine allows you to write Perl expressions to do text processing in EncConverter client applications.

See below for a known issue with the PXPerl distribution.

Also note that this plug-in will not work (yet) with the most recent v5.8.8 distribution.

Python Script Functions 2.4

The Python Script Functions 2.4 transduction engine allows you to do text processing using Python functions in EncConverter client applications.

SIL Converters’ Maps and Tables

Most end-users are interested only in a small number of encodings. Typically, computer support people have created TECkit maps and/or CC tables for the various encodings used in each entity, alleviating most end-users from having to create their own maps and tables.

Because there are hundreds of possible encoding converters and transliterators that different end-users may be interested in, they are packaged into logically-related groups of converters and are available via a two-step process.

The following sections gives the details about fonts and encodings for different maps and tables:

Basic Converters

Converters and Transliterators common to all SIL. This includes the following:

ICU Transliterators

Configuration information for the following ICU transliterators are for Unicode-encodings only.

• Devanagari to Latin (aka. Devanagari-Latin)
• Bengali to Latin (aka. Bengali-Latin)
• Gujarati to Latin (aka. Gujarati-Latin)
• Gurmukhi to Latin (aka. Gurmukhi-Latin)
• Kannada to Latin (aka. Kannada-Latin)
• Malayalam to Latin (aka. Malayalam-Latin)
• Oriya to Latin (aka. Oriya-Latin)
• Tamil to Latin (aka. Tamil-Latin)
• Telugu to Latin (aka. Telugu-Latin)
• Arabic to Latin (aka. Arabic-Latin)
• Cyrillic to Latin (aka. Cyrillic-Latin)
• Greek to Latin (aka. Greek-Latin)
• Han to Latin (aka. Han-Latin)
• Hangul to Latin (aka. Hangul-Latin)
• Hebrew to Latin (aka. Hebrew-Latin)
• Hiragana to Latin (aka. Hiragana-Latin)
• Katakana to Latin (aka. Katakana-Latin)
• Jamo to Latin (aka. Jamo-Latin)
• NumericPinyin to Latin (aka. NumericPinyin-Latin)
• Any to Latin (aka. Any-Latin)

FindPhone to IPA converters

Adds the following converters for dealing with FindPhone encoded data:

• FindPhone>SAG IPA93
• FindPhone>UNICODE

SAG Indic

Contains encoding converter map(s) for the following encoding/font:

• Includes an IPA transliterator for Unicode Devanagari to Unicode IPA (phonetic)

Cameroon

Contains encoding converter map(s) for the following encoding/fonts:

West Africa

Contains encoding converter map(s) for the following encoding/fonts:

Eastern Congo Group

Contains encoding converter map(s) for the following encoding/fonts:

NLCI (India)

Contains encoding converter map(s) for the following encoding/font:

Additional TECkit applications

TECkit Map Unicode Editor

The TECkit map Unicode Editor is one more EncConverters’ client application mentioned in Figure 1. Use this program to develop TECkit maps for encoding conversion or other text processing applications (e.g. Transliteration).

1. Type (or paste) text into the Sample boxes in the lower left window. Result: The code point values and/or names of the characters in the string will be displayed in the table in the upper right.
2. Click the cells in that table to insert those values into the map (in the upper left).
3. To save your map to the default system repository, click File... / Add to System Repository, navigate to C:Program FilesCommon FilesSILMapsTables, and click  Save . Result: this will bring up the TECkit map transduction engine dialog box.

Final dialog windows

1. When you have finished making selections click  Next  again to begin installation and/or uninstalling.
2. When you see the SIL Encoding Converters 2.5 has been successfully installed message, click  Finish .
3. Add any new converters to the Encoding converters repository:
   1. If you run the SIL Encoding Converters 2.5 Setup .msi file directly the program will close and you will need to add any new converters to the Encoding Converters system repository. See Adding converters to the system repository
   2. If you run SIL Encoding Converters 2.5 Setup from the master installer, the Master Installer sequence will continue. If this is not an initial installation you may cancel the SIL Converters for Office 2003 Setup (see the installation documentation) and proceed to the Converter Installer to add any new converters to the Encoding converters repository.

Adding Converters to the System Repository

There are two primary ways of adding converters to the System Repository, by using either the

• Converter Installer or
• Transduction Engine configuration dialogs.

Converter Installer

If the converter you want to install into the system repository comes as part of the Maps and Tables features in the SILConverters installer (e.g. the SIL IPA93<>UNICODE converter that comes as part of the Basic Converters package), you can install it into the system repository by running the Converter Installer application.

Choose a Transduction Engine dialog box

If you have your own converter map (e.g. created with the TECkit map Unicode Editor) or one given to you not as part of an installer feature, you can add it to the system repository via the Choose a Transduction Engine dialog box.

• Select the item from the list that matches the type of converter you want to add and click  Create .

Transduction Engine Details

TECkit map

• To add a TECkit map to the system repository, select TECkit map from the Transduction Engine dialog box, and click  Create . Result: The TECkit map Setup dialog will be displayed.

1. Browse with the  ...  button for the TECkit .map or .tec file.
2. To permanently add the converter to the System Repository, click  Save in System Repository .
3. Click Test Area to test the converter with some sample data.

Consistent Changes (CC)

• To add a CC table to the system repository, select CC table from the Choose Transduction Engine dialog box and click  Create .

Result: The CC table Setup dialog will be displayed:

1. Browse with the  ...  button for the CC table file.
2. For CC Table expects and CC Table returns, select the desired encoding and click  Apply .

• 3. If you installed the SpellFixer plug-in, click Add or Edit a SpellFixer CC Table. Result: This will allow you to create or edit an existing SpellFixer project.

• 4. To permanently add the converter to the System Repository, click  Save in System Repository .

• 5. Click Test Area to test the converter with some sample data.

ICU Transliterator

• To add an ICU Transliterator to the system repository, choose ICU Transliterator from the Choose Transduction Engine dialog box and click  Create .

Result: The ICU Transliterator Setup dialog will be displayed:

1. To use one of the built-in transliterators, choose Built-in transliterator.
2. To write a custom transliterator using the syntax described on the webpage referred to above, choose Custom transliterator and enter the transliterator syntax in the box. Result: Previous Custom Rules will be enabled, showing examples of useful custom rules and others that you wrote (Figure 19, number 3).
3. Click  Delete  to remove unwanted rules.
4. To permanently add the converter to the System Repository, click  Save in System Repository .
5. Click Test Area to test the converter with some sample data.

ICU Converters

• If you want to add an ICU Converter to the system repository, choose ICU Converter from the Choose Transduction Engine dialog box and click  Create .

The ICU Converter Setup dialog will be displayed:

1. Choose the desired converter from the drop-down combo box as shown above.
2. If you want the converter to be permanently added to the System Repository, then you must click  Save in System Repository .
3. You can click the Test Area tab to test the converter with some sample data.

Regular Expression Find and Replace (ICU)

ICU's Regular Expressions package provides applications with the ability to apply regular expression matching to Unicode string data. The regular expression patterns and behavior are based on Perl's regular expressions. See  http://icu.sourceforge.net/userguide/regexp.html for more details on the syntax of ICU Regular Expressions.

• If you want to add an ICU Regular Express Find and Replace converter to the system repository, choose Regular Expression Find and Replace (ICU) from the Transduction Engine dialog box and click  Create .

The Regular Expression Find and Replace (ICU) Setup dialog will be displayed:

1. In the Search for box, enter the Regular Expression search string you want to use. Tip: The search string can contain ICU Regular Expression Meta Characters and Operators defined below.
2. Click the right wedge. Result: You will see a pop-up list of commonly used Regular Expression search operators. If selected, they will be inserted into Search for.

• 3. In the Replace with box, enter the string or operator that represents the text to replace the Search for string (see Replacement Text defined below).
• 4. Check the Ignore Case box to have the ICU search algorithm ignore the case of the input text.
• 5. The Previous Searches combo box includes a few example Regular Expressions and remembers any new ones you add. Click  Delete  to remove the selected search item.
• 6. If you want the converter to be permanently added to the System Repository, then you must click  Save in System Repository .
• 7. Click the Test Area tab to test the converter with some sample data.

Regular Expression Metacharacters

Regular Expression Operators

Replacement Text

The replacement text for find-and-replace operations may contain references to capture-group text from the find. References are of the form $n, where n is the number of the capture group.

Perl Expression

See the Unable to add converters with PXPerl installed in the installation document in for a known issue with the PXPerl distribution.

• To add a Perl Expression converter to the system repository, choose Perl Expression from the Choose Transduction Engine dialog box and click  Create .

The Perl Expression Setup dialog will be displayed:

1. This area is for entering your Perl expression.
2. For Perl expression expects and Perl expression returns, select the desired encoding type and click  Apply . Tip: If your data is Unicode-encoded, select that option or your data may be incorrectly converted. For Non-Unicode (byte) data, the default system code page will be used to convert your data when necessary.
3. The Previous Expressions combo box includes a few example Perl expressions and remembers any new ones you add. Click  Delete  to remove unwanted expressions.
4. Click  Distro Config  to set up the path to your Perl Distribution's library folders (e.g. C:PXPerl, C:PXPerllib, C:PXPerlsitelib) and to specify certain Perl modules to be automatically loaded for all expressions (e.g. Win32, or SIL:RTF:Unicode). Tip: If you get an error message saying that some *.pm file can't be found, then you probably don't have the correct path to the file configured.
5. To permanently add the expression to the System Repository, click  Save in System Repository .
6. Click the Test Area tab to test the converter with some sample data.

Python Script Function

If you want to add a Python script function converter to the system repository,

• Choose Python Script from the Choose Transduction Engine dialog box and click  Create .

The Python Script Setup dialog will be displayed:

1. Browse with the ... button for the Python script file.
2. If the file contains valid Python functions, then the function names will be put into the Function Name combo box. Choose the function desired.
3. If you want to pass some static information to your Python function, then define the function as shown below and put the static information in the Additional parameters field. For example, with a Python function prototype of:

def ChangeLanguage(sLang, uI):
    if not isinstance(uI, unicode):
        raise UnicodeError(u'Input Data not Unicode! (%s)' % uI)0
    else:
        if sLang == u'Chinese':
            # do some Chinese processing and put result in uO
            uO = ProcessChinese(uI)
        return uO

• 4. This area is for indicating how your expression expects and returns data. If your data is Unicode-encoded, be sure to select that option or your data may be incorrectly converted. For Non-Unicode (byte) data, the default system code page will be used to convert your data when necessary.
• After configuring these four items, click  Apply  to accept the Python script function.

The Setup tab also has the following options:

• 5. As you iterate through the functions listed in the combo box in, the Function Prototype window show what the prototype of selected Python function looks like.

• 6. If you want the Python function to be permanently added to the System Repository, then you must click  Save in System Repository .
• 7. Click the Test Area tab to test the converter with some sample data.

AdaptIt Knowledge Base Lookup Converter

The AdaptIt Knowledge Base Lookup transduction engine is contained in the EncConverters assembly itself and therefore is always available without requiring an installer selection.

This transducer allows you to do lookups on words in either the adaptation or glossing Knowledge Base of an AdaptIt project.

To add an AdaptIt Knowledge Base Lookup converter to the system repository:

• Choose AdaptIt Knowledge Base Converter from the Choose Transduction Engine dialog box and click  Create .

The AdaptIt Knowledge Base Converter Setup dialog will be displayed:

• 1. Choose which version of AdaptIt (i.e. Non-Roman/Unicode vs. Legacy/Ansi) that you use to create the (XML) Knowledge Base.
• 2. Choose the project desired in the Projects list box. This is automatically populated from the projects available on the local machine for the current user.

• 3. If you want the converter to be permanently added to the System Repository, then you must click  Save in System Repository .
• 4. Click Test Area tab to test the converter with some sample data.

Compound “daisy-chained” converters

Two final converter types to be discussed are actually meta converter types; that is, they allow you to combine two or more existing converters in the system repository in a serial or parallel fashion.

The Compound Converter type can be used to combine 2 or more converters together in a serial fashion so that the output of one step will become the input to the next step automatically. This can be helpful when you have multiple, different conversions to apply to your data to get it in the ultimate form you need without requiring separate conversions.

For example, you may have one converter that goes from FindPhone IPA to SIL-IPA93, and another converter that converts from SIL-IPA93 to Unicode IPA. In order to perform the end-to-end conversion from FindPhone IPA to Unicode IPA, you can create a daisy-chain of the two existing converters (a “virtual converter”) so that the data is converted in one step.

To add a Compound converter to the system repository:

• Choose Compound (daisy-chained) Converter from the Choose Transduction Engine dialog box and click  Create .

The Compound (daisy-chained) Converter Setup dialog will be displayed:

• 1. Use this combo box to choose the converter to become one of the steps of the compound conversion.
• 2. If the selected converter is bi-directional, then the Reverse box will be enabled allowing you to select the reverse direction, if needed. For example, to go from Devanagari to Arabic, note that the above configured converter goes forward (by default) from Devanagari to Latin. This is followed by a second step that goes in the reverse direction from Latin to Arabic.
• 3. If you need to explicitly normalize the output data of any step (i.e. to Fully Composed or Full Decomposed), you can check the Normalization box and the compound converter will do this before continuing with the next step.
• 4. Click  Add Step  to add it to the queue of steps in the compound converter.
• 5. This area shows what steps are configured, the direction of conversion, and whether any normalization is requested.
• 6. If you make a mistake in the steps, click  Remove Steps  to clear out the compound converter and start over.
  • Once you have configured all the steps, you click  Apply  to save the converter in the System Repository.

• Once you click  Apply , the Enter Converter Name dialog box will appear:

• 7. Once you complete the previous step, the converter name will be displayed in the Compound converter name box.
• 8. Click the Test Area tab to test the converter with some sample data.

Primary-Fallback Compound Converter

The Primary-Fallback Compound Converter type allows you to specify two existing converters: one to be a primary, and the other, a fallback converter.

The configured primary converter is first called to do a conversion. If the primary converter doesn’t change the data, then, and only then, the fallback converter is called.

This can be useful for transliteration where a character-based transliterator (e.g. TECkit, ICU, or CC) does most of the work, but certain words (or character sequences) are otherwise unpredictable from the context. In this case, you might want a lexicon-based approach to supply the special case forms.

In this scenario, you would configure the lexicon-based transliterator (e.g. a SpellFixer CC table or an AdaptIt Knowledge Base Lookup converter) to be the primary converter and the character-based transliterator as the fallback converter. If the text isn’t modified by the primary converter (i.e. if it isn’t an exception), then the fallback converter is called to do the conversion.

To add a Primary-Fallback converter to the system repository:

• Choose Primary-Fallback Converter from the Choose Transduction Engine dialog box and click  Create .

The Primary-Fallback Converter Setup dialog will be displayed:

• 1. Use this combo box to choose the existing EncConverter which is to be the Primary converter for this conversion (e.g. the lexical lookup converter).
• 2. If the selected Primary converter is bi-directional, then the Reverse box will be enabled allowing you to select the reverse direction, if needed.
• 3. Use this combo box to choose the existing EncConverter which is to be the Fallback converter for this conversion (e.g. the character-based transliterator).
• 4. If the selected Fallback converter is bi-directional, then the Reverse box will be enabled allowing you to select the reverse direction, if needed.
  • Once you have configured both the Primary and Fallback converters, you click  Apply  to save the converter in the System Repository.

• Once you click  Apply , the Enter Converter Name dialog box will appear:

• 5. Once you complete the previous step, the converter name will be 6. displayed in the Compound converter name box.
• 6. Click the Test Area tab to test the converter with some sample data.

Saving the converter in the System Repository

On any of the Transduction Engine Setup dialogs, by default, if you click  Apply  or  OK , the configured converter will be returned to the client application as a temporary converter; once the client application (e.g. FieldWorks or Word) is closed or releases the converter, it will no longer be available. If you want the converter to be permanently available to client applications, then you must explicitly add it to the System Repository using the  Save in System Repository  button (or the  Update in System Repository  button when editing a map).

• When you click  Save in System Repository , the following dialog box will be displayed to query for a friendly name by which the converter will be known in client applications:

• Click  Advanced...  to enter further, optional information about this converter which is also put into the System Repository Result: It is also put into the System Repository and can be used by various client applications and will bring up Advanced EncConverter Configuration.

Though these values are not necessary for the operation of the converter, they can be helpful to various client applications. For example, the Clipboard EncConverter can be configured to filter the list of displayed converters based on the Encoding Name and/or the Transduction Type configured here.

Known Issues

SIL Converters has the option of displaying all fonts in a Word document. However, it will only show you the fonts that are installed on your computer. It does not warn you of any fonts that have been used in the document but are not currently installed on your computer. You can find out what fonts the Word document needs that are not on your
computer by looking at the Compatibility tab of Tools / Options, click on  Font Substitution... .

---

© 2003-2023 SIL International, all rights reserved, unless otherwise noted elsewhere on this page.
Provided by SIL's Writing Systems Technology team (formerly known as NRSI). Read our Privacy Policy. Contact us here.