Skip to main content

Open Language Tools XLIFF Translation Editor Quickstart Guide

Introduction

This document serves as a quickstart guide for the Open Language Tools XLIFF Translation Editor. We also have a complete User's Manual available, which goes into a lot of detail on the rest of the editor's functions. This document should be enough for you to get started.

Installation

To install the XLIFF Translation Editor, first download the latest release of Java. The editor requires 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 editor which is available on the Releases section of our web site, (or you could even build them yourself!).

We have builds for two platforms - the contents are similar for each platform, but the installation actions are slightly different to account for platform differences.

Note that right now, we only have spell checkers available for Solaris and Windows - these are based on the open source Aspell spell checkers, and are platform specific : we will migrate to a Java implementation (probably JSpell) in the future so that we don't need to worry about doing Windows, Solaris, Linux, Mac OS X, etc. builds. If you're running a UNIX-like OS other than Solaris/SPARC then you should install the "_sol" version of the editor, but the spell checking functionality will not work, sorry!

  • Windows : transeditor_v1_0_win.zip
  • UNIX (including Mac OS X) : transeditor_v1_0_sol.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 transeditor_v1_0_sol.jar or java -jar transeditor_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 Translation Editor

Launch the editor either by double-clicking the desktop launcher, going to the "Start" menu in Windows and selecting the launcher for the editor, or by running the translation.sh or translation.bat scripts from the command line. You should see the following application appear :

Editor showing translator ID dialog

Here you should just enter any identifier that you wish to use as your translator id - this gets saved in the XLIFF file, so that you can keep track of which translator has translated which segment in the file.

Next, you should start a new project. Click on the File->New Project menu option, and this dialog will appear :

Editor showing new project dialog

Choose a name for your project, and select the source and target languages.

Next, you can open an XLIFF file using the File->Open menu option. If the file hasn't been opened by the editor before, it may not have a target language assigned yet, in which case it will display a warning dialog - in our implementation, each XLIFF file can only have one target language.

Editor showing file open dialog

Now, you can commence translating the strings on the left pane of the editor. When you're finished, mark the segments as translated, save the file, and choose the Tools->Convert to Original menu option, which converts the XLIFF file back to its original file format :

Editor showing backconversion dialog

Much (much) more information about using the Open Language Tools XLIFF Translation Editor can be found in the User Manual.

Configuring the XLIFF Translation Editor

The editor has many keyboard shortcuts and options that can be configured directly using the items in the Options menu. If you prefer, you can also change the alignment of the panes showing the segments by choosing the View->Window Arrangement menu items.

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 Translation Editor has been written and tested with the Sun implementation of Java 2 Standard Edition 1.4.2 and it is known to work with the Sun Java 5 implementation. Other Java implementations may also work, but we haven't tested them. If you run the editor 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