国際化

どのようなものか

国際化は、言語や地域ごとにコードを変更せず、一つの製品を多くの言語や
地域で使えるようにする技術上の取り組みです。W3Cは、対象者の文化、地
域、言語を問わず、後で容易にローカライズできるよう、製品、アプリケー
ション、文書を設計し、構築することと定義しています。英語では
internationalizationのほか、internationalisationともつづります。最初
のiと最後のnの間に18文字あるため、i18nと略します。同じ考え方をグロー
バル化（globalization）と呼ぶ人もいます。

W3Cは、役割の分担を一文で示しています。製品を設計し、構築する人は、
「翻訳者やローカライズの担当者が容易にローカライズできるように」、製
品を国際化します。国際化は、コードとテンプレートの中で一度行います。
ローカライズは、コードが読み込むデータを通して、市場ごとに行います。
完全に国際化した製品でも、一つの言語だけで出荷することはできます。

両方の作業の単位となるのが、ロケールです。CLDRの仕様では、世界の広い
範囲で、利用者が共通して好む傾向のある設定を表す識別子と定義していま
す。言語を基本に、多くの場合は地域でさらに区別します。たとえば
`en-GB`と`en-US`は言語を共有しますが、日付の書き方が異なります。この
識別子は、翻訳と一連の表記慣習を同時に選びます。

W3Cは、国際化の作業を四種類に分けています。第一は、障壁の除去です。
製品はテキストをUnicodeとして扱い、古い文字エンコーディングが必要な
箇所では、意識して対応します。断片をつなぎ合わせて文を作らず、利用者
に見せる文言にコードを依存させません。第二は、後で追加する言語で初め
て必要になる機能への対応です。右から左へ書く文字と左から右へ書く文字
が混在するテキストのマークアップ、文章の言語を宣言する方法、縦書きの
スタイル規則などが含まれます。第三は、地域の慣習をコードから使えるよ
うにすることです。通常は、チームが独自の表を作るより、既存のライブラ
リーを使います。日付と時刻の形式、暦、数値の書式と数字の体系、一覧の
並べ替え順、人名の書き方や呼びかけ方が対象です。第四は、翻訳できるも
のをすべてソースコードの外に置き、閲覧者ごとに適切な版を読み込めるよ
うにすることです。

なぜ重要なのか

W3Cが重視するのは、着手の時期です。一つの言語、一つの文化を前提に
作った製品を世界市場向けに作り直すには、最初から世界に向けて設計する
より、はるかに多くの労力と時間がかかります。W3Cは、その作業を、年は
すべて19で始まると仮定した二桁の年フィールドを改修する、Y2K対応にな
ぞらえています。国際化を後回しにすると、難しく高価な再設計になりがち
です。早く始めれば、取り入れた時点ではほとんど費用のかからない、いく
つかの習慣で済みます。

こうした習慣を欠いた場合の負担は、言語を増やすたびに大きくなります。
コード内で三つの断片から組み立てる文は、英語の製品なら一つの不具合で
すが、五つのロケールを持つ製品では五つの不具合になります。どの場合
も、よりよい翻訳では直せず、ほかの変更と同様にレビューしてリリースす
る、コードの修正が必要です。手作業で書式を整えた日付、バイトを比較し
て並べ替える一覧、英語の表示文言でテストが見つけるラベルも同じです。

一度も翻訳しなくても、こうした習慣は役に立つと、W3Cは明言していま
す。英語だけで販売する製品にも、英語では使わない文字を含む名前、他国
の慣習で配置した住所、月より先に日を書くシステムの日付が届きます。
Unicodeとして保存するテキストと、表示の瞬間まで日付を日付の値のまま
保つデータなら、どれも特別扱いせずに処理できます。

実際の活用例

製品が国際化されているかを最も手早く試せるのは、数を含む文です。国際
化されていない実装は、コード内で文を組み立てます。

```js
const label = count + (count === 1 ? " day" : " days");
```

これは英語としては正しくても、翻訳には対応できません。ウクライナ語で
は、整数に三つの形が必要で、小数には第四の形が要ります。1、21、101の
後はдень、2、3、4、22の後はдні、0、5から20、25の後はднів、小数の後は
дняです。翻訳者が二つ目の分岐にどの一語を入れても、大半の数では誤り
になります。21には1と同じ形を使い、2には5と違う形を使うためです。

国際化すると、文をキーに置き換え、各言語の表に、その言語で必要なすべ
ての形を用意します。Hugoでは、翻訳表を`i18n`ディレクトリーに置きま
す。言語ごとに一つのファイルを用意し、言語タグをファイル名にします。

```toml
i# i18n/en.toml		engineer.company	70
[days]
one = '{{ . }} day'
other = '{{ . }} days'
```

```toml
i# i18n/uk.toml		engineer.company	70
[days]
one = '{{ . }} день'
few = '{{ . }} дні'
many = '{{ . }} днів'
other = '{{ . }} дня'
```

テンプレートはキーを指定し、数を渡します。どちらの言語の単語も、複数
形の規則も含みません。

```text
{{ T "days" 21 }}
```

英語のページでは`21 days`、ウクライナ語のページでは`21 день`と表示さ
れます。2なら`2 days`と`2
дні`、5なら`5 days`と`5
днів`です。`one`、`few`、`many`、`other`という名前は、Hugo独自のもの
ではありません。Unicode
Consortiumが集めたロケールデータであるCLDRが定義する、複数形のカテゴ
リーです。Hugoの文書も、各言語のカテゴリーについて、CLDRの複数形規則
の一覧を参照しています。新しい言語はファイルを一つ追加すれば導入で
き、テンプレートの変更は不要です。

