用語集
General Translation ライブラリで使用される主要な用語ガイド
概要
これらのドキュメント全体を通して、General Translation ライブラリで使用されるさまざまな概念を説明するために、様々な用語を使用しています。
このページでは、私たちが使用する主要な用語のいくつかを紹介します。
主要な用語
ロケール
ロケールは特定の言語を識別するために使用されるコードです。
詳細な説明については、ロケール文字列のページをご覧ください。
例えば、en-USは英語（アメリカ合衆国）のロケールです。
このドキュメント全体を通して、「ロケール」と「言語コード」という用語を互換的に使用することがよくあります。
言語
コードで使用する文脈で言語について言及する場合、実際にはロケールを意味します。（または言語コード）
例えば、「setLocaleの呼び出しで言語を提供する」と言う場合、実際には「setLocaleの呼び出しでロケールを提供する」という意味です。
「フランス語はサポートされている言語です」と言う場合、実際には「frはサポートされているロケールです」という意味です。
辞書
辞書は、（潜在的にネストされた）キーと値のペアのセットを含むJSONファイルです。
キーは参照として使用され、値は元の言語または翻訳された言語の文字列です。
キーは人間が読める参照であり、アプリ内で翻訳されたコンテンツを検索するために使用されます。
これらの辞書は構造と使用法において従来のものであり、他のi18nライブラリの翻訳ファイルと類似しています。
ソース辞書は.jsまたは.tsファイルにすることもでき、つまり他のファイルからインポートすることができます。
翻訳されたコンテンツを含む辞書は.jsonファイルのみです。
ソース辞書
ソース辞書は、アプリのデフォルトロケールでコンテンツを含む辞書です。
翻訳された辞書
翻訳された辞書は、デフォルトロケールとは異なる特定のロケールでコンテンツを含む辞書です。
キーはソース辞書と同じであり、値は翻訳された文字列です。
独自の翻訳された辞書がある場合は、loadDictionary()関数を使用してそれらを読み込むことができます。
インラインコンテンツ
インラインコンテンツは、アプリのコードに直接書かれたコンテンツであり、JSONや辞書ファイルのように別々に保存されていないものです。
これには以下が含まれます：
<T>コンポーネントuseGTフックgetGT関数
ソースコンテンツ
ソースコンテンツは、アプリのデフォルトロケールのコンテンツです。アプリのデフォルト言語で書かれたものすべてが含まれます。
特にgt-nextとgt-reactの場合、ソースコンテンツにはアプリのソース辞書や任意のインラインコンテンツなど、アプリの翻訳可能なコンテンツすべてが含まれます。
ソーステンプレート
ソーステンプレートは、ソースコンテンツを保存するための特定のデータ形式を指します。
ソースコンテンツの一意の識別子は、ソースコンテンツのハッシュ、またはユーザー定義の一意の識別子のいずれかです。
ソースコンテンツのタイプに応じて、対応する値は文字列、配列、またはオブジェクトになります。（辞書の場合は文字列と配列、<T>コンポーネントの場合はオブジェクト）
翻訳
このドキュメント全体を通して、名詞「翻訳」はソースコンテンツを翻訳して得られた翻訳されたコンテンツを指します。
翻訳はソーステンプレートから直接生成されます。
loadTranslations()関数を使用すると、これらの翻訳が保存される場所をカスタマイズできます。この関数は、ソーステンプレートと同じ形式のJSONを期待しています。
ソースコンテンツからこれらのデータファイルを生成するには、CLI generateコマンドを使用してください。
注意：
翻訳は翻訳された辞書とは_異なる_ことに注意することが重要です。辞書は潜在的にネストされており、キーとして人間が読める参照を含んでいます。
一方、翻訳はフラットであり、キーとして人間が読めないハッシュを含んでいる可能性が高いです。
翻訳はGT CDNに保存されるものです。
JSON、MDX、またはMDファイルに関して翻訳を使用する場合、元のソースファイルの直接の翻訳を指しています。