プレースホルダー

プレースホルダーの崩れを検出する方法

プレースホルダーは、名前、件数、価格、日付などを実行時に差し込むための重要なトークンです。訳文の中で少し変わるだけで、画面表示に影響します。

例

原文JSON

{
  "cart.items": "{count} items in your cart",
  "hello": "Hello {name}"
}

訳文JSON

{
  "cart.items": "カートに{total}件の商品があります",
  "hello": "こんにちは｛name｝"
}

検出したいこと

{count} が消えて {total} に変わっている
{name} の括弧が全角になっている

プレースホルダーが欠けたり名前が変わったりすると、画面上で値が差し込まれない、エラーになる、意図しない文字列が表示されるといった問題につながります。

日本語では、入力中に括弧や記号が全角になることもあります。見た目は似ていても、アプリ側のトークンとしては別物です。

開発側はプレースホルダーの仕様を決めますが、翻訳・レビュー・納品の過程で崩れることがあります。PMやベンダー側で納品前に確認しておくと、開発側での差し戻しを減らせます。

LocaleQAは同じJSONキーの原文と訳文を比較し、プレースホルダーの種類と個数を一定のルールで確認します。文法の自然さは判定しません。

プレースホルダーは翻訳対象の文中に混ざっているため、翻訳メモリの置換、手作業での修正、日本語入力中の全角化などで変わることがあります。括弧やパーセント記号は見た目が似ていても、実行時には別の文字として扱われます。

検出結果をレポートとして残しておくと、どのキーのどのトークンを直すべきかを開発・翻訳・QA間で確認しやすくなります。