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.
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.
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!
Download the file for your platform and extract it from its archive.
Having done that, then either double-click the
or issue the command
java -jar transeditor_v1_0_sol.jar
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.
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
scripts from the command line. You should see the following application
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 :
Choose a name for your project, and select the source and target languages.
Next, you can open an XLIFF file using the
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.
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
Much (much) more information about using the Open Language Tools XLIFF Translation Editor can be found in the User Manual.
The editor has many keyboard shortcuts and options that can be
configured directly using the items in the
If you prefer, you can also change the alignment of the panes showing the
segments by choosing the
View->Window Arrangement menu
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/ ).