翻訳バンドルの構造の理解

アプリケーションで追加の翻訳バンドルを作成する場合は、翻訳バンドルの構造を理解しておく必要があります。

次のガイドラインでは、アプリケーションのデフォルトの翻訳バンドルの構造を説明します:

バンドルには、nlsという名前のルート・フォルダが含まれています。
nlsフォルダには、バンドルに含まれる翻訳ロケールを識別するJSONファイルが含まれている必要があります。
すべてのバンドル・ファイルは、バンドル名に-strings.jsonを付加したJSONファイルである必要があります。 (たとえば、MyNewPageバンドルのJSONファイルはMyNewPage-strings.jsonという名前になります)

アプリケーションの各バンドルのルートJSONファイルへのパスは、app-flow.jsonで指定する必要があります。

バンドルには、サポートされている言語を識別するnlsフォルダのルート・レベルにJSONファイルが格納されています。また、nlsフォルダ内に、変換文字列のキーと値を格納するJSONファイルを含む1つ以上のフォルダがあります。デフォルトでは、nlsフォルダには、ルート変換ファイルapp-strings.jsonを含むrootという名前のフォルダがあります。

追加のロケールが指定されていない場合、ルート・レベルのapp-strings.jsonファイルには"root": trueのみが含まれます。フランス語のロケールや翻訳など、追加のロケールが1つサポートされている場合、ルート・レベルのJSONファイルには次のロケール識別子が含まれます:

{
  "root": true,
  "fr": true
}

各ロケールについて、nlsフォルダには、そのロケールの翻訳文字列を含むJSON変換ファイルを含む対応するフォルダが含まれている必要があります。 rootフォルダ内のJSONファイルのデフォルト名は<bundle-name>-strings.jsonです。フランス語のロケールが追加されている場合、nlsフォルダにはJSONファイル<bundle-name>-strings.jsonを含むfrという名前のフォルダも含まれます。各翻訳ファイルには、キー/バリュー・オブジェクトとオブジェクト・メタデータが含まれています。各オブジェクトには、要素の詳細の一意のID識別子と、翻訳者にとって有用なオブジェクトのコンテキストに関する詳細を含む説明的なメタデータを含めることができます。