JSONC
借助上下文提示翻译带注释的目录,了解译文输出会保留哪些注释。
JSONC 让消息与说明相伴存放。jsonc 文件处理器会读取字符串前的注释,将其作为翻译提示,并按与 JSON 相同的路径翻译嵌套字符串值。
请在源目录中维护这些注释。重建后的目标文件使用两个空格缩进,并以换行符结尾。它会在与源文件相同的条目上保留 @orphan 标记,移除其余所有注释。因此,依赖其他元数据的使用方需要另行保留这些元数据。
将上下文放在对应值旁边 #
这个目录说明了“返回”要让读者执行什么操作:
{
/* @context Button that returns to the previous checkout step */
"back": "Back",
"product": "Acme",
}注释仅适用于下一个字符串值,不会作用于所在对象的所有后代值。如果中间出现数字、布尔值或 null,待用的提示就会被清除。请将注释紧挨着放在它所描述的字符串之前,并使用所选界面中的控件保护固定标识符。
有 @context 时,该行中标记之后的内容就是提示。没有该标记时,整条注释都会作为提示,因此,字符串前的任何非空注释都会传递给翻译器。如果字符串前有多条注释,则采用最后一个非空提示,即使之前的注释包含 @context 也不例外。@orphan 用于标记目录元数据;该字符串仍可被选中进行文件翻译。
文件翻译与 React 目录 #
React 目录提取会生成扁平的 JSONC 目录,并为条目附加元数据。其读取器能够识别 @context、@src 和 @orphan;提取过程会利用这些字段维护源位置,并标记已无法找到的消息。这属于目录管理工作流,与翻译任意 JSONC 文档是两回事。
维护提取出的消息时,请参阅 React 目录与类型。不要因为认为常规文件输出会重新生成元数据,就将其从源目录中删除。
配置文件翻译 #
CLI 会根据 .jsonc 推断 jsonc;GitHub App 则使用配置中指定的文件类型。请在 CLI 配置或 GitHub 配置中选择源路径和目标路径。
保留正确的值 #
增量比较、路径锁定、路径保留、路径忽略和语言区域注入,都遵循 JSON 文件处理器对这些操作的区分。锁定会复制源数据;保留会沿用目标数据;忽略则会移除路径。请参阅 JSON,了解优先级以及仅处理部分范围时的影响,不要将这些操作视为可互换的排除方式。
检查重建文件中的键和受保护的值,再通过应用的目录读取器加载目标文件。对于 React 目录,请确保提取过程仍能读取源元数据:翻译后的目标文件会保留 @orphan,但不会保留 @context 或 @src。
翻译工作流会检查受支持的占位符和 ICU 结构,包括参数是否发生变化或缺失。请查看报告中的警告或失败信息,再使用应用提供的值渲染已接受的模板。在进行这些结构检查的同时,也请审核内容的含义和完整性。