From: Jinjiang <zhaojinjiang@me.com>
Date: Tue, 2 May 2023 08:15:05 +0000 (+1000)
Subject: docs(zh): add a translation guide (#1823)
X-Git-Tag: v4.2.0~8
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=c49541a0df99da45c129a12868419f5a5d3cddda;p=thirdparty%2Fvuejs%2Frouter.git

docs(zh): add a translation guide (#1823)
---

diff --git a/packages/docs/.vitepress/config/zh.ts b/packages/docs/.vitepress/config/zh.ts
index 3074aec6..985730c4 100644
--- a/packages/docs/.vitepress/config/zh.ts
+++ b/packages/docs/.vitepress/config/zh.ts
@@ -175,6 +175,10 @@ export const zhConfig: LocaleSpecificConfig<DefaultTheme.Config> = {
               text: '从 Vue2 迁移',
               link: '/zh/guide/migration/index.html',
             },
+            {
+              text: '关于中文翻译',
+              link: '/zh/about-translation.html',
+            },
           ],
         },
       ],
diff --git a/packages/docs/zh/about-translation.md b/packages/docs/zh/about-translation.md
new file mode 100644
index 00000000..6c52db7f
--- /dev/null
+++ b/packages/docs/zh/about-translation.md
@@ -0,0 +1,44 @@
+# 关于中文翻译
+
+这里是 Vue Router 文档的中文翻译，该翻译由 Vue 社区贡献完成，如对翻译有任何疑问，可在我们的 GitHub 仓库创建 issue 或 pull request。谢谢。
+
+## 协作指南
+
+在参与翻译之前，请移步这里了解翻译的基本流程和注意事项：
+
+https://github.com/vuejs/router/blob/main/.github/contributing.md#contributing-docs
+
+如果想快速了解待更新的内容，可以访问此链接查阅 `packages/docs/` 部分的更新：
+
+https://github.com/vuejs/router/compare/docs-sync-zh...main
+
+如果想快速了解待翻译的内容，可以访问此链接查阅 `packages/docs/zh/` 部分的更新：
+
+https://github.com/search?q=repo%3Avuejs%2Frouter+path%3Apackages%2Fdocs%2Fzh+TODO%3A+translation&type=code
+
+## 翻译须知
+
+首先，Vue Router 文档的中文翻译遵循 Vue 主站的翻译须知。详见：
+
+https://github.com/vuejs-translations/docs-zh-cn/wiki/%E7%BF%BB%E8%AF%91%E9%A1%BB%E7%9F%A5
+
+其次，针对 Vue Router 本身的特殊语境，我们在上述翻译须知的基础上整理了一份附加的术语约定：
+
+| 英文 | 建议翻译 |
+| --- | --- |
+| active (link) | 匹配当前路由 (的链接) |
+| exact active (link) | 严格匹配当前路由 (的链接) |
+| location | 地址 |
+| (nagivate) from | (导航) 离开 |
+| (nagivate) to | (导航) 进入 |
+| (navigation) guard | (导航) 守卫 |
+| path | 路径 |
+
+## 中文格式校验
+
+我们使用 [zhlint](https://www.npmjs.com/package/zhlint) 对中文翻译的格式进行校对，用法可参考以下命令：
+
+```bash
+pnpm add -g zhlint
+zhlint "./packages/docs/zh/**/*.md"
+```