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