跳到主要内容
版本:最新版(未发布)

翻译指南

翻译页面含义,不要照搬英文句式。命令、配置键、API 路径、代码标识和产品名必须与原文完全一致。

翻译检查清单​

  • 从 website/docs/ 下的当前英文页开始。
  • 保留 front matter、标题层级、代码块、提示框、链接和图片路径。
  • 对 signal、projection、decision、algorithm、plugin、recipe、model card 等路由概念使用同一套译法。
  • 不要翻译 YAML 键、环境变量、请求头名、CLI 标志、文件名,或属于线协议的取值。
  • 重新跑语言构建,确认标题不会破坏锚点或导航。

当前版中文页镜像英文树,位于:

website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/

只有译文仍然准确时才保留语言 override。若译文跟不上英文源,就删掉当前版 override;Docusaurus 会显示当前英文页,而不是发布过期译文。该回退只适用于当前文档。不要删除 version-v* 下的历史译文。

在 website/ 下校验语言:

npm run build:zh

从仓库根目录审计已有译文,并报告英文回退覆盖:

make docs-check-translations

机翻可以当草稿,但发布前必须由贡献者审术语、技术含义和所有可执行示例。