The document describes a bilingual TMX editor that allows users to view and edit translation memory files (TMX files) for two languages. It provides functions for opening, editing, and saving TMX files, as well as creating projects to manage multiple TMX files. Users can modify translation units (TUs) and their source/target language values (TUVs), and the editor supports various alignment types including 1:1, 2:1, and 1:2.

1. User Manual Araya
Bilingual TMX
Editor
Description how to use the Araya
Bilingual TMX Editor
© Dr. Klemens Waldhör, Heartsome Europe GmbH, 2006, 2007

2. Heartsome Europe GmbH
www.heartsome.de
Bilingual TMX Editor
The bilingual TMX Editor is a simple to use, but
efficient tool to view and edit TMX files for two
languages
A language pair consists of a source and target segment
In contrast to the TMX Editor it works just for two
languages.
It contains a project tool supporting the fast
checking of many TMX files.
It is mainly intended for checking and editing TMX
files from alignment tools.
Not recommended for huge TMX files resulting from TMX
database exports.
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 2

3. Heartsome Europe GmbH
www.heartsome.de
TUVs and TUs
A TMX file basically consists of set of „TU“ which
represent translations for a given concept (segment)
A TU consists of one or more “TUV” which represent
the language specific translation. More than one
TUV per language can be contained in a TMX file.
Multiple alignments form the Araya alignment tool
are marked as properties:
ARAYA::MultipleTarget
ARAYA::MultipleSource
With a number.
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 3

4. Heartsome Europe GmbH
www.heartsome.de
1:1 Alignment
<tu creationdate="20060807T150626Z"
creationid="10c81fdcc93" changeid="">
<tuv xml:lang="de"
creationid="10c81fdcc93.de">
<seg>Die niederösterreichische 1:1 Aligment
Forschungseinrichtung im Bereich
eTourismus</seg>
</tuv>
<tuv xml:lang="en"
creationid="10c81fdcc93.en">
<seg>The Lower Austrian research centre for
eTourismus</seg>
</tuv>
</tu>
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 4

5. Heartsome Europe GmbH
www.heartsome.de
2:1 Alignment
<tu creationdate="20060807T150626Z"
creationid="10c81fdcc93" changeid="">
<tuv xml:lang="de" creationid="10c81fdcc93.de">
<seg>Die niederösterreichische Forschungseinrichtung
im Bereich eTourismus</seg>
</tuv> 2:1 Aligment
<tuv xml:lang="en" creationid="10c81fdcc93.en">
<prop type="EDITOR::MultipleSource">1</prop>
<seg>The Lower Austrian research centre for
eTourismus</seg>
</tuv>
<tuv xml:lang="en" creationid="10c81fdcc93.en">
<prop type="EDITOR::MultipleSource">2</prop>
<seg>The Lower LO research centre for
eTourismus</seg>
</tuv>
</tu>
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 5

6. Heartsome Europe GmbH
www.heartsome.de
1:2 Alignment
<tu creationdate="20060807T150626Z"
creationid="10c81fdcc93" changeid="">
<tuv xml:lang="de" creationid="10c81fdcc93.de">
<seg>Die niederösterreichische Forschungseinrichtung
im Bereich eTourismus</seg>
</tuv> 1:2 Aligment
<tuv xml:lang="en" creationid="10c81fdcc93.en">
<prop type="ARAYA::MultipleTarget">1</prop>
<seg>The Lower Austrian research centre for
eTourismus</seg>
</tuv>
<tuv xml:lang="en" creationid="10c81fdcc93.en">
<prop type="ARAYA::MultipleTarget">2</prop>
<seg>The Lower LO research centre for
eTourismus</seg>
</tuv>
</tu>
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 6

7. Heartsome Europe GmbH
www.heartsome.de
Bilingual TMX Editor Versions
It is available as
Single user version of Araya.
It is part of the Araya Server translation tools.
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 7

8. Heartsome Europe GmbH
www.heartsome.de
Differences to Araya TMX Editor
-
Bilingual Editor does not allow to edit entries
Only for two languages
+
Command Center
Project Support
Supports converting n:m alignments into 1:1
alignment
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 8

