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 目录的哈希与上下文约定。

请将针对具体使用场景的备注与适用于整个本地化引擎的术语表、规则和品牌语调分开。两者都可能发送到后端,因此都不应包含机密信息或您无权披露的内容。