キーは、ソフトウェア コード内で翻訳可能テキストStringsを識別するために使用します。これにより、（翻訳可能可能な文字文字列のコード名としてのキーの使用は、文字列の必要な翻訳ごとに参照するのではなく、phraseによって一度しか参照されません。
キーには複数の翻訳を関連付けることができ、それぞれプロジェクトの異なる言語ロケールに対応します。機能はリレーショナルデータベースのキーに似ていますが、翻訳はキーの属性です。キーは再原文ファイルに保存され、原文言語と訳文言語の識別に使用されます。
キーを使用すると、ローカリゼーション管理プラットフォームは、コードを提示しなくても翻訳者に翻訳可能テキストを提示できます。
キーは、リソースファイルがプロジェクトページのタブを通じてアップロードされる際に作成されるのが理想なので、通常、プロジェクトに追加する必要はありません。
エディタがキーを選択しないようにするには、ブロッキングキー機能を使用します。エディタにキーを表示するが、翻訳しない場合は、キーの除外機能を使用します。
プロジェクトのキーは、プロジェクトページのセクションまたは Strings エディタペインの上部にある「その他/複製キー」を選択することで複製できます。
1つまたは複数のプロジェクトで同じ値を持つ異なる翻訳キーをリンクして、コンテンツ更新を自動化できます。リンクされたキーを使用して、プロジェクト全体で一貫性を確保し、同一コンテンツの繰り返し仕事を排除します。
キーに対する変更は、Strings エディタのサイドバーアクティビティウィンドウから元に戻すことができます。
備考
リポジトリ (GitHub、GitLab など) で作業し、キーを削除する場合、キーを完全に削除するには、phrase とリポジトリの両方から削除する必要があります。これは、phraseやリポジトリ内のエラーや事故によるキーの誤削除を防ぐためです。
キー名は 1 つのプロジェクト内で一意である必要があります。
キーの命名にはいくつかの方法があります。
キーがアップロードされていない場合は、手動で作成できます。
キーの作成手順は、次のとおりです。
-
]タブで、追加キーをクリックします。
キーの追加ウィンドウが開きます。
-
］タブから、 、 、使用可能な、およびを入力します。
-
必要に応じて、「タブから複数形を有効にします。
-
必要に応じて、タブで除外される言語を選択します。
-
必要に応じて、 タブで技術の詳細を入力します。
-
保存をクリックします。
キーがプロジェクトに追加され、「タブで確認できます。
エディタまたは「タブからキーを削除すると、関連するすべての翻訳が削除され、元に戻すことはできません。
ブロッキングを行うと、キー全体がプロジェクトに追加されません。アップロードされたファイルにブロックされたキーの名前が含まれる場合、そのキーは省略され、プロジェクトに追加されません。
ブロッキングは、プロジェクトからキーを除外して、それらがまったく管理されないようにするために使用します。
通常ブロックされるキー：
-
日時ファイル形式 Strings。
-
設定を含むキー。
-
Phrase gemで管理されている場合、問題を引き起こすキー。
ブロックされたキーを、処理またはメンテナンスされていない別の言語ファイルで管理します。
これらのキーは問題を引き起こす可能性があるため、プロジェクト作成時にブロックする必要があります。
-
activemodel.errors* -
number.format* -
number.currency* -
number.percentage* -
datetime.prompts*
一部のキーは特定の言語から除外する必要があり、除外としてマークできます。これらのキーはアップロードされ、プロジェクト内に存在していますが、無視されます。
除外された翻訳：
-
関連言語のエクスポートから除外されました。
-
関連言語レポートから除外されます。
コンテンツが empty の場合、未翻訳とはカウントされません。
-
翻訳エディタでは表示されますが、編集できません。
除外オプション：
-
翻訳エディタ内の言語で単一の翻訳を除外します。
-
翻訳エディタ内の言語で複数の翻訳を除外
-
キーを作成または編集するときに言語を選択することで、複数の翻訳を除外します。