Firefox OSをローカライズする

このガイドでは、Firefox OS、特にGaiaインターフェイスやアプリのローカライズがいかに簡単かを示します。コンピュータのセットアップに始まり、Gaiaの文字列をローカライズする方法や、最後にはl10nをテストする方法まで付き添います。

記: これはFirefox OSのローカライズを希望するローカライザー向けのガイドです。ローカライズ可能なアプリを書きたい開発者は Firefox OS アプリをローカライズするから始めて、その次に L10n ベストプラクティスを確認します。

初期セットアップ

Gaiaのソースファイルを入手し、お使いのデスクトップマシンにてローカライゼーションのテストを行うにはまず、これらの基本プログラムおよび言語がインストールされていることを確認してください。

GNU make: ソースコードからビルドを生成するのに役立つ細かなツールです。デスクトップ L10n のテスト準備ができれば、大変重宝するでしょう。ダウンロードとインストール作業は容易で、GNUのウエブサイトから直接行えます。OS Xユーザであれば XCode および XCode コマンドラインツールをアップルストアからインストールする必要があります。
git: git は Gaiaソースコードを保存するために使用されるバージョンコントロールシステムです。git のダウンロードおよびインストールは容易でウエブサイトから直接行うことができます。
Python: Python はプログラミング言語でありL10nテスト用のFirefox OSビルド生成に貢献します。ダウンロードおよびインストールは容易でPythonウェブサイトから直接行うことができます。
Mercurial (hg): Mercurial (hg) はもうひとつのバージョン管理システムです。 l10nの利用に際し、ロケールリポジトリをはじめとするGaiaの安定したバージョンを管理します。ダウンロードおよびインストールは容易でこのウエブサイトから直接行うことができます。
compare-locales: compare-locales は Pythonのスクリプトのひとつで、ローカル化にあたっての作業評価や、diffと呼ばれる、すでにローカル化済のマテリアルからローカル化のための新しい内容を切り離すのに使用します。ダウンロードおよびインストールは容易でcompare-locales ウィキページから直接行うことができます。なお、これはGaiaのローカライズにあたってコマンドラインもしくはテキストエディタを使用する場合のみ必要となります。Pootle, Transifex やPontoonなどのツールを使用する場合、インストール不要です。

ローカルリポジトリをセットアップする

上記ソフトウエアのダウンロードとインストール作業が完了したら、いよいよマシンにソースとローカライズされた文字列を入手します。

コマンドラインユーティリティにおいて, Gaiaのソースと翻訳文字列の保存先を指定します。
hgで以下のコマンドを使ってen-US リポジトリのコピーを作ります。
```
hg clone https://hg.mozilla.org/gaia-l10n/en-US
```
以下のコマンドを使ってロケールリポジトリのコピーを作ります。例として、2行目は伝統的な中国語のリポジトリを適切なディレクトリにコピーしています。
```
hg clone https://hg.mozilla.org/gaia-l10n/your-locale-code
hg clone https://hg.mozilla.org/gaia-l10n/zh-TW/ B2G/gaia/locales/zh-TW
```

最後にこのコマンドを入力します。

LOCALE_BASEDIR=locales/ LOCALES_FILE=locales/languages_mine.json make

ロケールファイルは languages_mine.json に記載するべきで、それはこういう構造になります:

{
  "en-US" : "English (US)",
  "fr" : "Français (fr)"
}

このファイルでは、ずてに翻訳準備ができている文字列を一覧にすべきです!　Firefox OSの新規ローカライゼーションを開始している場合、全部の文字列が翻訳すべき文字列であるようなdiffを作る必要はない事を気に留めて下さい。

記: ロケールビルドの自動化スクリプトは、このgist を参照して下さい。

Gaiaの文字列を翻訳する

Gaiaの文字列を翻訳するワークフローは、翻訳に使用しているツールに大きく依存しています。この処理パートは他の Mozilla 製品の通常の翻訳フェーズと同様です。ローカライゼーションの翻訳フェーズのクイックスタートガイド(英語) には、Mozilla製品内の文字列を翻訳するのに使うツール一覧のほか、これらのツールでどうやって翻訳するかのチュートリアルがあります。l10nチームの一員でGaia文字列を翻訳するツールを決める時も、あるいはあなたのチームが使っているツールのチュートリアルを探している時も、このページは役立ちます。

