キーは、ソフトウェアコード内の翻訳可能な文字列を識別するために使用されます。これにより、キー (翻訳可能な文字列のコード名として) を使用することで、文字列の必要な翻訳ごとにではなく、Phraseによって一度だけ参照されるようになります。
キーには複数の訳文を関連付けることができ、それぞれがプロジェクトの異なる言語ロケールに対応しています。この機能は、リレーショナルデータベースの主キーと似ており、訳文がキーの属性となります。キーはリソースファイルに保存され、原文と言語を識別するために使用されます。
キーを使用することで、ローカリゼーション管理プラットフォームは、コードを提示することなく、翻訳者に翻訳可能なテキストを提示できるようになります。
キーは、プロジェクトページのタブからリソースファイルをアップロードする際に作成するのが理想的であるため、通常はプロジェクトに追加する必要はありません。
キーがアップロードまたは作成されるのを防ぐには、キーをブロック機能を使用します。ブロックされたキーが既に存在する場合、エディタで翻訳することはできません。
キーをエクスポートから除外するには、キーを除外機能を使用します。除外されたキーも、エディタで翻訳することはできません。
プロジェクトのキーは、プロジェクトページのセクション、またはStrings Editorペインの上部でその他/キーを複製を選択することで複製できます。
1つまたは複数のプロジェクト間で同じ値を持つ異なる翻訳キーをリンクして、コンテンツの更新を自動化できます。リンクされたキーは、プロジェクト間の一貫性を確保し、同一コンテンツに対する繰り返しの仕事を排除するために使用されます。
キーへの変更は、Strings Editorのサイドバーアクティビティウィンドウから元に戻すことができます。
備考
リポジトリ (GitHub、GitLabなど) を使用してキーを削除する場合、キーを完全に削除するにはPhraseとリポジトリの両方からキーを削除する必要があります。これは、Phraseまたはリポジトリのいずれかでのエラーや事故によるキーの誤削除を防ぐためです。
Stringsでは、アップロードされたファイルのファイル形式に応じて、キーに異なるタイプを設定できます。
-
文字列 (デフォルト)
備考
-
配列
-
ブール
-
Markdown
-
番号
キーのタイプは、エディタのサイドバー<2>の
キー名は、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)を入力し、保存をクリックします。
キーが一覧に追加されます。
キーは、後でをクリックして変更するか、
で削除できます。
一部のキーは特定の言語から除外する必要がある場合があり、除外対象としてマークできます。これらのキーはプロジェクトにアップロードされ存在していますが、無視されます。
除外された翻訳は以下の通りです。
-
関連する言語のエクスポートから除外されます。
-
関連する言語のレポートから除外されます。
コンテンツが空欄の場合、未翻訳としてはカウントされません。
-
翻訳エディタでは表示されますが、編集はできません。
除外オプション:
-
翻訳エディタ内で、ある言語の単一の翻訳を除外します。
-
翻訳エディタ内で、ある言語の複数の翻訳を除外します。
-
キーの作成時または編集時に言語を選択して、複数の翻訳を除外します。