Skip to content
Permalink
Newer
Older
100644 156 lines (123 sloc) 7.31 KB
1
<?xml version="1.0"?>
2
<!--
3
4
* Licensed to the Apache Software Foundation (ASF) under one or more
5
* contributor license agreements. See the NOTICE file distributed with
6
* this work for additional information regarding copyright ownership.
7
* The ASF licenses this file to You under the Apache License, Version 2.0
8
* (the "License"); you may not use this file except in compliance with
9
* the License. You may obtain a copy of the License at
10
*
11
* http://www.apache.org/licenses/LICENSE-2.0
12
*
13
* Unless required by applicable law or agreed to in writing, software
14
* distributed under the License is distributed on an "AS IS" BASIS,
15
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16
* See the License for the specific language governing permissions and
17
* limitations under the License.
18
*
19
* @version $Id: index.xml 1203914 2011-11-19 00:23:36Z sebb $
20
-->
21
<document>
22
23
<properties>
24
25
<author email="jsalvata@atg.com">Jordi Salvat i Alabart</author>
26
27
<title>JMeter Localisation (Translator's Guide)</title>
28
29
</properties>
30
31
<body>
32
33
<section name="Introduction" anchor="intro">
34
35
<p>This document describes the process of creating and maintaining translated texts for JMeter in languages
36
other than English. English has been tacitly chosen as the project's primary (or "default") language -- despite its
37
obvious inadequacy for reasonably unambiguous communication -- as a tribute to the Power of the Empire :-)<br/>
38
The metropolitan language texts are thus maintained by the software developers, while other project contributors
39
(called "translators" in this document) take care of maintaining the texts in the languages of the
40
provinces. The process of producing and maintaining the later is called "translation" in this document.</p>
41
42
<p>This document assumes you'll be using i18nEdit as your tool to edit properties files, and instructions will
43
be specific to this software, but this is not mandatory: the process should mostly work also if you prefer to use
44
another tool, such as or <b>vi</b> or <b>Emacs</b>.
45
46
<p>This document describes 6 processes:</p>
47
<ol>
48
<li>Obtaining the current texts [translators].</li>
49
<li>Providing the current texts to translators [developers].</li>
50
<li>Downloading and running i18nEdit [everyone].</li>
51
<li>Translating [translators].</li>
52
<li>Submitting your translations to the project [translators].</li>
53
<li>Merging in new translations [committers].</li>
54
</ol>
55
</p>
56
57
</section>
58
59
<section name="Obtaining the current texts" anchor="obtain">
60
61
<p>If you want to help with JMeter's translation process, start by reading this document. Then
62
send a message to <a href="mailto:dev@jmeter.apache.org">dev@jmeter.apache.org</a>
63
stating your intention. The files you need (*.properties and *.metaprop) are included in the source archive.
64
But if you are having any difficulty, one of the project contributors will be able to grab the current texts
65
from SVN and send them to you. You'll receive a jar, zip, tar or tgz file that you'll need to unpack in your
66
local disk.</p>
67
<p>If you are familiar with SVN or you're brave, feel free to anonymously connect to the Apache SVN server
68
and obtain the JMeter source yourself, as described in
69
<a href="http://jmeter.apache.org/svnindex.html">http://jmeter.apache.org/svnindex.html</a>
70
-- the files necessary to the translation process are all under the jmeter/src directory.
71
</p>
72
<p>Once you've unpacked or checked out the files, make sure to find file src/i18nedit.properties in there:
73
you'll need to know where it is to start working with i18nEdit.</p>
74
75
</section>
76
77
<section name="Providing the current texts to translators" anchor="provide">
78
79
<p>If you have access to JMeter's SVN repository and you want to pack the files necessary for localisation
80
for sending to a translator, just go to the directory above the project root and issue the following command:<br/>
81
<code>
82
tar czf jmeter-localisation.tgz `find jmeter/src -name "*.properties" -o -name "*.metaprops"`
83
</code>
84
Of course you could also send the translator the whole jmeter directory, but this will make his life easier.
85
</p>
86
87
</section>
88
89
<section name="Downloading and running i18nEdit" anchor="i18nEdit">
90
91
<p>The runtime for i18nEdit can be obtained from
92
<a href="http://www.cantamen.com/i18nedit.php">http://www.cantamen.com/i18nedit.php</a>.
93
Download the binary distribution (i18nedit-1.0.0.jar) and save it locally.</p>
94
<p>To run i18nEdit, just make sure to have a reasonably modern Java Runtime Environment in your PATH, change
95
to the directory where you saved i18nedit-1.0.0.jar, then issue the following command:<br/>
96
<code>
97
java -jar i18nedit-1.0.0.jar
98
</code>
99
</p>
100
<p>Then:
101
<ol>
102
<li>If you've never run i18nEdit before, choose a language. The rest of this document assumes you chose UK English.</li>
103
<li>Select the "Projects" menu, then "Open project...".</li>
104
<li>Navigate to jmeter/src/, select i18nedit.properties, and press the "Open" button.</li>
105
<li>In the window that opens, select the "Project" menu, then "Project settings". Check that your target language
106
appears in the list in field "Additional locales (ISO codes)". Otherwise, add it now. Press "Save".</li>
107
</ol>
108
You're now ready to start translating.
109
</p>
110
111
</section>
112
113
<section name="Translating" anchor="translating">
114
115
<p>Before you start translating, select the "Project" menu, then "Translation settings". Choose work mode
116
"Directed translation (source to target)". Enter "en" (without the quotes) in the "Source localization" field. Enter
117
the ISO code of your target language in the "Target localization field".</p>
118
119
<p>Click on one of the editable fields in the right panel ("Comment" or "Content" for your language). Press F2.
120
i18nEdit will bring you to the first property that requires your attention, either because a translation does not yet
121
exist for it or because the English text has changed since the translation was provided. Enter or fix the text if
122
necessary, then press F2 again to repeat the process.</p>
123
124
<p>i18nEdit's on-line help is excellent: read through it for more information and tips.</p>
125
126
</section>
127
128
<section name="Submitting your translations to the project" anchor="submitting">
129
130
<p>Once you're done translating, just pack up the whole set of files in jmeter/src in a jar, zip, tar,
131
tgz, or alike and attach them to a JMeter bug report
132
(follow link to "Known bugs" in <a href="http://jmeter.apache.org/">JMeter's home page</a> for that).</p>
133
134
</section>
135
136
<section name="Merging in new translations" anchor="merging">
137
138
<p>If you're a committer receiving text files from a translator, follow this steps to merge them into
139
the project:
140
<ol>
141
<li>Unpack the files submitted by the translator in a separate directory.</li>
142
<li>Start i18nEdit as described in <a href="#i18nEdit">Downloading and running i18nEdit</a> above.</li>
143
<li>If the translator worked in a new language, make sure it is listed in the Additional locales field in the Project Settings.</li>
144
<li>Open the "Team" menu and select "Merge changes as integrator".</li>
145
<li>Enter the path to the src directory in the files submitted by the translator.</li>
146
<li>Select the translator's target language.</li>
147
<li>Press "Perform merge".</li>
148
<li>Close i18nEdit and commit to SVN as usual (remember to Refresh your project if you're using Eclipse).</li>
149
</ol>
150
</p>
151
152
</section>
153
154
</body>
155
156
</document>
You can’t perform that action at this time.