翻译说明时保留可执行标识符
Preserve Executable Identifiers Across Localization
解释文字可以翻译,指令加载器和引用解析器使用的名称必须原样保留。
以下示例与示意结果由本站编写,用于说明方法,不是模型实测结果。
使用场景
只授权翻译release-check,已知name、调用$release-check及references/checklist.md均由机器解析。解释文字可中文,改字段键或路径却会破发现有引用。
具体做法
先清点机器身份、schema键、路径、调用和需保字面示例,再翻译其外叙述。解析译前后身份及引用,核字段类型/目标文件与允许工具;展示标题可本地化但不顶替机器name。要改名则另记录授权与调用方迁移,不混在翻译中。语法和实际加载分别验证。
反例
name改“名称”、release-check改中文、路径也翻但文件不迁;只要易读便算完成。
改进写法
翻译description值和正文,保留name: release-check、$release-check、references/checklist.md和YAML键。解析比较身份/引用且检查文件可达,再做实际宿主加载测试或标未测;不把语法通过当已激活。
为什么这样改
人读标签与机器符号用途不同。字面清单保护加载与引用语义,允许自然解释而不误改授权之外接口。
如何验证
教学译文name仍release-check、引用同路径,说明为中文。改成名称字段应让schema检查失败,翻路径但文件不变应暴露缺目标。正文提到通用词不必全部保英文。
适用边界
此法保护真正机器解析项,不强迫所有术语英文。不同宿主前言规则需核;授权改名可以迁移,但须明确范围。冻结术语表的语言习惯不是所有本地化要求。
原文与版本
- affaan-m/ECC · Preserve ECC surface names and YAML field names
查看此版本的文件ef648e01899b - affaan-m/ECC · Keep technical surface identity distinguishable from translated prose
查看此版本的文件ef648e01899b