用語集

概要

これらのドキュメント全体を通して、General Translation ライブラリで使用されるさまざまな概念を説明するために、さまざまな用語を使用しています。

このページでは、私たちが使用する主要な用語のいくつかを紹介します。

主要な用語

ロケール

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

より詳細な説明については、ロケール文字列ページを参照してください。

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

これらのドキュメント全体を通して、「ロケール」と「言語コード」という用語を互換的に使用することがよくあります。

言語

コードで使用する文脈で言語について言及する場合、実際にはロケールを意味します。（または言語コード）

例えば、「setLocaleの呼び出しで言語を提供する」と言う場合、実際には「setLocaleの呼び出しでロケールを提供する」ことを意味します。

「フランス語はサポートされている言語です」と言う場合、実際には「frはサポートされているロケールです」ことを意味します。

辞書

辞書は、（潜在的にネストされた）キーと値のペアのセットを含むJSONファイルです。

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

{
  "greeting": "Hello, world!",
  "farewell": "Goodbye, World!",
  "dashboard": {
    "title": "Dashboard",
    "description": "Welcome to the dashboard"
  }
}

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

これらの辞書は、他のi18nライブラリの翻訳ファイルと同様に、構造と使用法において慣例的です。

ソース辞書

ソース辞書は、アプリのデフォルトロケールでコンテンツを含む辞書です。

翻訳辞書

翻訳辞書は、デフォルトロケールとは異なる特定のロケールでコンテンツを含む辞書です。

キーはソース辞書と同じで、値は翻訳された文字列です。

独自の翻訳辞書がある場合は、loadDictionary()関数を使用してそれらを読み込むことができます。

インラインコンテンツ

インラインコンテンツは、アプリのコードに直接記述され、JSONや辞書ファイルのような別の場所に保存されないコンテンツです。

これには以下が含まれます：

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

ソースコンテンツ

ソースコンテンツは、アプリのデフォルトロケールでのコンテンツです。アプリのデフォルト言語で書かれたすべてのものが含まれます。

特にgt-nextとgt-reactでは、ソースコンテンツには、アプリのソース辞書と任意のインラインコンテンツを含む、アプリの翻訳可能なすべてのコンテンツが含まれます。

ソーステンプレート

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

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

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

ソースコンテンツのタイプに応じて、対応する値は文字列、配列、またはオブジェクトになります。（辞書の場合は文字列と配列、<T>コンポーネントの場合はオブジェクト）

翻訳

これらのドキュメント全体を通して、名詞「翻訳」を使用して、ソースコンテンツを翻訳することで得られた翻訳されたコンテンツを指します。

翻訳は、ソーステンプレートから直接生成されます。

loadTranslations()関数を使用すると、これらの翻訳が保存される場所をカスタマイズできます。この関数は、ソーステンプレートと同じ形式のJSONを期待します。

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

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

JSON、MDX、またはMDファイルに関連して翻訳を使用する場合、元のソースファイルの直接的な翻訳を指しています。