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