Okapi Filters Plugin for OmegaT
OmegaT is a free and open-source translation tool that offers support for many file formats. It also provides a plugin mechanism to use addition filters.
Several of the Okapi filters have been packaged into a plugin that works with OmegaT's plugin interface. This allows you to use the filters seamlessly directly from OmegaT.
Currently support for the following formats are included:
- InDesign IDML files (using the IDML Filter)
- JSON files (using the JSON Filter)
- Qt TS files (using the TS Filter)
- Trados TagEditor TTX files (using the TTX Filter)
- Transifex projects (using the Transifex Filter)
- Wordfast Pro TXML files (using the TXML Filter)
- XLIFF 1.2 documents (using the XLIFF Filter)
- XLIFF 2 documents (see more information)
Note that several of the formats supported by the plug-in are also supported by OmegaT native filters. You should select which filter to use by enable/disable it in the File Filters dialog. If several filters are set for a given format, the first one in the list is used by default.
Starting in m24 you can specify a custom filter parameters file for each of the filter that supports options.
Use OmegaT's Options button in the File Filters dialog box to select whether you want to use the default settings, or a custom filter parameters file (
.fprm extension) where you have stored your options.
You cannot create or edit the filter parameters file from OmegaT, but you can use Rainbow to do this (menu Tools > Filter Configurations).
Download and Installation
Download the file
- https://bintray.com/okapi/Distribution/OmegaT_Plugin (for the stable release)
- or http://okapi.opentag.com/snapshots (for the development snapshot)
To install the plugin:
- Starting with m24, make sure you are using Java 1.7 or above (OmegaT can run on lower versions of Java).
- Make sure you have OmegaT 2.2.3 or above.
- Make sure there is a
pluginsdirectory in the directory where
OmegaT.jaris installed (e.g.
C:\Program Files\OmegaTin Windows, or
OmegaT.app/Contents/Resources/Javaon the Mac).
- Copy the plugin's JAR file in the
- Restart OmegaT.
On the Macintosh platform, the main OmegaT directory is
OmegaT.app/Contents/Resources/Java. You can open the directory by right-clicking
OmegaT.app and selecting the command Show Package Content.
You may also have to change the default version of the Java virtual machine used to run OmegaT. To do this, open the file
OmegaT.app/Contents/info.plist and replace:
For the file formats that represent segments, such as TTX, be aware that the segmentation created by OmegaT is not carried back into the translated document. For example, an unsegmented paragraph of two sentences may be translated as two separate segments in OmegaT (and produce two TM entries), but it is merged back as a single paragraph (between segment markers because that is the only way to store translation) in the translated TTX file.
Note that any line-break in the source text is considered a segment break by Trados TagEditor, even when it is within an existing segment. Opening a segment that includes a line-break with TagEditor results in a segment withing segment.
TTX documents may contain segments that are already translated. The translation of such segments is loaded as the current translation in OmegaT.
Note that the target language of the OmegaT project must match the target language specified in the TTX file. The target language of a TTX file is defined in the attribute
TargetLanguage of the
Testing a Filter
Some file formats are difficult to extract and merge. If you want to be sure that the translated file merges back properly and is a valid file. One step toward verifying this is to re-extract the merged file and compare the first extraction with the second.
- Open the original file in OmegaT
- Save it.
- Go to the
targetdirectory and copy the file you have saved some place else.
- Go back to OmegaT and open the file you have just copied.
- Both files should have the exact same source content. If they do not it is likely that the saved file was not generated properly. You should fill a bug report to make sure the problem is corrected.
Support for XLIFF 2
- Only basic core support is implemented
translate='no'attribute in unit or annotations is not supported yet.
canResegment='no'flags are not supported yet.
- Annotations are stripped out
- No module is supported yet
- Existing target is set as OmegaT "fuzzy match" if its status is "initial" or "translated", not fuzzy for "reviewed" and "final".
- Inline codes are mapped to
- Notes are not displayed in OmegaT.
You can find examples of valid XLIFF 2 documents in the SVN repository of the XLIFF TC