プロダクトコピーは、まず単一ソース化して初めてローカライズ可能な状態になります。コンポーネントにリテラルとして散在したコピーは、翻訳の基準となる正本がないため、書き直すだけではローカライズ可能にできません。わかりやすさの改善、用語集、スタイルガイドはいずれも重要ですが、効果が出るのは文字列が1つのカタログに集約されてからです。このページでは、うまくいく順序に沿って手順を解説します。
このテーマに関する多くの解説は、2番目のステップから始まります。平易な言葉で書く、慣用句を避ける、翻訳者にコンテキストを提供する、といった助言はどれも正しいのですが、同じメッセージが微妙に異なる5つの形でコンポーネントに散らばっている状態では、どれも実行に移せません。プロダクトコピーの正本をなぜコードベースに置くべきか、その定義と背景はコードネイティブなプロダクトコピーで解説しています。このページでは、実践的な作業の順序を扱います。
ローカライズ可能とは、どういう状態ですか?
翻訳者や翻訳ツールにコピーを渡したとき、推測に頼らず忠実な訳文を作れる状態のことです。 そのためには3つの条件が必要です。すべての文字列が合意された唯一の場所に存在すること、各文字列が1つの明確な内容だけを伝えていること、そして翻訳者がその文字列の使用箇所と使われ方を把握できることです。
この3つは、後付けのしやすさがそれぞれ異なります。わかりやすい表現への改善は、文字列を1つずつ進められます。コンテキストはメモとして追加できます。しかし「合意された唯一の場所」は構造の問題です。これが欠けていると、他の2つは取り付く土台を失います。別のファイルに同じ文字列が存在する状態では改善のしようがなく、唯一のアドレスを持たないメッセージには注釈も付けられません。
なぜ原文が翻訳品質の上限を決めるのですか?
翻訳は二次的な成果物であり、二次的な成果物は元の欠陥をそのまま引き継ぐからです。 翻訳は、原文の曖昧さを各ターゲット言語へ持ち込み、不統一も同様に持ち込みます。原文のある画面では「Sign in」、別の画面では「Log in」、さらに別の画面では「Login」となっていれば、どの言語でも3つの用語がそれぞれ独立して翻訳され、どれが本来の用語なのかを判断できなくなります。
通常の対処法である訳文の推敲が見当違いなのも、これが理由です。言語を追加するたびに、直していない原文のコストは倍増します。原文を一度直せば、まだ追加していない言語も含め、すべての言語で修正されます。
この根本的な問題には名前があります。コピードリフトとは、単一の情報源(Single Source of Truth)がないために、ユーザーに表示されるテキストが、承認済みの原文から画面ごと・時間とともに乖離していく現象です。原因についてはコピードリフトとはで解説しています。ローカライズでは、このドリフトがすべての言語にコピーされるため、コストが跳ね上がります。
なぜ散在したコピーはローカライズ可能にできないのですか?
引き渡せるものが存在しないからです。 コンポーネント内のリテラルは、翻訳工程が拾い上げられる単位ではありません。マークアップやロジックと混在し、断片を組み合わせて作られていることもあり、同じ文が複数のファイルに、誰も意図していない小さな違いを伴って存在していることもあります。
そのリテラルをその場で書き直しても、状況は変わりません。1つ1つをわかりやすくしても、カタログも、プロダクトが何を言っているのかの合意されたリストもなく、すべて見つけられたかどうかを知る手立てもないままです。結果として、散在したままの場所に、整った文章が並ぶだけになります。
したがって最初のステップは編集作業ではなく、収集作業です。ユーザーに表示されるすべての文字列を、リポジトリ内の1つのカタログ(1つの原文言語)に集め、コンポーネントからはキーで参照します。このとき文言は変えません。この工程の目的は、互いに矛盾する部分も含めて、プロダクトが現時点で何を言っているのかを明らかにすることです。
文字列はどのように集めればよいですか?
まずカタログに移し、改善はそのあとにします。 この順序には2つの理由があります。移しながら文言も直す混在した作業では、何が変わったのかがレビュアーにも自分自身にも見えなくなります。そして、すべてが1つのファイルに集まれば、重複や類似表現が隣り合って並ぶため見落とされなくなり、整理は1つのファイルを読む作業になります。
具体的には次のとおりです。
- 原文言語ごとに、リポジトリ内にカタログを1つ用意します。 人にもツールにも読める、正本となるコピーです。構成やキーの命名方法はコードベース全体でUIコピーの一貫性を保つ方法で解説しています。これは同じカタログなので、レイアウトについてはそちらを参照し、このページでは繰り返しません。
- リテラルをキー参照に置き換えます。 ユーザーが読めるすべての文字列が対象です。ボタンのラベル、エラーメッセージ、空の状態の表示、ツールチップ、アクセシビリティ用テキストなど、見落としがちなものも含めます。
- 文は分割せず、完全な形で保ちます。 メッセージが断片の連結で作られている場合は、変数を含む1つのエントリにまとめ、翻訳者が目にする単位とユーザーが読む単位を一致させます。語順は言語ごとに異なるため、コード上で組み立てた文では対応できません。
- まだ文言は直さないでください。 誘惑に抵抗しましょう。不自然な文言は見つかるはずなので、メモだけ残して先へ進みます。
このリストが、大規模なコードベースで丁寧に進めれば1か月かかる作業に思えるなら、それがこのステップの正直なコストです。そして、多くのチームがここで足踏みする理由でもあります。
文字列が1つのカタログに集まったら、次に何をしますか?
ここでようやく、おなじみの助言が実行に移せるようになります。 カタログが1つになれば、次のどの作業も、探し回る作業ではなく1回の作業で済みます。
- 重複や類似表現を削除します。 各メッセージの承認済みの文言を決め、すべての使用箇所をそこに向けます。
- 揺らしてはいけない用語を確定します。 機能名、主要な操作を表す動詞、使わないと決めた言葉などです。一度書き出して固定します。これがあなたの用語集で、ごく短いもので十分です。
- 平易に書きます。 能動態を使い、慣用句や、特定の言語の言葉遊びに依存した冗談は避け、誤読されそうな略語は正式名称で書きます。各文字列は1つのことだけを伝えます。
- 翻訳者にコンテキストを提供します。 その文字列が表示される場所や、変数が何を表すのかをメモで添えます。「Post」や「Order」のような短い文字列は典型的な落とし穴です。名詞か動詞かによって、ターゲット言語では別の単語が必要になることがあります。
- 文字数の増加を見込みます。 翻訳後のテキストは原文より長くなることが多いため、ラベルが長くなっても崩れないレイアウトを設計します。これは、特定の数値を想定して対応するものではなく、デザイン上の制約として扱います。
カタログが作業の行われる唯一の場所なので、どのステップもすぐに終わります。カタログがなければ、同じ5つのステップがそれぞれコードベース中を探し回る作業になり、いつ終わるのかもわかりません。
翻訳ベンダーやツールを選ぶ前に、何を決めておくべきですか?
原文と、レビューの経路です。 ベンダーやツールは、渡されたものを翻訳します。整ったカタログと短い用語集を渡せば、よい仕事ができます。散在したリテラルを渡せば、不統一の翻訳に費用を払い、さらに各言語でそれを修正するために再び費用を払うことになります。
最初に3つのことを決めます。どのファイルを正本とするか。文言の変更を誰が承認するか。そして、変更された文字列や新しい文字列が翻訳へどう届くか(手作業か、スクリプトか、翻訳が添付された状態で届くプルリクエストか)です。最後の方法は、翻訳が原文に遅れる問題を防ぐものです。この問題は翻訳ファイルが同期ずれを起こす理由で解説しています。
コピーがすでにリポジトリ内にある場合、何が変わりますか?
ローカライズが別個のプロジェクトではなくなります。 カタログがリポジトリにあれば、新しい文字列や変更された文字列は差分の1行として現れ、その翻訳もコードと同じプルリクエストのフローで生成・レビューできます。スプレッドシートをエクスポートして、きちんと戻ってくることを祈る必要もありません。
だからこそ、コードベースではコピーの一貫性を保つことと、ローカライズ可能な状態を保つことは同じ作業になります。どちらも、合意された1つの原文に依存しているからです。作業を一度行えば、両方が手に入ります。AIコーディングツールを使って開発しているチームは、これをより早く実感します。カタログとlintルールという歯止めがなければ、エージェントが気づかないうちに文言を書き換えたり、リテラルを復活させたりするためです。このケースについてはAIコーディングエージェントによるUIコピーの書き換えを防ぐ方法で解説しています。
globalize.nowの位置づけ
globalize.now は、ローカライズを組み込んだコードネイティブなコピー管理システムであり、上記の単一ソース化のステップは、その作業を肩代わりする部分です。 アプリでGitHubまたはGitLabのリポジトリを接続すると、スキャンが内容を把握します。文字列がコンポーネント内のリテラルであれば、1回限りの変換でキーの背後にあるカタログへ移し、i18nの設定がなければそれも追加します。next-intl、react-i18next、i18next、Lingui などのライブラリをすでに使っている場合は、既存の構成に合わせて動作します。結果は専用ブランチのプルリクエストとして届くため、最初のカタログも、上で説明したレビューをそのまま経ることになります。その後に追加した新しい原文の文字列は、プッシュジョブによって翻訳され、結果がプルリクエストとして作成されます。リポジトリが唯一の情報源であり続けます。既存のi18n環境向けガイドでは、すでに設定がある場合にスキャンが何を検出するかを説明しています。
私たちは、同じ規律をマーケティングサイト、ランディングページ、プロダクトのすべてに、1つの原文から行き渡らせることを目指しています。これは今後の方向性であり、現時点でご利用いただけるものではありません。料金は料金ページをご覧ください。
手順のまとめ
- ユーザーに表示されるすべての文字列を、リポジトリ内の1つのカタログに集めます。文言は変えません。
- 文は分割せず完全な形で保ち、すべての文字列をキーで参照します。
- 重複を削除し、承認済みの文言を一度だけ決めます。
- 揺らしてはいけない用語の短い用語集を作成します。
- 平易な表現に整え、翻訳者向けのコンテキストメモを追加します。
- 文言を誰が承認するか、変更された文字列がどう翻訳へ届くかを決めます。
- 翻訳ベンダーやツールを選ぶ(あるいは切り替える)のは、そのあとです。
最初のステップが1か月がかりの作業に見えるなら、リポジトリを接続して、提案されるプランを確認し、作成されるプルリクエストをレビューしてみてください。
globalize.nowは、ハードコードされたアプリ内テキストを翻訳可能なロケールファイルに変換し、リリースのたびに自動で最新の状態を保ちます。
globalize.nowを無料で試す