Skip to main content

Open Language Tools XLIFF Filters Quickstart & User's Guide

Introduction

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.

Installation

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.

Next you should download the appropriate binary of the filters which is available on the Releases section of our web site, (or you could even build them yourself!).

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.

  • Windows : xliff_filters_v1_0_win.zip
  • UNIX (including MacOSX) : xliff_filters_v1_0_unix.tar.gz

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 java -jar xliff_filters_v1_0_unix.jar or java -jar xliff_filters_v1_0_win.jar which will then launch the installer program.

The installer program will ask you to accept a license and then ask you to enter a location to install the software.

Running the XLIFF Filters

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.sh or filters.bat scripts from the command line. You should see the following application appear :

XLIFF Filters Screenshot

To operate the filters, drag & drop a source file on the application, and the file will be converted to a xlz 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 XLIFF sequentially.

For more detailed log messages produced during the conversion process, click the "Show log" button.

Configuring the XLIFF Filters

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 ~/.java/.userPrefs/org/jvnet/olt/filters/gui/prefs.xml 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 configured.xml.config preference is set to false. It rebuilds the config store (saved in a private location) by parsing the files in the xml-config directory.

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/ ).

 
 
Close
loading
Please Confirm
Close