翻译 YAML 配置文件(如 Kubernetes/Ansible 文档)时如何保持缩进的严格性?

核心现状诊断

YAML 依赖缩进(空格)来表示层级,任何缩进错误都将导致文件解析失败。

根本原因剖析

严格的空格锚点保护

我们不仅翻译文本,还会记录每一行文本前的空格数量。翻译完成后,系统会强制将译文回填到对应的缩进层级,确保 YAML 语法树结构 100% 正确。

注释的翻译与保留

配置文件中的注释(# 后的内容)对于理解配置至关重要。用户可选择翻译这些注释以便团队理解,同时保持配置键值(Key)不变。

多文档流的支持

对于包含多个文档(通过 `---` 分隔)的单一 YAML 文件,系统能够识别分隔符,并分别处理各个区块,避免不同模块内容混淆。

最终解决方案总结

让技术配置文档的本地化不再成为运维的难题,确保部署脚本可以在全球通用。