概要

本ドキュメントでは、General Translation のライブラリで用いる各種の概念を説明するために、さまざまな用語を使用します。

このページでは、使用する主要な用語の要点を紹介します。

主要な用語

ロケール

ロケールは、特定の言語を識別するためのコードです。

詳しくは、ロケールコード文字列のページをご覧ください。

たとえば、en-US は英語（アメリカ合衆国）のロケールです。

本ドキュメントでは、「ロケール」と「言語コード」という用語をしばしば同義で使用します。

言語

コードでの利用という文脈で「言語」と言う場合、実際には locale（または言語コード）を指します。

たとえば「setLocale の呼び出しで言語を指定してください」と言うとき、実際には「setLocale の呼び出しで locale を指定してください」という意味です。

「French はサポートされている言語です」と言うなら、実際には「fr はサポートされている locale です」という意味です。

dictionary

dictionary は、（入れ子の場合もある）キーと値のペアの集合を含む JSON ファイルです。

キーは参照として使用され、値は元の言語または翻訳済みの言語の文字列です。

{
  "greeting": "こんにちは、世界！",
  "farewell": "さようなら、世界！",
  "dashboard": {
    "title": "ダッシュボード",
    "description": "ダッシュボードへようこそ"
  }
}

キーは人間が読める参照で、アプリ内の翻訳コンテンツを照会するために使用されます。

これらのdictionariesは、他のi18nライブラリの翻訳ファイルと同様に、構造や使い方が一般的な慣習に沿っています。

ソース dictionary

ソース dictionary は、アプリの既定の locale のコンテンツを収録した dictionary です。

翻訳済み dictionary

翻訳済み dictionary とは、デフォルトの locale とは異なる特定の locale のコンテンツを含む dictionary のことです。

キーは元の dictionary と同一で、値には翻訳済みの文字列が入ります。

独自の翻訳済み dictionaries がある場合は、loadDictionary 関数で読み込めます。

インラインコンテンツ

インラインコンテンツとは、アプリのコード内に直接記述され、JSON や dictionary ファイルなどに別途保存されないコンテンツを指します。

含まれるもの:

• <T> コンポーネント
• useGT フック
• getGT 関数

ソースコンテンツ

ソースコンテンツは、アプリのデフォルトのlocaleにあるコンテンツを指します。アプリのデフォルト言語で書かれたすべてが含まれます。

特に gt-next および gt-react では、ソースコンテンツはアプリ内の翻訳対象コンテンツ全体を指し、アプリのソースdictionaryやインラインコンテンツも含まれます。

ソーステンプレート

ソーステンプレートとは、ソースコンテンツを保存するための特定のデータ形式を指します。

{
  ["ソースコンテンツの一意識別子"]: "...コンテンツ..."
}

ソースコンテンツの一意識別子は、ソースコンテンツのハッシュか、ユーザー定義の一意識別子のいずれかです。

ソースコンテンツの種類に応じて、対応する値は文字列・配列・オブジェクトのいずれかになります（dictionaries では文字列または配列、<T> コンポーネントではオブジェクト）。

翻訳データ

本ドキュメントでは、名詞の「翻訳データ」は、ソースコンテンツを翻訳して得られる訳文そのものを指します。

翻訳データは、あなたのソーステンプレートから直接生成されます。

loadTranslations 関数を使うと、これらの翻訳データの保存場所をカスタマイズできます。この関数は、JSON がソーステンプレートと同一の形式であることを前提とします。

ソースコンテンツからこれらのデータファイルを生成するには、CLI generate コマンドを使用してください。

翻訳データは GT CDN に保存されるものです。

JSON、MDX、または MD ファイルに関して「翻訳データ」という語を用いる場合は、元のソースファイルの直接的な翻訳を指します。