Firefox OS向けの l10n をテストする

Firefox OSのl10nをテストするために、主要な方法が2つあります: デスクトップビルドとモバイルビルドです。現在、デスクトップの方法がl10n のテストに最も広く使われている方法です。

デスクトップ版 l10n をテストする

最新のboot2gecko nightly デスクトップビルドをダウンロード、インストールします— 使用するOSに相当するパッケージをダウンロードします。localizer という言葉が含まれるパッケージを探します。これは languages-all.json に載っている全てのロケールが有効であることを示します。
最新バージョンのGaiaをクローンするのに、デスクトップ上のダウンロードしたいディレクトリに移動して、コマンドラインユーティリティ上でこのコマンドを入力します: git clone git://github.com/mozilla-b2g/gaia.git
チームにとってFirefox OSのローカライズが初めての場合、あなたのロケールを有効にする必要があります。そうでない場合、他の誰かがロケールを有効にするまで飲み物を取ります。
1. コマンドラインで、あなたのgaiaクローン内を移動し、下記コマンドを実行してあなたのロケールリポジトリをクローンします: hg clone ssh://hg.mozilla.org/gaia-l10n/your-locale-code
2. クローンしたばかりのgaiaリポジトリ内のshared/resources ディレクトリにあるlanguages.jsonファイルを開きます。
3. このフォーマットでロケール情報を追加します: "en-US" : "English (US)"、そしてファイルを保存します。
4. 最後に、次ののコマンドを実行します: make multilocale これでデスクトップビルドであなたのロケールが有効になります。
Gaiaプロファイルを作成するのに、このコマンドを実行します: DEBUG=1 make -C gaia profile
ついに、あなたのロケールプロファイルでFirefox OSを実行してテストを開始でできます。それにはこのコマンドを入力します: b2g/b2g -profile gaia/profile OS Xを使っている場合は、このコマンドを実行します: /Applications/B2G.app/Contents/MacOS/b2g -profile gaia/profile
デスクトップビルドを更新するため、単にあなたのGaiaリポジトリクローンを移動してこのコマンドを入力します: git pull

モバイル版l10n をテストする

もっと多くのFirefox OSサポート端末がローカライザーの手に届くにつれ、この節は成長します。

l10n をテストする時に何を探すのか

モバイルOS向けのローカライゼーションをテストするのは、デスクトップアプリのローカライゼーションをテストするのと同様な点があります。あなたの作業のローカライゼーションテストを実施する時に探すべきガイドラインがここにあります:

UIテキスト要素内から翻訳がはみ出していないかを見ます。
文調、スタイル、専門用語がプロタクト全体で一貫しているかを確認します。
翻訳されない英語文字列がUIの中にないか探します。これらはGaia内でハードコードされたり、要素IDのエラーにより起きている可能性があります。
時間と日付表示が地域の標準に一致しているかを確認します。

ローカライゼーション特有のバグを探す

電話機を使用している時に起こったバグ例を与えるようなbugzillaリンクがこちらです。このような種類のバグ登録にあたり、ある例と同様なバグをどこで探すかのアイデアをもたらすでしょう。

https://bit.ly/100bcsC - これはB2G 翻訳バグの一般的なリストです
https://bugzilla.mozilla.org/show_bug.cgi?id=846060
https://bugzilla.mozilla.org/show_bug.cgi?id=852739

ローカライゼーションバグを見つける一般ルールは:

バグが言語固有である場合、(他の製品の下の) Mozilla Localizationの下に登録し、翻訳者に cc します。忘れずにバグに適切なトラッキングフラグを立てます。
言語固有でない場合、FirefoxOS 製品の下に登録し、ローカライザーに cc します。忘れずにバグに適切なトラッキングフラグを立てます。
疑わしい場合、FirefoxOS 製品の下に登録し、ローカライザーに cc します。忘れずにバグに適切なトラッキングフラグを立てます。

Moztrap を使う人用に、FirefoxOS "localization" タグの下の既存のテストケースを見たり、端末上でテストがパスするかを見てみることも、Firefox OSのローカライゼーションをテストする良い方法です。

次には

今やローカライゼーションを始める準備完了です! なので好みの l10n ツールを開いて進みましょう! 通常どおり、この文書に載っていない疑問は、mozilla.dev.l10n newsgroup へ送って下さい。