chiark / gitweb /
0a791acd43864f0c57d43f21b58f1654418afd3d
[developers-reference.git] / po4a / po / l10n.pot
1 # SOME DESCRIPTIVE TITLE
2 # Copyright (C) YEAR Free Software Foundation, Inc.
3 # This file is distributed under the same license as the PACKAGE package.
4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
5 #
6 #, fuzzy
7 msgid ""
8 msgstr ""
9 "Project-Id-Version: PACKAGE VERSION\n"
10 "POT-Creation-Date: 2011-03-03 11:18-0400\n"
11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
13 "Language-Team: LANGUAGE <LL@li.org>\n"
14 "Language: \n"
15 "MIME-Version: 1.0\n"
16 "Content-Type: text/plain; charset=UTF-8\n"
17 "Content-Transfer-Encoding: 8bit\n"
18
19 #. type: Content of: <chapter><title>
20 #: l10n.dbk:7
21 msgid "Internationalization and Translations"
22 msgstr ""
23
24 #. type: Content of: <chapter><para>
25 #: l10n.dbk:9
26 msgid ""
27 "Debian supports an ever-increasing number of natural languages.  Even if you "
28 "are a native English speaker and do not speak any other language, it is part "
29 "of your duty as a maintainer to be aware of issues of internationalization "
30 "(abbreviated i18n because there are 18 letters between the 'i' and the 'n' "
31 "in internationalization).  Therefore, even if you are ok with English-only "
32 "programs, you should read most of this chapter."
33 msgstr ""
34
35 #. type: Content of: <chapter><para>
36 #: l10n.dbk:17
37 msgid ""
38 "According to <ulink url=\"&url-i18n-intro;\">Introduction to i18n</ulink> "
39 "from Tomohiro KUBOTA, I18N (internationalization) means modification of a "
40 "software or related technologies so that a software can potentially handle "
41 "multiple languages, customs, and so on in the world, while L10N "
42 "(localization) means implementation of a specific language for an already "
43 "internationalized software."
44 msgstr ""
45
46 #. type: Content of: <chapter><para>
47 #: l10n.dbk:26
48 msgid ""
49 "l10n and i18n are interconnected, but the difficulties related to each of "
50 "them are very different.  It's not really difficult to allow a program to "
51 "change the language in which texts are displayed based on user settings, but "
52 "it is very time consuming to actually translate these messages.  On the "
53 "other hand, setting the character encoding is trivial, but adapting the code "
54 "to use several character encodings is a really hard problem."
55 msgstr ""
56
57 #. type: Content of: <chapter><para>
58 #: l10n.dbk:34
59 msgid ""
60 "Setting aside the i18n problems, where no general guideline can be given, "
61 "there is actually no central infrastructure for l10n within Debian which "
62 "could be compared to the buildd mechanism for porting.  So most of the work "
63 "has to be done manually."
64 msgstr ""
65
66 #. type: Content of: <chapter><section><title>
67 #: l10n.dbk:40
68 msgid "How translations are handled within Debian"
69 msgstr ""
70
71 #. type: Content of: <chapter><section><para>
72 #: l10n.dbk:42
73 msgid ""
74 "Handling translation of the texts contained in a package is still a manual "
75 "task, and the process depends on the kind of text you want to see "
76 "translated."
77 msgstr ""
78
79 #. type: Content of: <chapter><section><para>
80 #: l10n.dbk:46
81 msgid ""
82 "For program messages, the gettext infrastructure is used most of the time.  "
83 "Most of the time, the translation is handled upstream within projects like "
84 "the <ulink url=\"&url-l10n-tp;\">Free Translation Project</ulink>, the "
85 "<ulink url=\"&url-l10n-gnome;\">Gnome translation Project</ulink> or the "
86 "<ulink url=\"&url-l10n-kde;\">KDE one</ulink>.  The only centralized "
87 "resource within Debian is the <ulink url=\"&url-l10n;\">Central Debian "
88 "translation statistics</ulink>, where you can find some statistics about the "
89 "translation files found in the actual packages, but no real infrastructure "
90 "to ease the translation process."
91 msgstr ""
92
93 #. type: Content of: <chapter><section><para>
94 #: l10n.dbk:59
95 msgid ""
96 "An effort to translate the package descriptions started long ago, even if "
97 "very little support is offered by the tools to actually use them (i.e., only "
98 "APT can use them, when configured correctly).  Maintainers don't need to do "
99 "anything special to support translated package descriptions; translators "
100 "should use the <ulink url=\"&url-ddtp;\">Debian Description Translation "
101 "Project (DDTP)</ulink>."
102 msgstr ""
103
104 #. type: Content of: <chapter><section><para>
105 #: l10n.dbk:66
106 msgid ""
107 "For <systemitem role=\"package\">debconf</systemitem> templates, maintainers "
108 "should use the <systemitem role=\"package\">po-debconf</systemitem> package "
109 "to ease the work of translators, who could use the DDTP to do their work "
110 "(but the French and Brazilian teams don't).  Some statistics can be found "
111 "both on the <ulink url=\"&url-ddtp;\">DDTP site</ulink> (about what is "
112 "actually translated), and on the <ulink url=\"&url-l10n;\">Central Debian "
113 "translation statistics</ulink> site (about what is integrated in the "
114 "packages)."
115 msgstr ""
116
117 #. type: Content of: <chapter><section><para>
118 #: l10n.dbk:75
119 msgid ""
120 "For web pages, each l10n team has access to the relevant VCS, and the "
121 "statistics are available from the Central Debian translation statistics "
122 "site."
123 msgstr ""
124
125 #. type: Content of: <chapter><section><para>
126 #: l10n.dbk:79
127 msgid ""
128 "For general documentation about Debian, the process is more or less the same "
129 "as for the web pages (the translators have access to the VCS), but there are "
130 "no statistics pages."
131 msgstr ""
132
133 #. type: Content of: <chapter><section><para>
134 #: l10n.dbk:84
135 msgid ""
136 "For package-specific documentation (man pages, info documents, other "
137 "formats), almost everything remains to be done."
138 msgstr ""
139
140 #. type: Content of: <chapter><section><para>
141 #: l10n.dbk:88
142 msgid ""
143 "Most notably, the KDE project handles translation of its documentation in "
144 "the same way as its program messages."
145 msgstr ""
146
147 #. type: Content of: <chapter><section><para>
148 #: l10n.dbk:92
149 msgid ""
150 "There is an effort to handle Debian-specific man pages within a <ulink "
151 "url=\"&url-cvsweb;manpages/?cvsroot=debian-doc\">specific VCS "
152 "repository</ulink>."
153 msgstr ""
154
155 #. type: Content of: <chapter><section><title>
156 #: l10n.dbk:99
157 msgid "I18N &amp; L10N FAQ for maintainers"
158 msgstr ""
159
160 #. type: Content of: <chapter><section><para>
161 #: l10n.dbk:101
162 msgid ""
163 "This is a list of problems that maintainers may face concerning i18n and "
164 "l10n.  While reading this, keep in mind that there is no real consensus on "
165 "these points within Debian, and that this is only advice.  If you have a "
166 "better idea for a given problem, or if you disagree on some points, feel "
167 "free to provide your feedback, so that this document can be enhanced."
168 msgstr ""
169
170 #. type: Content of: <chapter><section><section><title>
171 #: l10n.dbk:108
172 msgid "How to get a given text translated"
173 msgstr ""
174
175 #. type: Content of: <chapter><section><section><para>
176 #: l10n.dbk:110
177 msgid ""
178 "To translate package descriptions or <systemitem "
179 "role=\"package\">debconf</systemitem> templates, you have nothing to do; the "
180 "DDTP infrastructure will dispatch the material to translate to volunteers "
181 "with no need for interaction from your part."
182 msgstr ""
183
184 #. type: Content of: <chapter><section><section><para>
185 #: l10n.dbk:115
186 msgid ""
187 "For all other material (gettext files, man pages, or other documentation), "
188 "the best solution is to put your text somewhere on the Internet, and ask on "
189 "debian-i18n for a translation in different languages.  Some translation team "
190 "members are subscribed to this list, and they will take care of the "
191 "translation and of the reviewing process.  Once they are done, you will get "
192 "your translated document from them in your mailbox."
193 msgstr ""
194
195 #. type: Content of: <chapter><section><section><title>
196 #: l10n.dbk:125
197 msgid "How to get a given translation reviewed"
198 msgstr ""
199
200 #. type: Content of: <chapter><section><section><para>
201 #: l10n.dbk:127
202 msgid ""
203 "From time to time, individuals translate some texts in your package and will "
204 "ask you for inclusion of the translation in the package.  This can become "
205 "problematic if you are not fluent in the given language.  It is a good idea "
206 "to send the document to the corresponding l10n mailing list, asking for a "
207 "review.  Once it has been done, you should feel more confident in the "
208 "quality of the translation, and feel safe to include it in your package."
209 msgstr ""
210
211 #. type: Content of: <chapter><section><section><title>
212 #: l10n.dbk:137
213 msgid "How to get a given translation updated"
214 msgstr ""
215
216 #. type: Content of: <chapter><section><section><para>
217 #: l10n.dbk:139
218 msgid ""
219 "If you have some translations of a given text lying around, each time you "
220 "update the original, you should ask the previous translator to update the "
221 "translation with your new changes.  Keep in mind that this task takes time; "
222 "at least one week to get the update reviewed and all."
223 msgstr ""
224
225 #. type: Content of: <chapter><section><section><para>
226 #: l10n.dbk:145
227 msgid ""
228 "If the translator is unresponsive, you may ask for help on the corresponding "
229 "l10n mailing list.  If everything fails, don't forget to put a warning in "
230 "the translated document, stating that the translation is somehow outdated, "
231 "and that the reader should refer to the original document if possible."
232 msgstr ""
233
234 #. type: Content of: <chapter><section><section><para>
235 #: l10n.dbk:151
236 msgid ""
237 "Avoid removing a translation completely because it is outdated.  Old "
238 "documentation is often better than no documentation at all for non-English "
239 "speakers."
240 msgstr ""
241
242 #. type: Content of: <chapter><section><section><title>
243 #: l10n.dbk:158
244 msgid "How to handle a bug report concerning a translation"
245 msgstr ""
246
247 #.  TODO: add the i18n tag to the bug? 
248 #. type: Content of: <chapter><section><section><para>
249 #: l10n.dbk:160
250 msgid ""
251 "The best solution may be to mark the bug as forwarded to upstream, and "
252 "forward it to both the previous translator and his/her team (using the "
253 "corresponding debian-l10n-XXX mailing list)."
254 msgstr ""
255
256 #. type: Content of: <chapter><section><title>
257 #: l10n.dbk:170
258 msgid "I18N &amp; L10N FAQ for translators"
259 msgstr ""
260
261 #. type: Content of: <chapter><section><para>
262 #: l10n.dbk:172
263 msgid ""
264 "While reading this, please keep in mind that there is no general procedure "
265 "within Debian concerning these points, and that in any case, you should "
266 "collaborate with your team and the package maintainer."
267 msgstr ""
268
269 #. type: Content of: <chapter><section><section><title>
270 #: l10n.dbk:177
271 msgid "How to help the translation effort"
272 msgstr ""
273
274 #. type: Content of: <chapter><section><section><para>
275 #: l10n.dbk:179
276 msgid ""
277 "Choose what you want to translate, make sure that nobody is already working "
278 "on it (using your debian-l10n-XXX mailing list), translate it, get it "
279 "reviewed by other native speakers on your l10n mailing list, and provide it "
280 "to the maintainer of the package (see next point)."
281 msgstr ""
282
283 #. type: Content of: <chapter><section><section><title>
284 #: l10n.dbk:187
285 msgid "How to provide a translation for inclusion in a package"
286 msgstr ""
287
288 #. type: Content of: <chapter><section><section><para>
289 #: l10n.dbk:189
290 msgid ""
291 "Make sure your translation is correct (asking for review on your l10n "
292 "mailing list) before providing it for inclusion.  It will save time for "
293 "everyone, and avoid the chaos resulting in having several versions of the "
294 "same document in bug reports."
295 msgstr ""
296
297 #. type: Content of: <chapter><section><section><para>
298 #: l10n.dbk:195
299 msgid ""
300 "The best solution is to file a regular bug containing the translation "
301 "against the package.  Make sure to use the 'PATCH' tag, and to not use a "
302 "severity higher than 'wishlist', since the lack of translation never "
303 "prevented a program from running."
304 msgstr ""
305
306 #. type: Content of: <chapter><section><title>
307 #: l10n.dbk:205
308 msgid "Best current practice concerning l10n"
309 msgstr ""
310
311 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
312 #: l10n.dbk:209
313 msgid ""
314 "As a maintainer, never edit the translations in any way (even to reformat "
315 "the layout) without asking on the corresponding l10n mailing list.  You risk "
316 "for example breaking the encoding of the file by doing so.  Moreover, what "
317 "you consider an error can be right (or even needed) in the given language."
318 msgstr ""
319
320 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
321 #: l10n.dbk:217
322 msgid ""
323 "As a translator, if you find an error in the original text, make sure to "
324 "report it.  Translators are often the most attentive readers of a given "
325 "text, and if they don't report the errors they find, nobody will."
326 msgstr ""
327
328 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
329 #: l10n.dbk:224
330 msgid ""
331 "In any case, remember that the major issue with l10n is that it requires "
332 "several people to cooperate, and that it is very easy to start a flamewar "
333 "about small problems because of misunderstandings.  So if you have problems "
334 "with your interlocutor, ask for help on the corresponding l10n mailing list, "
335 "on debian-i18n, or even on debian-devel (but beware, l10n discussions very "
336 "often become flamewars on that list :)"
337 msgstr ""
338
339 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
340 #: l10n.dbk:234
341 msgid ""
342 "In any case, cooperation can only be achieved with <emphasis "
343 "role=\"strong\">mutual respect</emphasis>."
344 msgstr ""