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