NRSI: Computers & Writing Systems
SIL Converters 2.5 Installation
SIL Converters Pages
SIL Converters version 2.5 is intended to be installed using the Master setup program found here.
This document is intended to guide you through the Master Installer installation screens and initial SIL Encoding Converters2.5 Setup. This guide may be sufficient for many users. However, to make full use of SIL Encoding Converters 2.5, you should refer to the SIL Encoding Converters documentation.
The Master Setup program runs a series of installers:
If this is the first time you are running the installer, be sure to close all programs before starting the installation program, including the program that you are using to read this document. Several of the software prerequisite sub-installers will stop and tell you to shut down programs.
Suggestion: If this is your first time installing SIL Converters, you may want to print out this document to guide you through the process.
These installers may require that you answer some dialog box questions. Be sure to allow these updates and add-ons to be installed; they are necessary for SIL converters to run properly. Several of the software prerequisite programs may stop and tell you to shut down programs you were not even aware were running. Be sure you follow all instructions.
If it seems the installer has stalled, it may be there is a dialog box waiting for you to respond. However, be patient. Some of these installers take several minutes to finish.
SIL Encoding Converters2.5 Setup
This section is intended as a guide for initial setup. For detailed information on the SIL Encoding Converters2.5 Setup see Help for SIL Converters 2.5.
You do not need to know exactly what you want to install the first time you run the Setup program. You can run the Master Setup program again to add or delete components. For more information on the SIL Converters components and features see Help for SIL Converters 2.5.
For Advanced Users: As many of the components in the SIL Converters suite are shared utilities, the vast majority of the download will be installed in specific, fixed, shared locations. For example, most of the transduction engines are provided by DLL programs which must be in a folder that is in the Windows Path environment variable. For this reason, the TECkit, CC, ICU, Perl, and Python DLLs are put into the C:Program FilesCommon FilesSIL folder, which is also added to your system Path variable. However, the majority of the client applications, which otherwise don’t need to be in one of these shared locations (e.g. the Bulk SFM converter, the Clipboard EncConverter, etc), will be installed in the folder which you select from this dialog box.
This screen allows you to select which conversion applications are installed and which conversion Maps and Tables are copied to your hard drive. Selected Map and Tables will need to be activated using the Converter Installer dialog latter in the installation process.
SIL Converters for Office 2003
The SIL Converters for Office 2003 Setup currently only installs a critical operating system update. However, the update is needed by all users, whether or not you have Office 2003.
This installer does not check to see if update has already been installed. If you know the update has been installed, you may clickand to skip this installer.
Do not activate all the converters. Too many active converters will slow down your system considerably, particularly if you are using the Clipboard Encoding Converter application.
Known issues at release time
CC Unrecognized keyword error
CC Error dialog box
If you see this error message: begin > utf8 ?CC-F-Unrecognized keyword, it means that there is a version of the file cc32.dll somewhere in your Windows Path that is older than the one installed by SIL Converters into the C:Program FilesCommon FilesSIL folder. It is best if you delete any older copy of cc32.dll. The existing application which installed it will be able to use the newer version installed by SIL Converters because it is also on the Path.
Python 2.4 required for Python script conversions
If you want to use a Python script converter, such as 'UnicodeName' (installed when you select the 'Python Script Functions 2.4' transduction engine feature in the SILConverters' installer), you must also install a separately-available Python distribution of the same version number.
SILConverters 2.5 supports encoding conversions using Python Version 2.4. This means you must have a Python Version 2.4.x. installed on your computer. It will not work with an earlier or later Python version (e.g. 2.3.1 or 2.5.2).
Perl 5.8.7 required for Perl expression conversions
If you want to use a Perl expression converter, you must also install a separately-available Perl distribution of the same version number.
SIL Converters 2.5 supports encoding conversions using only Perl Version 5.8.7. It will not work with any other Python version (e.g. 5.8.8). The Perl converter has been tested with the following freely available Perl distributions: ActiveState Perl or PXPerl.
The PXPerl 5.8.7 installer may be downloaded here:
Unable to add converters with PXPerl installed
The PXPerl program inserts its path Path environment variable ahead of the Windows path folders. This causes certain problems (e.g. unable to add an ICU Transliterator from certain SIL Converters’ client applications).
If you have trouble installing some converters, you should follow these steps to rectify this problem:
Open a text editor like Notepad. Right after clicking CTRL + C to copy the path statement from the box of the dialog window, then paste the path into the text editor. After editing you can paste it back., click
Result: When you’re finished, your Path variable should look something like this (though it may be much longer, and there should be no line breaks):
%SystemRoot%system32;%SystemRoot%;%SystemRoot%System32Wbem; C:Program FilesCommon FilesSIL;C:PXPerlparrotbin;C:PXPerlbin