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 目录的哈希与上下文约定。
请将针对具体使用场景的备注与适用于整个本地化引擎的术语表、规则和品牌语调分开。两者都可能发送到后端,因此都不应包含机密信息或您无权披露的内容。