1 # Debian Developer's Reference (Japanese)
2 # (C) Hideki Yamane (Debian-JP) <henrich@debian.or.jp>, 2008-2010.
6 "Project-Id-Version: developers-reference 3.4.4\n"
7 "POT-Creation-Date: 2010-06-20 09:23-0400\n"
8 "PO-Revision-Date: 2010-01-06 10:27+0900\n"
9 "Last-Translator: Hideki Yamane (Debian-JP) <henrich@debian.or.jp>\n"
10 "Language-Team: Debian JP Project <debian-doc@debian.or.jp>\n"
13 "Content-Type: text/plain; charset=UTF-8\n"
14 "Content-Transfer-Encoding: 8bit\n"
16 #. type: Content of: <chapter><title>
18 msgid "Internationalization and Translations"
21 # type: Content of: <chapter><para>
22 #. type: Content of: <chapter><para>
25 "Debian supports an ever-increasing number of natural languages. Even if you "
26 "are a native English speaker and do not speak any other language, it is part "
27 "of your duty as a maintainer to be aware of issues of internationalization "
28 "(abbreviated i18n because there are 18 letters between the 'i' and the 'n' "
29 "in internationalization). Therefore, even if you are ok with English-only "
30 "programs, you should read most of this chapter."
32 "Debian がサポートしている自然言語の数は未だ増え続けています。あなたが英語圏の"
33 "ネイティブスピーカーで他の言語を話さないとしても、国際化の問題について注意を"
34 "払うことはメンテナとしてのあなたの責務です (internationalization の 'i' と "
35 "'n' の間に 18 文字があるので i18n と略されます)。つまり、あなたが英語のみのプ"
36 "ログラムを扱っていて問題がない場合であっても、この章の大部分を読んでおく必要"
39 # type: Content of: <chapter><para>
40 #. type: Content of: <chapter><para>
43 "According to <ulink url=\"&url-i18n-intro;\">Introduction to i18n</ulink> "
44 "from Tomohiro KUBOTA, I18N (internationalization) means modification of a "
45 "software or related technologies so that a software can potentially handle "
46 "multiple languages, customs, and so on in the world, while L10N "
47 "(localization) means implementation of a specific language for an already "
48 "internationalized software."
50 "久保田智広さんによる <ulink url=\"&url-i18n-intro;\">Introduction to i18n</"
51 "ulink> によると、I18N (internationalization) はソフトウェアや関連する技術を調"
52 "整し、ソフトウェアが複数の言語、習慣、その他世界の物事などを扱えるようにする"
53 "ことで、対して L10N (localization) は既に国際化されているソフトウェアに対して"
56 # type: Content of: <chapter><para>
57 #. type: Content of: <chapter><para>
60 "l10n and i18n are interconnected, but the difficulties related to each of "
61 "them are very different. It's not really difficult to allow a program to "
62 "change the language in which texts are displayed based on user settings, but "
63 "it is very time consuming to actually translate these messages. On the "
64 "other hand, setting the character encoding is trivial, but adapting the code "
65 "to use several character encodings is a really hard problem."
67 "l10n と i18n は関連していますが、それぞれ関連する難しさについては違います。プ"
68 "ログラムをユーザの設定に応じて表示されるテキストの言語を変更するようにするの"
69 "はあまり難しくはありませんが、実際にメッセージを翻訳するのはとても時間がかか"
70 "ります。一方、文字のエンコード設定は些細な事ですが、複数の文字エンコードを扱"
71 "えるようなコードにするのはとても難しい問題です。"
73 # type: Content of: <chapter><para>
74 #. type: Content of: <chapter><para>
77 "Setting aside the i18n problems, where no general guideline can be given, "
78 "there is actually no central infrastructure for l10n within Debian which "
79 "could be compared to the buildd mechanism for porting. So most of the work "
80 "has to be done manually."
83 # type: Content of: <chapter><section><title>
84 #. type: Content of: <chapter><section><title>
86 msgid "How translations are handled within Debian"
87 msgstr "どの様にして Debian では翻訳が取り扱われているか"
89 # type: Content of: <chapter><section><para>
90 #. type: Content of: <chapter><section><para>
93 "Handling translation of the texts contained in a package is still a manual "
94 "task, and the process depends on the kind of text you want to see translated."
96 "パッケージに含まれている文章の翻訳の取扱いは未だ手動であり、作業は翻訳したも"
99 # type: Content of: <chapter><section><para>
100 #. type: Content of: <chapter><section><para>
103 "For program messages, the gettext infrastructure is used most of the time. "
104 "Most of the time, the translation is handled upstream within projects like "
105 "the <ulink url=\"&url-l10n-tp;\">Free Translation Project</ulink>, the "
106 "<ulink url=\"&url-l10n-gnome;\">Gnome translation Project</ulink> or the "
107 "<ulink url=\"&url-l10n-kde;\">KDE one</ulink>. The only centralized "
108 "resource within Debian is the <ulink url=\"&url-l10n;\">Central Debian "
109 "translation statistics</ulink>, where you can find some statistics about the "
110 "translation files found in the actual packages, but no real infrastructure "
111 "to ease the translation process."
113 "プログラムのメッセージについては、ほとんどが gettext という仕組みが使われてい"
114 "ます。多くの場合、翻訳は <ulink url=\"&url-l10n-tp;\">Free Translation "
115 "Project</ulink> や <ulink url=\"&url-l10n-gnome;\">Gnome translation "
116 "Project</ulink>、<ulink url=\"&url-l10n-kde;/\">KDE one</ulink> などの開発元 "
117 "(upstream) のプロジェクトで取り扱われています。Debian で唯一の集約化された情"
118 "報は <ulink url=\"&url-l10n;\">Debian の翻訳に関する統計</ulink>で、実際の"
119 "パッケージ内での翻訳ファイルの状況について確認できますが、翻訳作業を実際に容"
122 #. type: Content of: <chapter><section><para>
125 "An effort to translate the package descriptions started long ago, even if "
126 "very little support is offered by the tools to actually use them (i.e., only "
127 "APT can use them, when configured correctly). Maintainers don't need to do "
128 "anything special to support translated package descriptions; translators "
129 "should use the <ulink url=\"&url-ddtp;\">Debian Description Translation "
130 "Project (DDTP)</ulink>."
133 #. type: Content of: <chapter><section><para>
136 "For <systemitem role=\"package\">debconf</systemitem> templates, maintainers "
137 "should use the <systemitem role=\"package\">po-debconf</systemitem> package "
138 "to ease the work of translators, who could use the DDTP to do their work "
139 "(but the French and Brazilian teams don't). Some statistics can be found "
140 "both on the <ulink url=\"&url-ddtp;\">DDTP site</ulink> (about what is "
141 "actually translated), and on the <ulink url=\"&url-l10n;\">Central Debian "
142 "translation statistics</ulink> site (about what is integrated in the "
146 # type: Content of: <chapter><section><para>
147 #. type: Content of: <chapter><section><para>
150 "For web pages, each l10n team has access to the relevant VCS, and the "
151 "statistics are available from the Central Debian translation statistics site."
153 "ウェブページについては、それぞれの l10n チームが対応する VCS にアクセスし、"
154 "Debian の翻訳に関する統計サイトから統計情報が取得できます。"
156 # type: Content of: <chapter><section><para>
157 #. type: Content of: <chapter><section><para>
160 "For general documentation about Debian, the process is more or less the same "
161 "as for the web pages (the translators have access to the VCS), but there are "
162 "no statistics pages."
164 "Debian についての一般的なドキュメントは、作業は多少の差はあれウェブページと同"
165 "じです (翻訳者は VCS にアクセスします)。ですが、統計情報のページはありませ"
168 # type: Content of: <chapter><section><para>
169 #. type: Content of: <chapter><section><para>
173 "For package-specific documentation (man pages, info documents, other "
174 "formats), almost everything remains to be done."
175 msgstr "パッケージ固有のドキュメント (man ページ、info ドキュメントその他) は"
177 # type: Content of: <chapter><section><para>
178 #. type: Content of: <chapter><section><para>
181 "Most notably, the KDE project handles translation of its documentation in "
182 "the same way as its program messages."
185 # type: Content of: <chapter><section><para>
186 #. type: Content of: <chapter><section><para>
189 "There is an effort to handle Debian-specific man pages within a <ulink url="
190 "\"&url-cvsweb;manpages/?cvsroot=debian-doc\">specific VCS repository</ulink>."
192 "Debian 固有の man ページを <ulink url=\"&url-cvsweb;manpages/?cvsroot=debian-"
193 "doc\">特定の VCS リポジトリ</ulink> で取り扱おうという動きもあります。"
195 # type: Content of: <chapter><section><title>
196 #. type: Content of: <chapter><section><title>
198 msgid "I18N & L10N FAQ for maintainers"
199 msgstr "メンテナへの I18N & L10N FAQ"
201 # type: Content of: <chapter><section><para>
202 #. type: Content of: <chapter><section><para>
205 "This is a list of problems that maintainers may face concerning i18n and "
206 "l10n. While reading this, keep in mind that there is no real consensus on "
207 "these points within Debian, and that this is only advice. If you have a "
208 "better idea for a given problem, or if you disagree on some points, feel "
209 "free to provide your feedback, so that this document can be enhanced."
212 # type: Content of: <chapter><section><section><title>
213 #. type: Content of: <chapter><section><section><title>
215 msgid "How to get a given text translated"
216 msgstr "翻訳された文章を得るには"
218 #. type: Content of: <chapter><section><section><para>
221 "To translate package descriptions or <systemitem role=\"package\">debconf</"
222 "systemitem> templates, you have nothing to do; the DDTP infrastructure will "
223 "dispatch the material to translate to volunteers with no need for "
224 "interaction from your part."
227 # type: Content of: <chapter><section><section><para>
228 #. type: Content of: <chapter><section><section><para>
231 "For all other material (gettext files, man pages, or other documentation), "
232 "the best solution is to put your text somewhere on the Internet, and ask on "
233 "debian-i18n for a translation in different languages. Some translation team "
234 "members are subscribed to this list, and they will take care of the "
235 "translation and of the reviewing process. Once they are done, you will get "
236 "your translated document from them in your mailbox."
239 # type: Content of: <chapter><section><section><title>
240 #. type: Content of: <chapter><section><section><title>
242 msgid "How to get a given translation reviewed"
243 msgstr "どの様にして提供された翻訳をレビューするか"
245 # type: Content of: <chapter><section><section><para>
246 #. type: Content of: <chapter><section><section><para>
249 "From time to time, individuals translate some texts in your package and will "
250 "ask you for inclusion of the translation in the package. This can become "
251 "problematic if you are not fluent in the given language. It is a good idea "
252 "to send the document to the corresponding l10n mailing list, asking for a "
253 "review. Once it has been done, you should feel more confident in the "
254 "quality of the translation, and feel safe to include it in your package."
257 # type: Content of: <chapter><section><section><title>
258 #. type: Content of: <chapter><section><section><title>
260 msgid "How to get a given translation updated"
261 msgstr "どの様にして提供された翻訳を更新するか"
263 # type: Content of: <chapter><section><section><para>
264 #. type: Content of: <chapter><section><section><para>
267 "If you have some translations of a given text lying around, each time you "
268 "update the original, you should ask the previous translator to update the "
269 "translation with your new changes. Keep in mind that this task takes time; "
270 "at least one week to get the update reviewed and all."
273 # type: Content of: <chapter><section><section><para>
274 #. type: Content of: <chapter><section><section><para>
277 "If the translator is unresponsive, you may ask for help on the corresponding "
278 "l10n mailing list. If everything fails, don't forget to put a warning in "
279 "the translated document, stating that the translation is somehow outdated, "
280 "and that the reader should refer to the original document if possible."
283 # type: Content of: <chapter><section><section><para>
284 #. type: Content of: <chapter><section><section><para>
287 "Avoid removing a translation completely because it is outdated. Old "
288 "documentation is often better than no documentation at all for non-English "
291 "古くなっているからといって翻訳を全て削除するのは避けてください。非英語圏の"
292 "ユーザにとって何もドキュメントが無いよりは古いドキュメントがある方が有益であ"
295 # type: Content of: <chapter><section><section><title>
296 #. type: Content of: <chapter><section><section><title>
298 msgid "How to handle a bug report concerning a translation"
299 msgstr "どの様にして翻訳関連のバグ報告を取り扱うか"
301 # type: Content of: <chapter><section><section><para>
302 #. TODO: add the i18n tag to the bug?
303 #. type: Content of: <chapter><section><section><para>
306 "The best solution may be to mark the bug as forwarded to upstream, and "
307 "forward it to both the previous translator and his/her team (using the "
308 "corresponding debian-l10n-XXX mailing list)."
311 # type: Content of: <chapter><section><title>
312 #. type: Content of: <chapter><section><title>
314 msgid "I18N & L10N FAQ for translators"
315 msgstr "翻訳者への I18N & L10N FAQ"
317 # type: Content of: <chapter><section><para>
318 #. type: Content of: <chapter><section><para>
321 "While reading this, please keep in mind that there is no general procedure "
322 "within Debian concerning these points, and that in any case, you should "
323 "collaborate with your team and the package maintainer."
326 # type: Content of: <chapter><section><section><title>
327 #. type: Content of: <chapter><section><section><title>
329 msgid "How to help the translation effort"
330 msgstr "どの様にして翻訳作業を支援するか"
332 # type: Content of: <chapter><section><section><para>
333 #. type: Content of: <chapter><section><section><para>
336 "Choose what you want to translate, make sure that nobody is already working "
337 "on it (using your debian-l10n-XXX mailing list), translate it, get it "
338 "reviewed by other native speakers on your l10n mailing list, and provide it "
339 "to the maintainer of the package (see next point)."
342 # type: Content of: <chapter><section><section><title>
343 #. type: Content of: <chapter><section><section><title>
345 msgid "How to provide a translation for inclusion in a package"
346 msgstr "どの様にして提供した翻訳をパッケージに含めてもらうか"
348 # type: Content of: <chapter><section><section><para>
349 #. type: Content of: <chapter><section><section><para>
352 "Make sure your translation is correct (asking for review on your l10n "
353 "mailing list) before providing it for inclusion. It will save time for "
354 "everyone, and avoid the chaos resulting in having several versions of the "
355 "same document in bug reports."
358 # type: Content of: <chapter><section><section><para>
359 #. type: Content of: <chapter><section><section><para>
362 "The best solution is to file a regular bug containing the translation "
363 "against the package. Make sure to use the 'PATCH' tag, and to not use a "
364 "severity higher than 'wishlist', since the lack of translation never "
365 "prevented a program from running."
368 # type: Content of: <chapter><section><title>
369 #. type: Content of: <chapter><section><title>
371 msgid "Best current practice concerning l10n"
372 msgstr "l10n に関する現状でのベストプラクティス"
374 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
377 "As a maintainer, never edit the translations in any way (even to reformat "
378 "the layout) without asking on the corresponding l10n mailing list. You risk "
379 "for example breaking the encoding of the file by doing so. Moreover, what "
380 "you consider an error can be right (or even needed) in the given language."
383 # type: Content of: <chapter><section><itemizedlist><listitem><para>
384 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
387 "As a translator, if you find an error in the original text, make sure to "
388 "report it. Translators are often the most attentive readers of a given "
389 "text, and if they don't report the errors they find, nobody will."
392 # type: Content of: <chapter><section><itemizedlist><listitem><para>
393 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
396 "In any case, remember that the major issue with l10n is that it requires "
397 "several people to cooperate, and that it is very easy to start a flamewar "
398 "about small problems because of misunderstandings. So if you have problems "
399 "with your interlocutor, ask for help on the corresponding l10n mailing list, "
400 "on debian-i18n, or even on debian-devel (but beware, l10n discussions very "
401 "often become flamewars on that list :)"
404 # type: Content of: <chapter><section><itemizedlist><listitem><para>
405 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
408 "In any case, cooperation can only be achieved with <emphasis role=\"strong"
409 "\">mutual respect</emphasis>."