跳到正文

翻译与上游同步

按指定的上游版本翻译,保留技术语义,并同步核对链接、示例和导航。

先锁定原文范围

确认上游仓库、分支和提交,再核对目标页面是否已有翻译。翻译前阅读上下文和相关示例,按项目术语表沿用译名。遇到新术语时,查阅上游定义和已有译文,并在首次出现处按需要附原词。

翻译更新可以按上游差异逐段检查。页面移动、删除或改名时,同时核对中文导航、互相引用的链接和页面元数据。

保留技术信息

把原文改写成便于中文读者执行的句子,保留条件、否定、默认值、单位和版本范围。保持命令、参数、路径、代码字符串和实际界面标签的准确拼写。可翻译面向读者的示例注释,译后仍需执行示例。

对站内链接,优先替换为对应的中文页面和实际存在的标题锚点。需要保留上游链接时,把链接加在句中的页面名或术语上。

按页面结构翻译和核对

保留读者需要经过的步骤和可观察结果。容易机械直译的条件句可以先拆清含义,再在中文中明确适用范围。例如,原文 Only rebuild when the output changes 可以写成“仅当输出改变时才重新构建”。在对照实例中可检查类似的否定、可能性和边界。

翻译导航、摘要、标题和图片替代文本时,查实际页面使用了哪些值。代码注释可以按读者需要本地化。终端、浏览器或接口实际会返回的字符串,仍用对应环境的输出,并在旁边解释。

交接更新

提交时说明上游版本、处理的页面和本地验证结果。遇到上游歧义时,在 PR 说明中附上对应段落和观察结果,以便沿译文审阅流程核对语义。

维护已有翻译时,先用上游差异流程查看新增、变更和移动。跨页统一术语前按术语表维护约定记录信息,避免遗漏引用和搜索入口。