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