保留标记与格式的翻译
翻译带占位符、标签或代码片段的文本时,规则是:占位符与标记原样保留、位置可以按目标语序调整、其内容不翻译;只翻自然语言部分。交付前用程序做一次占位符数量与集合比对、标签配对检查——这是成本极低但能拦住大部分线上事故的自动检查。
基本信息
| 占位符 | 原样保留、允许移位;翻译后核对数量与集合 |
|---|---|
| 标签 | 结构不动,只译标签之间的文本节点 |
| 代码 | 代码块内容不翻译 |
| 核对 | 程序比对占位符集合与标签配对,低成本自动检查 |
典型使用场景
- 通知模板本地化:模板变量在翻译中不能被改掉
- 界面文案:HTML 标签结构必须保持,只译文本节点
- 邮件模板:变量与格式标记混排,需要逐项核对
- 文档站点:代码示例保留原文,说明文字翻译
- 多语言消息:ICU 复数形式的各分支都要覆盖
保留标记模板
保留标记模板
翻译下面的文本:
- 保留所有花括号占位符(如 {name}、{count})原样不动
- 占位符可在句中移动位置以符合目标语语序
- 保留 HTML 标签结构与全部属性,只翻译标签之间的文本
- 代码片段(<code> 内)不翻译
- 数字、日期格式保持原文,不做本地化换算
输出:只输出译文,不要添加说明。
文本:<text>……</text>
# 交付前自动核对
# 1) 占位符集合与数量逐项比对
# 2) HTML 标签配对与顺序一致性检查元素处理对照
| 元素 | 处理方式 | 核对方式 |
|---|---|---|
| 花括号占位符 | 原样保留,可移位 | 集合比对 + 数量核对 |
| HTML 标签 | 结构不动,只译文本节点 | 标签名与顺序配对检查 |
| 标签属性 | 全部保留不改 | 属性名与值逐项比对 |
| 代码片段 | 不翻译 | 代码块内容哈希比对 |
| ICU 复数分支 | 每个分支都翻译 | 分支数量与关键字检查 |
模型偶发会把 {name} 这类占位符翻译成中文(例如译成「名字」)。这类错误在界面上表现为变量原样显示,交付前必须做占位符校验,不能只看译文顺不顺。
ICU 复数形式(plural)的语言分支较多,漏翻某一个分支只有在运行时遇到该数量时才暴露,属于典型的后置故障。核对时按分支逐一确认。