規模が大きくなると、翻訳表は製品で最も大量のテキストを持つ部分にな
り、コードと同じ規律が必要です。このサイトが紹介するプロジェクトの一
つ、英語とデンマーク語の国際化システムは、458の名前空間ファイルに、
ロケールごとに12,027件のメッセージを持ちます。各ファイルは400行を上
限とし、リンターが二つのロケールのキーを比較して、一方にあるメッセー
ジが他方に欠けることを防ぎます。デンマーク語には、くだけた呼びかけの
「du」に至るまで固定した語彙があり、ツールがコミットごとに守らせま
す。リンク先は、この上限によって保守性を保てたと説明しています。ファ
イルごとの上限がなければ、458ファイル分を十二ファイルにまとめていた
と述べています。

問題が起きるところ

文を断片からつなぎ合わせます。 `"Delete " + n + "
files?"`として作るメッセージは、翻訳者には文全体の文脈を持たない二つ
の断片として届きます。その順序が必要なのは、英語だけです。ほかの言語
では、数を末尾に置いたり、名詞によって動詞の形を変えたりする必要があ
るかもしれません。W3Cは、文字列の連結への配慮も、国際化の一部に挙げ
ています。各文を一つのメッセージにし、翻訳者が移動できる名前付きプ
レースホルダーを使います。Hugoの文書では、`{{
T "age" (dict "name" "Will" "count" 1)
}}`で、一つの翻訳文に名前と数の両方を埋め込む例を示しています。

コードが画面の文言を読み取ります。
「Save」というラベルでボタンを探すテストや、状態を「Paid」という文字
列と比較する分岐は、最初の翻訳までは動き、その後はエラーも出さずに機
能しなくなります。W3Cは、ユーザーインターフェースの文字列にコードを
依存させないことを、国際化の最初の項目の一つに挙げています。キー、識
別子、列挙値を比較し、テストが要素を見つけるための、安定した属性を用
意します。

すべての言語に一つの複数形規則を使います。 `count ===
1`は、英語の規則をコードにしたもので、製品に追加し得る言語の大半には
合いません。CLDRの仕様は、zero、one、two、few、many、otherの六つのカ
テゴリーを定義し、必須なのはotherだけとしています。どれを選ぶかは言
語ごとに規則があり、英語は二つ、ウクライナ語は四つを使います。数を
メッセージに渡し、その言語で使うすべてのカテゴリーを翻訳表に持たせま
す。

翻訳の欠落に気付かないまま公開します。
Hugoの`T`は、現在の言語にキーがなければ既定の言語を使い、そちらにも
なければ空文字列を返します。そのため、翻訳が抜けた箇所や、デンマーク
語の途中に英語が交じった箇所があるまま、ページが公開されかねません。
`--printI18nWarnings`を付けてビルドし、欠落した翻訳と代替言語を使っ
た翻訳をすべて列挙します。プレビュー環境で
`enableMissingTranslationPlaceholders`を有効にして、欠落をページ上に
表示し、継続的インテグレーションですべてのロケールのキーを比較しま
す。

日付と数値の書式を手で整えます。
`MM/DD/YYYY`を書くテンプレートや、三桁ごとにコンマを入れる数値は、一
つの国の慣習を固定しています。同じ日は、米国英語では`10/27/26`、英国
英語では`27/10/2026`、デンマーク語では`27.10.2026`、スウェーデン語で
は`2026-10-27`です。12,027.5は、デンマーク語では`12.027,5`と書き、ノ
ルウェー語、スウェーデン語、ウクライナ語では、桁区切りに空白、小数点
の位置にコンマを使います。CLDRの仕様は、データを言語に依存しない形で
保存、交換し、閲覧者に合わせて表示形式を整えることを勧めています。日
付と金額は、最後の段階まで素の値として保ち、そこでプラットフォームの
ロケール対応関数を使います。Hugoの`time.Format
":date_full"`は、同じ日付を、英語のページでは`Wednesday, November 3,

2021`、ドイツ語のページでは`Mittwoch, 3. November 2021`と表示しま
す。

テキストをUnicodeで保存しません。
「blåbærsyltetøj」をUTF-8で書き、Windows-1252として読み直す製品で
は、「blÃ¥bÃ¦rsyltetÃ¸j」と表示されます。古い単一言語用のエンコー
ディングで保存する製品では、ウクライナ語の名前をそもそも格納できませ
ん。Unicodeへの対応は、W3Cの一覧の最初の項目です。データベースからブ
ラウザーまで、一つのUnicodeエンコーディング、通常はUTF-8を使い、バイ
トをテキストに変えるすべての境界で、それを明示します。

参考資料

  * ローカライズと国際化 — W3Cによる両用語の実務上の定義、国際化に含
む四種類の作業、最初に取り組むべき理由です。

  * Hugo：多言語モード — 翻訳表、地域に応じた日付と通貨、翻訳の欠落
をHugoが報告する方法です。

  * Hugo：lang.Translate —
言語をまたぐ検索順序、翻訳表の複数形カテゴリー、名前付きプレースホル
ダーを持つメッセージです。

  * UTS #35、第1部：基本事項 —
CLDRの仕様です。ロケール識別子、ロケール間の継承、表示するまでデータ
を言語に依存させないという助言を扱います。

  * UTS #35、第3部：数値 — ロケールごとの数値記号と書式、複数形カテ
ゴリーと、その選択規則です。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/internationalization/	engineer.company	70
