CLI v0の翻訳者向けメモ

従来のJSONCやXcodeのメッセージに使用箇所ごとの意味を添え、対象の翻訳を明示的に更新します。

短いラベルには、翻訳者が必要とする情報が十分に含まれていないことがあります。メモを添えれば、画面の文言を増やすことなく、何を指すのか、どんな操作なのか、どのような文体が適切かを伝えられます。従来のワークフローでは、対応している場合はJSONCのコメントやXcodeカタログ標準のコメントフィールドを使ってください。

不足している意味を補う #

jsonc
{
  // Patient medical records, not music recordings
  "records": "Records",
  // Button that submits the form; use a short action label
  "submit": "Submit",
  // Visual theme, not weight
  "theme.light": "Light"
}

i18n.jsonでコメント対応のパーサーを選択します。

json
{
  "buckets": {
    "jsonc": { "include": ["locales/[locale].jsonc"] }
  }
}

「保存された診療記録のコレクション」なら何を指すのかが伝わりますが、「ユーザーに表示するテキスト」では伝わりません。表示位置や文体についてのメモがあれば、改まった通知と操作ラベルで表現が異なる理由を説明できます。厳密に保持する必要がある値は、翻訳上のメモだけで守ろうとせず、キー制御を使ってください。

対象の翻訳結果を確認する #

メモだけを編集しても、原文の値のチェックサムは変わらない場合があります。インストール済みのバージョンで変更のないテキストがスキップされる場合は、選択した項目の再翻訳をリクエストしてください。翻訳されたラベルは、実際の画面で周囲の表示と合わせて確認してください。

XCStringsでは、標準のコメントフィールドを使い、共有カタログのロケール構造を維持してください。別のバケットでも同じようにメモが読み取られると考える前に、従来の形式を確認してください。これらの従来のコメントは、現在のReactカタログのハッシュとコンテキストに関する仕様には含まれません。

使用箇所ごとのメモは、ローカライゼーションエンジン全体に適用する用語集、ルール、語り口とは分けて管理してください。どちらもバックエンドに送信される可能性があるため、機密情報や開示する権限のない内容は含めないでください。