翻译
桌面应用、Web 界面和这些文档均以英文编写,并翻译成其他语言。尚未翻译的内容会以英文显示,因此只翻译一部分也可以安全发布。
| 内容 | 英文源文件 | 译文 |
|---|---|---|
| 应用文本 | packages/client-ui/locales/en.json | packages/client-ui/locales/<lang>.json |
| 文档页面 | docs/src/content/docs/<page>.mdx | docs/src/content/docs/<folder>/<page>.mdx |
| 用词选择 | docs/i18n/glossary/<lang>.md |
命令行工具、HTTP API 错误信息和日志保持英文,因为脚本和智能体需要读取它们。
修正译文
-
编辑译文文件中的文字。
{{placeholders}}占位符须与英文完全一致,并遵循该语言的术语表。 -
检查译文:
Terminal window pnpm i18n checkTranslations are consistent with English. -
提交拉取请求,并注明你以哪种语言的读者身份进行了检查。
查看待翻译内容
pnpm i18n statuszh-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| 状态 | 含义 |
|---|---|
| 缺失 | 尚无译文;显示英文 |
| 已过时 | 译文完成后英文发生了改动 |
| 未记录 | 已翻译,但尚未与某个英文版本建立记录 |
英文变动时,机器人会保持译文同步;参见译文如何保持最新。
更新已过时的译文后,请将其记录为与当前英文一致,并注明你检查过的键或页面:
pnpm i18n stamp zh-CN reference/translate.mdx翻译文档页面
将英文页面复制到语言目录中并翻译正文。保持结构不变,以便检查工具对比两者:
- 代码保持原样;可以翻译注释和引号中的示例文字。
- 链接须与英文完全一致,例如
/setup/install/。这些链接会自动以读者所用语言打开对应页面。 - 每个标题末尾都要加上英文标题的 ID,例如
## 安装 \{#install},以便#install链接在每种语言中都有效。MDX 中需要反斜杠。 - 保留导入语句和组件(
<Aside>、<Steps>、<Tabs>)。
添加语言
- 应用:新增
packages/client-ui/locales/<lang>.json(以{}开头),并将语言标签加入packages/client-ui/src/i18n.ts中的languages,以及packages/desktop/src-tauri/src/i18n.rs中的CATALOGS。 - 文档:将该语言加入
docs/locales.mjs,并创建其目录,例如docs/src/content/docs/ja/。 - 新增
docs/i18n/glossary/<lang>.md,列出该语言的微信官方术语。 - 运行
pnpm i18n check,然后提交拉取请求。