/usr/share/doc/developers-reference-ja/ch08.html is in developers-reference-ja 3.4.17.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 | <?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>第8章 国際化と翻訳</title>
<link rel="stylesheet" type="text/css" href="developers-reference.css"/>
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1"/>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<link rel="home" href="index.html" title="Debian 開発者リファレンス"/>
<link rel="up" href="index.html" title="Debian 開発者リファレンス"/>
<link rel="prev" href="ch07.html" title="第7章 パッケージ化、そして…"/>
<link rel="next" href="apa.html" title="付録A Debian メンテナツールの概要"/>
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">第8章 国際化と翻訳</th>
</tr>
<tr>
<td align="left"><a accesskey="p" href="ch07.html"><img src="images/prev.png" alt="戻る"/></a> </td>
<th width="60%" align="center"> </th>
<td align="right"> <a accesskey="n" href="apa.html"><img src="images/next.png" alt="次へ"/></a></td>
</tr>
</table>
<hr/>
</div>
<div class="chapter">
<div class="titlepage">
<div>
<div>
<h1 class="title"><a id="l10n"/>第8章 国際化と翻訳</h1>
</div>
</div>
</div>
<div class="toc">
<p>
<strong>目次</strong>
</p>
<dl class="toc">
<dt>
<span class="section">
<a href="ch08.html#l10n-handling">8.1. どの様にして Debian では翻訳が取り扱われているか</a>
</span>
</dt>
<dt>
<span class="section">
<a href="ch08.html#l10n-faqm">8.2. メンテナへの I18N & L10N FAQ</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class="section">
<a href="ch08.html#l10n-faqm-tr">8.2.1. 翻訳された文章を得るには</a>
</span>
</dt>
<dt>
<span class="section">
<a href="ch08.html#l10n-faqm-rev">8.2.2. どの様にして提供された翻訳をレビューするか</a>
</span>
</dt>
<dt>
<span class="section">
<a href="ch08.html#l10n-faqm-update">8.2.3. どの様にして翻訳してもらった文章を更新するか</a>
</span>
</dt>
<dt>
<span class="section">
<a href="ch08.html#l10n-faqm-bug">8.2.4. どの様にして翻訳関連のバグ報告を取り扱うか</a>
</span>
</dt>
</dl>
</dd>
<dt>
<span class="section">
<a href="ch08.html#l10n-faqtr">8.3. 翻訳者への I18N & L10N FAQ</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class="section">
<a href="ch08.html#l10n-faqtr-help">8.3.1. どの様にして翻訳作業を支援するか</a>
</span>
</dt>
<dt>
<span class="section">
<a href="ch08.html#l10n-faqtr-inc">8.3.2. どの様にして提供した翻訳をパッケージに含めてもらうか</a>
</span>
</dt>
</dl>
</dd>
<dt>
<span class="section">
<a href="ch08.html#l10n-best">8.4. l10n に関する現状でのベストプラクティス</a>
</span>
</dt>
</dl>
</div>
<p>
Debian
がサポートしている自然言語の数は未だ増え続けています。あなたが英語圏のネイティブスピーカーで他の言語を話さないとしても、国際化の問題について注意を払うことはメンテナとしてのあなたの責務です
(internationalization の 'i' と 'n' の間に 18 文字があるので i18n
と略されます)。つまり、あなたが英語のみのプログラムを扱っていて問題がない場合であっても、この章の大部分を読んでおく必要があるということです。
</p>
<p>
久保田智広さんによる <a class="ulink" href="https://www.debian.org/doc/manuals/intro-i18n/">Introduction to i18n</a>
によると、I18N (internationalization)
はソフトウェアや関連する技術を調整し、ソフトウェアが複数の言語、習慣、その他世界の物事などを扱えるようにしておくことで、対して L10N
(localization) は既に国際化されているソフトウェアに対して特定の言語を実装することを意味します。
</p>
<p>
l10n と i18n
は関連していますが、それぞれ関連する難しさについては違います。プログラムをユーザの設定に応じて表示されるテキストの言語を変更するようにするのはあまり難しくはありませんが、実際にメッセージを翻訳するのはとても時間がかかります。一方、文字のエンコード設定は些細な事ですが、複数の文字エンコードを扱えるようなコードにするのはとても難しい問題です。
</p>
<p>
i18n の問題を横においたとしても、一般的なガイドラインは与えられておらず、移植作業用の buildd のメカニズムと比較できるような、Debian
での l10n 用の中心となるインフラは実際のところ存在していません。そのため、多くの作業は手動で行わねばなりません。
</p>
<div class="section">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a id="l10n-handling"/>8.1. どの様にして Debian では翻訳が取り扱われているか</h2>
</div>
</div>
</div>
<p>
パッケージに含まれている文章の翻訳の取り扱いは未だ手動であり、作業のやり方は翻訳を表示させたい文の種類に因ります。
</p>
<p>
プログラムのメッセージについては、ほとんどの場合 gettext という仕組みが使われています。多くの場合、翻訳は <a class="ulink" href="https://translationproject.org/html/welcome.html">Free Translation Project</a> や <a class="ulink" href="https://wiki.gnome.org/TranslationProject">Gnome 翻訳プロジェクト</a>、<a class="ulink" href="http://i18n.kde.org//">KDE one</a> などの開発元 (upstream)
のプロジェクトで取り扱われています。Debian で唯一の集約化された情報は <a class="ulink" href="https://www.debian.org/intl/l10n/">Debian
の翻訳に関する統計</a>で、実際のパッケージ内での翻訳ファイルの状況について確認できますが、翻訳作業を実際に容易にする仕組みではありません。
</p>
<p>
パッケージ説明文の翻訳作業はかなり昔に始まりました―実際にそれを使うツールがほんの少ししか機能を提供していなかったとしても (つまり、APT
だけが設定を正確に行ったときのみ利用できたのです)。メンテナはパッケージの説明文をサポートするのに何も特別なことをする必要はありません。翻訳者は
<a class="ulink" href="http://ddtp.debian.net/">Debian Description Translation Project
(DDTP)</a> を使う必要があります。
</p>
<p>
<code class="systemitem">debconf</code>
テンプレートについては、メンテナは翻訳者の作業を容易にするため <code class="systemitem">po-debconf</code> パッケージを使う必要があります。翻訳者は作業に DDTP
を使うことが出来ます (フランスチームとブラジルチームは使っていませんが)。<a class="ulink" href="http://ddtp.debian.net/">DDTP
のサイト</a> (実際に何が翻訳されているか) と <a class="ulink" href="https://www.debian.org/intl/l10n/">Debian
の翻訳に関する統計</a> サイト (パッケージに何が含まれているか) の双方で統計情報を得ることが出来ます。
</p>
<p>
ウェブページについては、それぞれの l10n チームが対応する VCS にアクセスし、Debian の翻訳に関する統計サイトから統計情報が取得できます。
</p>
<p>
Debian についての一般的なドキュメントは、作業は多少の差はあれウェブページと同じです (翻訳者は VCS
にアクセスします)。ですが、統計情報のページはありません。
</p>
<p>
パッケージ固有のドキュメント (man ページ、info ドキュメントその他) は、ほとんどすべてが手付かずです。
</p>
<p>
特記しておくこととして、KDE プロジェクトはドキュメントの翻訳をプログラムのメッセージと同じやり方で取り扱っています。
</p>
<p>
Debian 固有の man ページを <a class="ulink" href="https://cvs.debian.org/manpages/?cvsroot=debian-doc">特定の VCS リポジトリ</a>
で取り扱おうという動きもあります。
</p>
</div>
<div class="section">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a id="l10n-faqm"/>8.2. メンテナへの I18N & L10N FAQ</h2>
</div>
</div>
</div>
<p>
これはメンテナが i18n や l10n を考えるのにあたって直面するであろう問題の一覧です。読み進める間、Debian
でこれらの点について実際のコンセンサスは得られていないことを念頭においてください。これは単にアドバイスです。出てきた問題についてもっと良い考えがある、あるいはいくかの点で賛同できないという場合は、連絡をして頂いて構いません。そのことによって、この文章の質をさらに高めることができます。
</p>
<div class="section">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="l10n-faqm-tr"/>8.2.1. 翻訳された文章を得るには</h3>
</div>
</div>
</div>
<p>
パッケージの説明文や <code class="systemitem">debconf</code>
テンプレートを翻訳してもらうには、あなたは何もする必要はありません。DDTP
のインフラが作業者に翻訳してもらう素材を割り当てるのに、あなた側から働きかける必要はありません。
</p>
<p>
他の素材 (gettext ファイル、man ページ、その他のドキュメント)
については、最も良い解決策は文章をインターネットのどこかに置いて、debian-i18n
で他の言語へ翻訳を頼むことです。翻訳チームのメンバーの何名かはこのメーリングリストに登録しており、翻訳とレビュー作業を担当します。一旦作業が完了すれば、翻訳された文章があなたのメールボックスへと届くでしょう。
</p>
</div>
<div class="section">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="l10n-faqm-rev"/>8.2.2. どの様にして提供された翻訳をレビューするか</h3>
</div>
</div>
</div>
<p>
時折、あなたのパッケージ内の文章を訳して翻訳をパッケージに含めるように依頼する人が出てきます。これはあなたがその言語に詳しくない場合、問題となり得ます。その文章を対応する
l10n
メーリングリストに投稿し、レビューを依頼するのが良い考えです。一旦レビューが終われば、翻訳の質に自信を持つでしょうし、パッケージに含めるのにも安心を覚えるでしょう。
</p>
</div>
<div class="section">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="l10n-faqm-update"/>8.2.3. どの様にして翻訳してもらった文章を更新するか</h3>
</div>
</div>
</div>
<p>
古いままになっていた文章に対して翻訳文がある場合、元の文章を更新する度に、以前翻訳した人に新たに変更した点に合わせて翻訳を更新してもらうように依頼する必要があります。この作業には時間がかかることを覚えておいてください―更新をレビューしてもらったりするには少なくとも1週間はかかります。
</p>
<p>
翻訳者が応答してこない場合、対応する l10n
メーリングリストに助力を願い出ましょう。すべてうまくいかなかった場合は、翻訳した文中に翻訳がとにかく古い事の警告を入れておくの忘れないようにして、できれば読者がオリジナルの文章を参照するようにしましょう。
</p>
<p>
古くなっているからといって翻訳を全て削除するのは避けてください。非英語圏のユーザにとって何もドキュメントが無いよりは古いドキュメントがある方が有益であることが往々にしてあります。
</p>
</div>
<div class="section">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="l10n-faqm-bug"/>8.2.4. どの様にして翻訳関連のバグ報告を取り扱うか</h3>
</div>
</div>
</div>
<p>
最も良い解決策は開発元のバグという印を付けておいて (forward)、以前の翻訳者と関連するチーム (対応する debian-l10n-XXX
メーリングリスト) に転送することです。
</p>
</div>
</div>
<div class="section">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a id="l10n-faqtr"/>8.3. 翻訳者への I18N & L10N FAQ</h2>
</div>
</div>
</div>
<p>
これを読み進める間、Debian
においてこれらの点に関する一般的な手続きは存在していないこと、そしていかなる場合でもチームやパッケージメンテナと協調して作業する必要があることを念頭においてください。
</p>
<div class="section">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="l10n-faqtr-help"/>8.3.1. どの様にして翻訳作業を支援するか</h3>
</div>
</div>
</div>
<p>
翻訳したい文章を選び、誰もまだ作業をしていないことを確認し (debian-l10n-XXX メーリングリストを参照。日本語の場合は
debian-doc@debian.or.jp を参照してください)、翻訳し、l10n
メーリングリストで他のネイティブスピーカーにレビューをしてもらい、パッケージメンテナに提供します (次の段を参照)。
</p>
</div>
<div class="section">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="l10n-faqtr-inc"/>8.3.2. どの様にして提供した翻訳をパッケージに含めてもらうか</h3>
</div>
</div>
</div>
<p>
含めてもらう翻訳が正しいかどうかを提供する前に確認してください (l10n
メーリングリストでレビューを依頼しましょう)。皆の時間を節約し、バグレポートに複数バージョンの同じ文章があるというカオス状態を避けることになります。
</p>
<p>
最も良いやり方は、パッケージに対して翻訳を含めて通常のバグとして登録することです。忘れずに「patch」タグを使い、翻訳が欠けていたとしてもプログラムの動作に支障は無いので「wishlist」以上の重要度を使わないようにしましょう。
</p>
</div>
</div>
<div class="section">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a id="l10n-best"/>8.4. l10n に関する現状でのベストプラクティス</h2>
</div>
</div>
</div>
<div class="itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<p>
メンテナとしては、翻訳については関連の l10n メーリングリストに尋ねること無くどの様な方法であれいじらないこと
(レイアウトを変えることでさえしないこと)
です。もしいじってしまうと、例えばファイルのエンコーディングを破壊する危険があります。さらに、あなたが間違いだと思っていることがその言語では正解である
(または必要ですらある) ことがあり得ます。
</p>
</li>
<li class="listitem">
<p>
翻訳者としては、元の文章に間違いを見つけた場合は必ず報告することです。翻訳者はしばしばその文章の最も注意深い読者であり、翻訳者が見つけた間違いを報告しないのならば誰も報告しないでしょう。
</p>
</li>
<li class="listitem">
<p>
いずれの場合でも、l10n
に関する最も大きな問題は複数人の協調であり、誤解から小さな問題でフレームウォーを起こすのはとても簡単だということです。ですから、もし、あなたの話し相手と問題が起こっている場合は、関連する
l10n メーリングリストや debian-i18n メーリングリスト、さらにあるいは debian-devel メーリングリストに助けを求めてください
(ですが、ご注意を。l10n 関連の議論は debian-devel では頻繁にフレームウォーになります :)
</p>
</li>
<li class="listitem">
<p>
何にせよ、協調は<span class="strong"><strong>互いを尊敬しあうこと</strong></span>によってのみ成し得ます。
</p>
</li>
</ul>
</div>
</div>
</div>
<div class="navfooter">
<hr/>
<table width="100%" summary="Navigation footer">
<tr>
<td align="left"><a accesskey="p" href="ch07.html"><img src="images/prev.png" alt="戻る"/></a> </td>
<td align="center"> </td>
<td align="right"> <a accesskey="n" href="apa.html"><img src="images/next.png" alt="次へ"/></a></td>
</tr>
<tr>
<td align="left" valign="top">第7章 パッケージ化、そして… </td>
<td align="center">
<a accesskey="h" href="index.html">
<img src="images/home.png" alt="ホーム"/>
</a>
</td>
<td align="right" valign="top"> 付録A Debian メンテナツールの概要</td>
</tr>
</table>
</div>
</body>
</html>
|