This document serves as a quickstart guide and user manual for the Open Language Tools XLIFF Filters. The filters are very simple to use - just drag & drop, so this will be a short document.
To install the XLIFF Filters, first download the latest release of Java. The filters require at least release 1.4.2 (see note). These can be obtained at http://java.com - follow the link on the main page to obtain Java for your platform.
We have two possible builds available - the contents are the same for each platform, but the installation actions are slightly different to account for platform differences.
Download the file for your platform and extract it from its
archive. Having done that, then either double-click the
.jar file or issue the command
xliff_filters_v1_0_win.jar which will then launch the
The installer program will ask you to accept a license and then ask you to enter a location to install the software.
Launch the filters either by double-clicking the desktop
launcher, going to the "Start" menu in Windows and
selecting the launcher for the filters, or by running the
filters.bat scripts from
the command line. You should see the following application appear
To operate the filters, drag & drop a source file on the
application, and the file will be converted to a
file in the same directory as the source file. When the
conversion is completed, a dialog box will be shown. If you drop
multiple files on the application, they will all be converted to
For more detailed log messages produced during the conversion process, click the "Show log" button.
The filters don't have a user-friendly configuration mechanism
yet. Right now, the preferences are stored as values written
using the java.util.prefs API. These preferences can be changed
directly by users and include ways to change the source language
for input files, the source-file encoding, and the directory
containing the XML configuration files. (on UNIX-like platforms,
these are stored in
on Windows, they're stored somewhere in the registry).
For the XML to XLIFF filter, the XML configuration file
database it uses is rebuilt by the application automatically on
startup when finding that the
preference is set to
false. It rebuilds the config
store (saved in a private location) by parsing the files in the
If you have any changes or questions that we should add this guide, please get in touch with us. Likewise, if you encounter any problems running the filters, please send mail to one our our mailing lists.
The Open Language Tools XLIFF Filters have been written and tested with the Sun implementation of Java 2 Standard Edition 1.4.2 and they are known to work with the Sun Java 5 implementation. Other Java implementation may also work, but we haven't tested them. If you run the filters on different Java implementations, let us know and we'll update this page !
This product includes software developed by the Apache Software Foundation (http://www.apache.org/ ).