用語集

用語集とは、翻訳が常に同じ方法で表示される用語の精選されたセットです。「Commit」のバージョントレース性の意味は、スペイン語でcommit, 簡体中国語で提交, 日本語でコミットになります。言語ごとに 1 つの決定、通じて適用されます。

### 用語集が存在する 2 つの場所

Glossia は、用語集エントリを検索し、翻訳時にそれらをマージする 2 つの場所をチェックします:

• - **あなたのリポジトリ**、既存の翻訳設定ファイル。L10N.md で用語を宣言し、各言語の L10N/<locale>.md で翻訳を宣言します。これは開発者によって優先される用語集：変更はプルリクエストを通じて適用され、各言語のレビューヤーが自分のファイルを持ち、ネストされたファイルはリポジトリの一部を精微に修正できます。
• - **あなたの Glossia アカウント**、ホスティングされたダッシュボードを通じて管理されます。これは言語学者による優先用語集です：レビューヤーとローカライゼーションコントリビューダーはコードに触れずに、ダッシュボード、REST API、または MCP サーバー を介してエントリを追加または精微化できます。これはアカウントが翻訳するすべてのリポジトリに適用されます。

両方の場所は有用であり、互いに置き換えられません。

### どちらを使うか

用語を定義する時:あなたの Glossia アカウント:

• - **1 つ以上のリポジトリに適用されます。** プロダクト名、ブランド用語、会社用語は一度定義され、それ 쓰 everywhere
• - **その決定を行う人がリポジトリに属していない。** 言語学者、レビューヤー、外部コントリビューダーはリポジトリがクローズドソースであっても、またはリポジトリに書き込みアクセスがない場合でも用語集を精微化できます。
• - **コード変更なしで用語を修正したい。** 修正された翻訳は次の実行時に適用され、コードベースに対するプルリクエストは不要です。
• - **変更のレビューと履歴が必要です。** 各編集は変更ノート付きの新しいバージョンを作成し、コントリビューダーは変更を誰かへの提案として提示でき、以前のバージョンも利用可能です。
• - **他のツールがそれを使用する必要がある。** エージェントと統合は、REST API と MCP サーバーを経由して用語集を読み取ることができ、例えば既に承認された用語を使用する新しいコンテンツを作成する場合などにそのようになります。

用語を あなたのリポジトリ に定義する時:

• - **このコードベースに属する。** 「commit」のような 1 つのプロジェクトに特定の意味を持つ用語は、それを使用するコードの隣にあります。
• - **ソーステキストと同じタイミングで変更されるべき。** 用語とそれを導入したコピーは同じプルリクエストに含まれ、一併レビューされます。
• - **リポジトリの一部だけがそれが必要。** ネストされた L10N.md または L10N/<locale>.md は、マーケティングページのような 1 つのディレクトリへのエントリを追加または上書きできます。
• - **アカウント用語集を上書きする必要がある。** 同じ用語の reposiory エントリはアカウントエントリに勝ち、翻訳する言語ではその言葉が優先されます。

### どのように組み合わせるか

各ファイルとターゲット言語に対して、Glossia は 2 つの用語集を 1 つの有効なセットに解決します:

1. 1. ターゲット言語のアカウント用語集エントリを使用します。
2. その言語のリポジトリエントリを重ねます：ファイルのL10N.md チェーンに由来する用語で、L10N/<locale>.md チェーンに翻訳があるもの。リポジトリエントリがアカウントエントリと同じソース用語を持つ場合、リポジトリエントリが優先されます。
3. 3. レポジトリ用語に言語の翻訳がない場合、その言語のアカウントエントリも適用されます。レポジトリは翻訳しなかった言語をブロックしません。

マージは 各ターゲット言語ごとの 発生します、エントリごとではありません。L10N/es.md における「commit」のスペイン語翻訳は、アカウントの「commit」スペイン語エントリを置換しますが、同じ用語のアカウントの日本語エントリには触れません。レビューヤーはどのアカウントエントリが置換されたかを確認できます：翻訳セッションのサマリーでいくら上書きされたかは表示され、各ファイルの ロックファイルでは glossary.shadowed の下にリストされます。

### 用語集が変更された時、ファイルは再翻訳されます

Glossaryエンタ리를 수정할 때, Glossia 는 유효한 glossary 가 변경된 파일만 재번역합니다. 파일의 소스 텍스트에 수정된 용어가 포함되지 않으면 번역은 그대로이며, 파일을 사용하는 경우 다음 번역 패스에는 업데이트된 지침이 포함됩니다。

逆の場合も同様です：ファイルのサブセットだけのみの用語を追加してもフル再実行は強制されません。

### 用語集は何ではないか

• Machine Translation 用語集ではありません。Glossia のモデルは surrounding context を読み取り、文がそれを要求する場合は用語を異なって表示できます。用語集は導線であり、置換ではありません。
• それはスタイルガイド全体ではありません。Voice、トーン、形式性、およびターゲットは、アカウントの Voice 設定とL10N.md にあります。用語集は個別用語とその承認された翻訳のみに限定されます。
• 静粛ではありません。適用された すべての用語はファイルのロックファイルに記録されますので、レビューヤーはどの用語集エントリがモデルに到達したかを正確に追跡できます。

### Related

• 最初の用語を追加：用語集を定義 。
• 各エントリフィールド：用語集リファレンス 。
• その他のL10N.md フィールド：L10N.md 参考。