安全更新单个键或术语

重新翻译选定部分,保留相邻内容,同时检查修正是否符合预期、其余内容是否保持不变。

小范围修正要同时满足两个标准:选定内容得到改进,无关且已认可的内容保持不变。请保存现有译文及其对应的源内容修订版本,以便核查这两点。

要修正已知的键或术语,请按本指南操作。对于常规源内容更改,请参阅更新时保留译文。对于已提交的任务,请先检查其恢复状态,再发起更多请求。

将已认可的相邻内容纳入对比 #

示例翻译目录可能包含以下内容:

json
{
  "account": {
    "invitation": "Approval is required before access is granted.",
    "support": "Contact support"
  }
}

假设只有 account.invitation 的译文措辞需要修正。请保存译文及其对应的源内容修订版本,其中也要包含你希望保留的、已认可的 account.support 措辞。

选择措辞修正方式 #

如需进行一次性的精确修正,请直接编辑译文值,在应用中检查后,提交已审核的翻译目录。只要该消息的源内容未变,常规源内容更新就可以保留这项修改。

如需重新生成,请先补充翻译所需的信息,让它能够生成不同的结果。可以在引擎的术语表中添加已批准的术语,在其规则中修正反复使用的指令,或明确消息的 JSONC 上下文,然后刷新受影响的键。如果源内容和指导信息都未改变,重新生成仍可能得到相同的措辞。

为术语筛选划定语义边界 #

筛选消息前,先明确术语的含义。例如,产品中的“工作区”可以指共享项目区域,而另一段文字描述的可能是实体工作场所。请在术语表中记录预期的产品含义和团队批准的目标术语,再仅选择使用这一含义的消息。术语边界进一步说明了如何作出这一判断。

使用 CLI 选择现有译文中的键 #

在已配置的项目中,若该 JSON 源文件位于 locales/en/account.json,可使用以下命令:

bash
lingo push "locales/en/account.json" --key "account.invitation" --wait

对于 JSON,即使源文本未变,--key 也会重新生成选定单元。对于每个已配置且已有目标文件的语言区域,它都会刷新这些键,并将新值合并到对应的目标文件中。

刷新前,请保存现有修正:本次推送捕获的译文中,选定键的值可能会被替换。要检测提交后对译文所作的修改,请省略 --wait,并在获取结果前检查 lingo pull --dry-run。有关冲突处理,请参阅拉取时的本地编辑分类。

无论通过 push --wait 还是单独的拉取操作获取结果,键刷新都不会改变整个源内容的基线。因此,待处理的常规源内容修改仍会在后续的普通推送中提交。

键模式支持精确键、对象前缀和匹配完整键段的 * 通配符。auth.login 可以包含 auth.login.title,而不会匹配 auth.login_url。请用引号括住通配符,并重复使用 --key 来指定多个所需模式。

JSONC、TypeScript 和 PHP 的限定范围刷新行为相同。YAML 和以语言区域为根的 YAML 可能会保留所选的未变译文;如需精确修正,请直接编辑译文,或在重新生成整个文件前保存已认可的译文。CLI 范围列出了各格式的行为,并定义了键的写法。

查找受术语影响的键或文件 #

查找使用该术语预期含义的源消息,并检查其上下文。按上面的命令,通过 --key 选择这些消息中受支持的键。对于需要重新生成整个文件的格式,请先保存已认可的译文,再刷新受影响的源文件,例如:

sh
lingo push 'docs/en/workspaces.md' --force --wait

请使用配置中已选定的源路径。这会替换该文件在已配置目标语言区域中的译文。请对比重写后的完整消息或文件,包括术语周围的文本。

验证更改、保留情况和实际使用效果 #

将每个已更改的目标路径与保存的版本逐一对比。在此示例中,邀请消息必须保留“获得访问权限前需要批准”的要求,支持消息则必须与已认可的基线一致。如果相邻内容缺失或出现意外改写,请先检查范围和基线,再接受结果。

检查变量和键控制项:锁定会复制源文本,保留会维持现有译文值,忽略则会从支持该功能的格式输出中移除内容。

在实际使用该输出的运行环境中加载它。对于文档,请检查更改后的段落、链接和组件。替换本地修改前,先解决拉取冲突,再将已认可的译文与其对应的源内容修订版本及 Lockfile 一同提交。