9. Heartsome Europe GmbH
www.heartsome.de
Installation
It is installed with the Araya Software package
Installation goes into directory c:/Program Files/Araya. It is
recommended not to change this as all initialization files map
towards this directory.
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 9

10. Heartsome Europe GmbH
www.heartsome.de
Starting Bilingual TMX Editor
Go to directory:
c:/Program Files/Araya
Start: bitmx.exe
Or double click :
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 10

11. Heartsome Europe GmbH
www.heartsome.de
User Interface
Source Language Target Language
Segments Segments
TU Number
N:M Alignments
Segment Number
per language
(TUV) for multiple
alignments
Source segment Target segment
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 11

12. Heartsome Europe GmbH
www.heartsome.de
Source and Target Segment Display
Format information is displayed in green.
Formats are sequentially numbered.
Format Format Format Format
start number content end
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 12

13. Heartsome Europe GmbH
www.heartsome.de
Modifying Entries
Entries can be modified using a right mouse
click on the table item = entry.
Deletes the whole entry = TU; use for 1:1 alignments
Deletes the whole entry = TU, including all the
multiple aligned TUV
Deletes the source segment = TUV
Deletes the target segment = TUV
Mark start of a source segment
Mark end of a source segment
Mark start of a target segment
Mark end of a target segment
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 13

14. Heartsome Europe GmbH
www.heartsome.de
Marking Entries (TUVs and TUs)
Entries can be marked with a start and end marker
for a delete operation
Start (green) and end (blue) are shown by different
colors
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 14

15. Heartsome Europe GmbH
www.heartsome.de
File Menu Open a TMX File
Close open TMX File
Save TMX File
Save TMX File with new name
Convert TMX File containing n:m
alignments to 1:1 alignments
Create new project
Open project
Open Bilingual Command Center
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 15

16. Heartsome Europe GmbH
www.heartsome.de
The Options Menu
Character set for the
extraction table
User Interface
Language
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 16

17. Heartsome Europe GmbH
www.heartsome.de
The Plugins Menu
Conversion between
character sets
Check and recode
languages in TMX files
Display of
Araya Log-
File
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 17

18. Heartsome Europe GmbH
www.heartsome.de
The Help Menu
Display user manual
Araya / Heartsome
Homepage
About the bilingual
extraction
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 18

19. Heartsome Europe GmbH
www.heartsome.de
About the BiLingual BiTMX Editor
Basic information about the
Araya configuration is shown
here.
This can be important for
error diagnosis
Using „Save…“ the
information is stored in the
specified file.
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 19

20. Heartsome Europe GmbH
www.heartsome.de
Converting Files between different
Character Encodings Source file name
Target file; will be created based
on source file name and as
extension the target encoding
character set
Source encoding character set
Target encoding character set
This function supports converting files between different character sets. Depending on the target character
up to two files are written. If the target file is a UTF-8, 16, 32 or UCS file, two files are written. The second file
with the extension „.nobom“ is a copy of the first target file, the only difference is that the BOM (Byte Order
Marks) are removed from this file. This file should be used for importing, esp. when an import of an UTF-8
file is done in Araya, as the Java reading functions for UTF-8 does not over read the BOM characters. This
could lead to problems when reading normal strings from those file as the BOMs are read as normal
characters resulting in invalid entries.
(This is a known bug in Java UTF-8 file reading, but will not be corrected by SUN!).
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 20

21. Heartsome Europe GmbH
www.heartsome.de
Creating a Project
Enter a new project file name
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 21

22. Heartsome Europe GmbH
www.heartsome.de
Adding TMX Files to Project
Choose one or more TMX file using the
button Add Files
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 22

23. Heartsome Europe GmbH
www.heartsome.de
Open Project
Choose a project file
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 23

24. Heartsome Europe GmbH
www.heartsome.de
Project Handling
List of TMX Files
checked
= DONE List
List of TMX Files to
be checked
= TO BE DONE List
= TBD List
Convert all TMX files
in TBD List to 1:1
Add one or more TMX Save Lists Save Lists with Remove all TMX files
alignments
Files to TBD List a new name from DONE List
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 24

