Rainbow

Installation

Rainbow runs on any version of Windows that can run the Microsoft .NET Framework v2.0 or higher: Windows 98, Windows 98 SE, Windows ME, Windows NT 4.0 (all versions—Service Pack 6a required), Windows 2000 (all versions—no Service Packs required), Windows XP Professional, Windows XP Home Edition, and Windows Vista.

If you do not have Microsoft .NET Framework 2.0 runtime files installed, the installation will be interrupted and you will be prompted to install the framework. Once the framework is installed you can re-run Rainbow's installer.

If you have already on your system...

• A previous version of Okapi Rainbow (Rainbow 5.x), you must un-install it before installing the new version.
• Any version of ENLASO Rainbow (Rainbow 1.x to 4.x), you do not have to un-install it. Both applications can run on the same system at the same time.

To install Rainbow:

1. Download the installation package from http://sourceforge.net/project/showfiles.php?group_id=42949
2. Open or unzip the ZIP file
3. Execute the RainbowInstaller.msi file
4. Follow the installation instructions. Note that if you have several Okapi applications installed (like Rainbow and Olifant), you should select the same installation folder (by default: "C:\Program Files\Okapi") for all of them.

Tikal and some utilities and filters can also be used under Mono, on various OS such as Windows, Linux, and Mac. For information about how to install and work with the subset of Okapi Tools available for Mono, see the Okapi for Mono page.

Un-Installation

To un-install Rainbow:

1. Go to the Control Panel.

2. Select Add/Remove Programs.
3. Select the entry for Okapi Rainbow.
4. Click Remove.

In some cases you can also directly re-run the installer: if the application is already installed and if the version is similar, it will ask you if you want to remove it or repair it. Simply select the removal option.

Beta Versions

Some utilities or filters may be labeled "Alpha" or "Beta" because they are not completely developed. As a general rule you should avoid using such components for real project work. Sometimes, the equivalent filters or utilities may be available in the "old" version of Rainbow (v4.x) which can be installed and run independently from Okapi Tools. Rainbow v4 can be found here.

Changes Between Releases

• Table Filter:

  • Added support for \t, \XHHH, \uHHH, and \UHHH for the characters escaped valued in the parameters dialog box.
  • Added support for specifying column names rather than column index. This resolves Request #1831457.
  • Fixed code in CR00020 where using several named columns was causing validation error in the parameters dialog box. This resolves Bug 1875787.
  • Now empty lines are ignored and the value specified in the Row where the data start option is the first non-empty line.
  • Implemented support for embedded line-breaks. This resolves Request #1871435.
• CDATA Conversion utility:
  • Fixed the bug causing the Remove button of the CDATA Conversion Utility dialog box to trigger an exception under some conditions.
• Added the XML Partitioning utility. It allows you to extract and merge parts of XML documents to and from external files (for example to process them with other filters).
• XML Filter:
  • Fixed an issue where ITS rules linked from an external ITS file were treated like rules linked from the source document and where incorrectly reset when reloading the rules cache.
• Text Extraction utility:
  • Added a comment with the total word count for XLIFF output when the Include word-count option is set.
  • Fixed the creation of the _Merge.rbp file: Now the source and target languages are correctly copied from the original project. For the encoding, the default of the original project are not copied over to _Merge.rbp, but the source and target encodings of each input file is set correctly in the file properties. This resolves Bug #1867616.
  • Changed the way the filter settings are set in the extracted file that can be merged back. This resolves Bug #1867618. The new behavior is the following:
    • If the option Create a Rainbow project for Text Merging is set: Parameters files are created in the same folder where the project file is generated, and these parameters files are set in the extracted file. This means the extracted files should be merged with those parameters files (or the settings changed in each extracted file). This forces the merging to use the same filter settings as when extracting, even if those settings change between the extraction and the merging (for example for User or System parameters).
    • If the option is not set: The filter settings defined at extraction time are used in the extracted file (same behavior as before).
    • Fixed issue of CR20a where external ITS files were not copied along with the parameters file. Now an ITS rule file is generated in the Target folder and contains the rules of the external ITS file as well as any rules that were called from that file using XLink. Note that ITS rules linked from the source file are left untouched: inheritance rules make it too complicated to try to include them in the local external file and such change would require a modification of the source document itself. Such linked files need (for now) to be copied manually. This resolves Bug #1875786.
• Text Rewriting utility:
  • The option Add end-of-text marker has been removed. Instead there are two new options in the pseudo-translation settings: Prefix text and Suffix text which allow you to add text, respectively, before and after the original text. This resolves Request #1855876.
• The tutorials and help have been updated.
• Several minor fixes have been done to the Base library.
• Added a shortcut to uninstall Rainbow from the user's Programs menu.
• Added Type Libraries files (.tlb) in the Okapi Shared folder (in the Libraries sub-folder) for user who want to utilize the Okapi components directly from COM in programming languages like C++.
• Updated the sample of Word macros using the Okapi framework (the files are in the Samples\Word sub-folder, in the Okapi Shared folder)
• Updated the license information for v3 of GNU LGPL.
• Added the SaveSettingsAs method to the okapi IFilter API to allow saving of parameters files from the filter itself, in case the parameters file and any related files need to be duplicated during an operation such as Text Extraction.

Support

If you have questions, suggestions or bug to report, you can do this different ways:

• Use the Send Feedback command in the Help menu of Rainbow.
• Read and post notes in the Okapi Tools users group (you need to be registered member to post, but not to read).
• Post an email to the Okapi Framework administrator (you need to be logged in SourceForge.net for this).
• Fill a bug report in the Bug List (Click Submit New on that page, no login needed)
• Fill a feature request in the Feature Request List (Click Submit New on that page, no login needed)

Known Issues

Reported known issues are listed in the Bug List pages.