跳转到内容

翻译

桌面应用、Web 界面和这些文档均以英文编写,并翻译成其他语言。尚未翻译的内容会以英文显示,因此只翻译一部分也可以安全发布。

内容英文源文件译文
应用文本packages/client-ui/locales/en.jsonpackages/client-ui/locales/<lang>.json
文档页面docs/src/content/docs/<page>.mdxdocs/src/content/docs/<folder>/<page>.mdx
用词选择docs/i18n/glossary/<lang>.md

命令行工具、HTTP API 错误信息和日志保持英文,因为脚本和智能体需要读取它们。

修正译文

  1. 编辑译文文件中的文字。{{placeholders}} 占位符须与英文完全一致,并遵循该语言的术语表。

  2. 检查译文:

    Terminal window
    pnpm i18n check
    Translations are consistent with English.
  3. 提交拉取请求,并注明你以哪种语言的读者身份进行了检查。

查看待翻译内容

Terminal window
pnpm i18n status
zh-CN
UI: 724 translated (0 by machine), 0 missing, 0 out of date, 0 unrecorded
Docs (zh-cn/): 35 current, 2 missing, 0 out of date, 0 unrecorded
Docs missing: how-it-works/translations.mdx, reference/translate.mdx
状态含义
缺失尚无译文;显示英文
已过时译文完成后英文发生了改动
未记录已翻译,但尚未与某个英文版本建立记录

英文变动时,机器人会保持译文同步;参见译文如何保持最新。

更新已过时的译文后,请将其记录为与当前英文一致,并注明你检查过的键或页面:

Terminal window
pnpm i18n stamp zh-CN reference/translate.mdx

翻译文档页面

将英文页面复制到语言目录中并翻译正文。保持结构不变,以便检查工具对比两者:

  • 代码保持原样;可以翻译注释和引号中的示例文字。
  • 链接须与英文完全一致,例如 /setup/install/。这些链接会自动以读者所用语言打开对应页面。
  • 每个标题末尾都要加上英文标题的 ID,例如 ## 安装 \{#install},以便 #install 链接在每种语言中都有效。MDX 中需要反斜杠。
  • 保留导入语句和组件(<Aside>、<Steps>、<Tabs>)。

添加语言

  1. 应用:新增 packages/client-ui/locales/<lang>.json(以 {} 开头),并将语言标签加入 packages/client-ui/src/i18n.ts 中的 languages,以及 packages/desktop/src-tauri/src/i18n.rs 中的 CATALOGS。
  2. 文档:将该语言加入 docs/locales.mjs,并创建其目录,例如 docs/src/content/docs/ja/。
  3. 新增 docs/i18n/glossary/<lang>.md,列出该语言的微信官方术语。
  4. 运行 pnpm i18n check,然后提交拉取请求。