25. Heartsome Europe GmbH
www.heartsome.de
Select Item in TBD or DONE List
Selecting a file name
in TDB or DONE list
opens the file in the
editor
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 25

26. Heartsome Europe GmbH
www.heartsome.de
Right Mouse Button Support
Right Mouse Click
in DONE List
Right Mouse Click
in TBD List
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 26

27. Heartsome Europe GmbH
www.heartsome.de
Bilingual Command Center 1
The Bilingual Command Center is always the top
window.
It supports different operations in a single place.
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 27

28. Heartsome Europe GmbH
www.heartsome.de
Bilingual Command Center 2
Mark operation are used to mark specific source and target
segments (TUVs) as regions for specific operations.
Currently only deleting a set of entries marked (TUs) is supported.
Marked TUVs are coloured in green = start and blue = end of mark
region.
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 28

29. Heartsome Europe GmbH
www.heartsome.de
Bilingual Command Center 3
Delete Entry (TU) deletes either a TU entry if it is a 1:1 aligned
segment or deletes the corresponding TUV pair in a TU.
Delete Multiple Aligned Entry (TU) deletes a TU entry in any case
including all n:m alignments contained.
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 29

30. Heartsome Europe GmbH
www.heartsome.de
Bilingual Command Center 4
Delete Source Segment (TUV) deletes a TUV source segment.
Delete Target Segment (TUV) deletes a TUV target segment.
Both operations only clear the segment, they do not remove them!
The deleted entries are marked red.
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 30

31. Heartsome Europe GmbH
www.heartsome.de
Bilingual Command Center 5
Delete Marked Entries (TUs) deletes all the entries of a marked
region using the source entry markers. It starts with the marked
source start entry and ends with the marked source end entry.
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 31

32. Heartsome Europe GmbH
www.heartsome.de
Bilingual Command Center 6
Move Up operations move the (source or target) segment after the
selected entry up one item
This segment will be overwritten!
It overwrites the preceding item..
If this
segment is
the selected
entry “Move
up” will move
it up one
segment
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 32

33. Heartsome Europe GmbH
www.heartsome.de
Check and Recode TMX Files TMX file name
Recoded TMX file name;
Consists of tmx file
name, any “.tmx”
extension removed and
“.recoded.tmx” added
Light yellow lines Language codes
Green lines indicate language supported by Araya
indicate language codes not supported Combo box appears
codes supported by Araya only in case language
by Araya codes in TMX file not
supported by Araya
Start checking Recode languages
languages using new language for
contained in TMX the specified TMX File
File language
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 33

34. Heartsome Europe GmbH
www.heartsome.de
Project File Format File Identification
bitmxedit-project
D:arayatesttrctrctranslate.tmx,done File in DONE List
D:arayatestrpcsimplexml.tmx,done
D:arayatestaliel-eneuroparl-el-en.tmx,tbd
D:arayatestalies-eneuroparl-es-en.tmx,tbd File in TBD List
D:arayatesttmxmerge0011E.xml.tmx,tbd
D:arayatesttmxmerge0002E.xml.tmx,tbd
D:arayatesttmxmerge0003E.xml.tmx,tbd
D:arayatesttmxmerge0004E.xml.tmx,tbd
D:arayatesttmxmerge0005E.xml.tmx,tbd
D:arayatesttmxmerge0006E.xml.tmx,tbd
D:arayatesttmxmerge0007E.xml.tmx,tbd
D:arayatesttmxmerge0008E.xml.tmx,tbd
D:arayatesttmxmerge0009E.xml.tmx,tbd
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 34

35. Heartsome Europe GmbH
www.heartsome.de
Impressum
Heartsome Europe GmbH
Friedrichstr. 17
D-90574 Roßtal
Email: klemens.waldhoer@heartsome.de
www.heartsome.de
© 2007 Heartsome Europe GmbH
29.06.2007 (c) 2006, 2007, Heartsome Europe GmbH 35