よくある問題

ローカライズでよくあるJSONの問題

ローカライズ用JSONでは、翻訳内容そのものとは別に、ファイル構造や記号の扱いで問題が起きることがあります。

対応形式：JSON、YAML、XLIFF、Android XML、Apple .strings/.xcstrings、Java .properties

例

複数の問題

{
  "cta": "Buy {count}",
  "help": "<link>Help</link>"
}

{
  "cta": "購入 {num}",
  "old": "Old"
}

特に多いのは、原文にあるキーが訳文で欠ける、訳文側に古いキーが残る、プレースホルダー名が変わる、タグが閉じられない、といった問題です。日本語案件では、全角・半角やカタカナ表記のゆれもレビューコメントにつながりやすいポイントです。

こうした問題は、人が目視で毎回探すよりも、リリース前に同じ条件で確認する方が安定します。翻訳者やレビュー担当の目は訳文に向きやすいため、構造チェックは別の工程として切り出す方が安全です。

LocaleQAは対応するローカライズファイルを対象に、同じ入力から同じ結果を返すチェックを行います。翻訳ツールやCATツールを置き換えるものではなく、納品前・組み込み前のQA補助として使えます。

小規模な案件では、前回納品した日本語JSONを複製し、今回追加された箇所だけをメールや表計算の指示に沿って更新することがあります。この方法では、新しいキーの追加漏れ、削除済みキーの残存、似たキー名への手入力ミスが同時に起きても、JSON自体は正常に開けます。

確認するときは、今回変更したと思っている箇所だけでなく、開発側の確定した原文ファイルと納品対象の日本語ファイル全体を比較します。missingとextraが対になっている場合は、単純な漏れではなくキー名を変更してしまった可能性も確認します。