docs(zh): improve translations (#3427)

Author: awxiaoxian2020

Diff for: docs/.vitepress/config/zh.ts

@@ -22,8 +22,8 @@ export const zh = defineConfig({
     },
 
     footer: {
-      message: '根据 MIT 许可发布。',
-      copyright: '版权所有 © 2019 至今 尤雨溪'
+      message: '基于 MIT 许可发布',
+      copyright: `版权所有 © 2019-${new Date().getFullYear()} 尤雨溪`
     },
 
     docFooter: {

Diff for: docs/zh/guide/asset-handling.md

@@ -2,13 +2,13 @@
 
 ## 引用静态资源 {#referencing-static-assets}
 
-所有的 Markdown 文件都会被编译成 Vue 组件，并由 [Vite](https://vitejs.dev/guide/assets.html) 处理。可以，**并且应该**使用相对路径来引用资源：
+所有的 Markdown 文件都会被编译成 Vue 组件，并由 [Vite](https://vitejs.dev/guide/assets.html) 处理。可以**并且应该**使用相对路径来引用资源：
 
 ```md
 ![An image](./image.png)
 ```
 
-可以在 Markdown 文件、主题中的 `*.vue` 组件、样式和普通的 `.css` 文件中引用静态资源，通过使用绝对路径 (基于项目根目录) 或者相对路径 (基于文件系统)。后者类似于 Vite、Vue CLI 或者 webpack 的 `file-loader` 的行为。
+可以在 Markdown 文件、主题中的 `*.vue` 组件、样式和普通的 `.css` 文件中引用静态资源，可以使用绝对路径 (基于项目根目录) 或者相对路径 (基于文件系统)。后者类似于 Vite、Vue CLI 或者 webpack 的 `file-loader` 的行为。
 
 常见的图像，媒体和字体文件会被自动检测并视作资源。
 
@@ -24,7 +24,7 @@
 
 放置在 `public` 中的资源将按原样复制到输出目录的根目录中。
 
-请注意，应使用根绝对路径来引用放置在 `public` 中的文件——例如，`public/icon.png` 应始终在源代码中作为 `/icon.png` 引用。
+请注意，应使用根绝对路径来引用放置在 `public` 中的文件——例如，`public/icon.png` 应始终在源代码中使用 `/icon.png` 引用。
 
 ## 根 URL {#base-url}
 
@@ -38,13 +38,13 @@
 
 在这种情况下，更改 `base` 配置值时，**无需**更新该引用。
 
-但是如果你正在编写一个主题组件，它动态地链接到资源，例如一个图片，它的 `src` 基于主题配置值：
+但是如果你正在编写一个主题组件，它动态地链接到资源，例如一个图片，它的 `src` 基于主题配置：
 
 ```vue
 <img :src="theme.logoPath" />
 ```
 
-在这种情况下，建议使用 VitePress 提供的 [`withBase` helper](../reference/runtime-api#withbase) 来包装路径：
+在这种情况下，建议使用 VitePress 提供的 [`withBase` helper](../reference/runtime-api#withbase) 来包括路径：
 
 ```vue
 <script setup>

Diff for: docs/zh/guide/cms.md

@@ -53,4 +53,4 @@ outline: deep
 
 ## 整合指南 {#integration-guides}
 
-如果你已经写了一篇关于如何将 VitePress 与特定 CMS 集成的指南，请点击下面的“在 GitHub 上编辑此页面”链接将它提交到这里！
+如果你已经写了一篇关于如何将 VitePress 与特定的 CMS 集成的指南，请点击下面的“在 GitHub 上编辑此页面”链接将它提交到这里！

Diff for: docs/zh/guide/custom-theme.md

@@ -15,7 +15,7 @@
 └─ package.json
 ```
 
-当检测到存在主题入口文件时，VitePress 总会使用自定义主题而不是默认主题。但你可以[拓展默认主题](./extending-default-theme)来在其基础上实现更高级的自定义。
+当检测到存在主题入口文件时，VitePress 总会使用自定义主题而不是默认主题。但你可以[扩展默认主题](./extending-default-theme)来在其基础上实现更高级的自定义。
 
 ## 主题接口 {#theme-interface}
 
@@ -100,15 +100,15 @@ const { page } = useData()
 </template>
 ```
 
-[`useData()`](../reference/runtime-api#usedata) 为我们提供了所有的运行时数据，以便我们根据不同条件渲染不同的布局。我们可以访问的另一个数据是当前页面的 frontmatter。通过利用这个数据，我们允许用户控制每个页面的布局。例如，用户可以指定一个页面是否使用特殊的主页布局：
+[`useData()`](../reference/runtime-api#usedata) 为我们提供了所有的运行时数据，以便我们根据不同条件渲染不同的布局。我们可以访问的另一个数据是当前页面的 frontmatter。通过利用这个数据，可以让用户单独控制每个页面的布局。例如，用户可以指定一个页面是否使用特殊的主页布局：
 
 ```md
 ---
 layout: home
 ---
 ```
 
-并且我们可以调整我们的主题进行处理：
+并且我们可以调整主题进行处理：
 
 ```vue{3,12-14}
 <script setup>
@@ -158,11 +158,11 @@ const { page, frontmatter } = useData()
 
 如果你希望将主题作为 npm 包来分发，请按照下面的步骤操作：
 
-1. 在包入口将主题对象作为默认导出来导出。
+1. 在包入口将主题对象使用默认导出。
 
 2. 如果合适的话，将主题配置类型定义作为 `ThemeConfig` 导出。
 
-3. 如果主题需要调整 VitePress 配置，请在包的子路径下 (例如 `my-theme/config`) 下导出该配置，以便用户拓展。
+3. 如果主题需要调整 VitePress 配置，请在包的子路径下 (例如 `my-theme/config`) 下导出该配置，以便用户扩展。
 
 4. 记录主题配置选项 (通过配置文件和 frontmatter)。
 
@@ -179,7 +179,7 @@ import Theme from 'awesome-vitepress-theme'
 export default Theme
 ```
 
-如果主题需要拓展：
+如果主题需要扩展：
 
 ```js
 // .vitepress/theme/index.js
@@ -193,7 +193,7 @@ export default {
 }
 ```
 
-如果主题需要特殊的 VitePress 配置，也需要在配置中拓展：
+如果主题需要特殊的 VitePress 配置，也需要在配置中扩展：
 
 ```ts
 // .vitepress/theme/config.ts

Diff for: docs/zh/guide/data-loading.md

@@ -21,7 +21,7 @@ export default {
 
 数据加载模块只在 Node.js 中执行，因此可以按需导入 Node API 和 npm 依赖。
 
-然后，可以在 `.md` 页面和 `.vue` 组件中使用 `data` 命名导出从该文件中导入数据：
+然后，可以在 `.md` 页面和 `.vue` 组件中使用 `data` 具名导出从该文件中导入数据：
 
 ```vue
 <script setup>
@@ -39,7 +39,7 @@ import { data } from './example.data.js'
 }
 ```
 
-你会注意到数据加载本身并没有导出 `data`。这是因为 VitePress 在后台调用了 `load()` 方法，并通过名为 `data` 的命名导出隐式地暴露了结果。
+你会注意到 data loader 本身并没有导出 `data`。这是因为 VitePress 在后台调用了 `load()` 方法，并通过名为 `data` 的具名导出隐式地暴露了结果。
 
 即使它是异步的，这也是有效的：
 
@@ -54,11 +54,11 @@ export default {
 
 ## 使用本地文件生成数据 {#data-from-local-files}
 
-当需要基于本地文件生成数据时，应该在数据加载中使用 `watch` 选项，以便这些文件改动时可以触发热更新。
+当需要基于本地文件生成数据时，需要在 data loader 中使用 `watch` 选项，以便这些文件改动时可以触发热更新。
 
 `watch` 选项也很方便，因为可以使用 [glob 模式](https://github.com/mrmlnc/fast-glob#pattern-syntax) 匹配多个文件。模式可以相对于数据加载文件本身，`load()` 函数将接收匹配文件的绝对路径。
 
-下面的例子展示了如何使用 [csv-parse](https://github.com/adaltas/node-csv/tree/master/packages/csv-parse/) 加载 CSV 文件并将其转换为 JSON。因为此文件仅在构建时执行，因此不会将 CSV 解析器发送到客户端！
+下面的例子展示了如何使用 [csv-parse](https://github.com/adaltas/node-csv/tree/master/packages/csv-parse/) 加载 CSV 文件并将其转换为 JSON。因为此文件仅在构建时执行，因此不会将 CSV 解析器发送到客户端。
 
 ```js
 import fs from 'node:fs'
@@ -68,7 +68,8 @@ export default {
   watch: ['./data/*.csv'],
   load(watchedFiles) {
     // watchFiles 是一个所匹配文件的绝对路径的数组。
-    // 生成一个博客文章元数据数组，可用于在主题布局中呈现列表。
+    // 生成一个博客文章元数据数组
+    // 可用于在主题布局中呈现列表。
     return watchedFiles.map((file) => {
       return parse(fs.readFileSync(file, 'utf-8'), {
         columns: true,
@@ -81,7 +82,7 @@ export default {
 
 ## `createContentLoader`
 
-当构建一个内容为主的站点时，我们经常需要创建一个“档案”或“索引”页面：一个我们可以列出内容中的所有可用条目的页面，例如博客文章或 API 页面。我们**可以**直接使用数据加载 API 实现这一点，但由于这是一个常见的用例，VitePress 还提供了一个 `createContentLoader` 辅助函数来简化这个过程：
+当构建一个内容为主的站点时，我们经常需要创建一个“归档”或“索引”页面：一个我们可以列出内容中的所有可用条目的页面，例如博客文章或 API 页面。我们**可以**直接使用数据加载 API 实现这一点，但由于这会经常使用，VitePress 还提供了一个 `createContentLoader` 辅助函数来简化这个过程：
 
 ```js
 // posts.data.js
@@ -112,7 +113,7 @@ interface ContentData {
 }
 ```
 
-默认情况下只提供 `url` 和 `frontmatter`。这是因为加载的数据将作为 JSON 内联在客户端包中，我们需要谨慎考虑其大小。下面的例子展示了如何使用数据构建最小的博客索引页面：
+默认情况下只提供 `url` 和 `frontmatter`。这是因为加载的数据将作为 JSON 内联在客户端 bundle 中，我们需要谨慎考虑其大小。下面的例子展示了如何使用数据构建最小的博客索引页面：
 
 ```vue
 <script setup>
@@ -212,7 +213,7 @@ interface ContentOptions<T = ContentData[]> {
 }
 ```
 
-## 为数据加载器导出类型 {#typed-data-loaders}
+## 为 data loader 导出类型 {#typed-data-loaders}
 
 当使用 TypeScript 时，可以像这样为 loader 和 `data` 导出类型：
 
@@ -237,7 +238,7 @@ export default defineLoader({
 
 ## 配置 {#configuration}
 
-要获取数据加载中的配置信息，可以使用如下代码：
+要获取 data loader 中的配置信息，可以使用如下代码：
 
 ```ts
 import type { SiteConfig } from 'vitepress'

Diff for: docs/zh/guide/deploy.md

@@ -33,7 +33,7 @@ outline: deep
    $ npm run docs:preview
    ```
 
-   `preview` 命令将启动一个本地静态 Web 服务器`http://localhost:4173`，该服务器以 `.vitepress/dist` 作为源文件。这是检查生产版本在本地环境中是否正常的一种简单方法。
+   `preview` 命令将启动一个本地静态 Web 服务 `http://localhost:4173`，该服务以 `.vitepress/dist` 作为源文件。这是检查生产版本在本地环境中是否正常的一种简单方法。
 
 3. 可以通过传递 `--port` 作为参数来配置服务器的端口。
 
@@ -45,13 +45,13 @@ outline: deep
    }
    ```
 
-   现在 `docs:preview` 方法将在 `http://localhost:8080` 启动服务器。
+   现在 `docs:preview` 方法将会在 `http://localhost:8080` 启动服务。
 
 ## 设定 public 根目录 {#setting-a-public-base-path}
 
-默认情况下，我们假设站点将部署在域名 （`/`）的根路径上。如果站点在子路径中提供服务，例如 `https://mywebsite.com/blog/`，则需要在 VitePress 配置中将 [`base`](../reference/site-config#base)选项设置为 `'/blog/'`。
+默认情况下，我们假设站点将部署在域名 (`/`) 的根路径上。如果站点在子路径中提供服务，例如 `https://mywebsite.com/blog/`，则需要在 VitePress 配置中将 [`base`](../reference/site-config#base) 选项设置为 `'/blog/'`。
 
-**例：** 如果你使用的是 Github（或 GitLab）页面并部署到 `user.github.io/repo/`，请将 `base` 设置为 `/repo/`。
+**例**：如果你使用的是 Github（或 GitLab）页面并部署到 `user.github.io/repo/`，请将 `base` 设置为 `/repo/`。
 
 ## HTTP 缓存标头 {#http-cache-headers}
 
@@ -73,7 +73,7 @@ Cache-Control: max-age=31536000,immutable
   cache-control: immutable
 ```
 
-注意：该 `_headers` 文件应放置在[public 目录](/guide/asset-handling#the-public-directory)中（在我们的例子中是 `docs/public/_headers`），以便将其逐字复制到输出目录。
+注意：该 `_headers` 文件应放置在 [public 目录](/guide/asset-handling#the-public-directory)中 (在我们的例子中是 `docs/public/_headers`)，以便将其逐字复制到输出目录。
 
 [Netlify 自定义标头文档](https://docs.netlify.com/routing/headers/)
 
@@ -127,12 +127,12 @@ Cache-Control: max-age=31536000,immutable
    name: Deploy VitePress site to Pages
 
    on:
-     # 在针对 `main` 分支的推送上运行。如果您
+     # 在针对 `main` 分支的推送上运行。如果你
      # 使用 `master` 分支作为默认分支，请将其更改为 `master`
      push:
        branches: [main]
 
-     # 允许您从 Actions 选项卡手动运行此工作流程
+     # 允许你从 Actions 选项卡手动运行此工作流程
      workflow_dispatch:
 
    # 设置 GITHUB_TOKEN 的权限，以允许部署到 GitHub Pages

Diff for: docs/zh/guide/extending-default-theme.md

@@ -214,7 +214,7 @@ export default {
   - `nav-screen-content-before`
   - `nav-screen-content-after`
 
-## Using View Transitions API
+## 使用视图过渡 API
 
 ### 关于外观切换 {#on-appearance-toggle}
 

Diff for: docs/zh/guide/markdown.md

@@ -1,6 +1,6 @@
-# Markdown 拓展 {#markdown-extensions}
+# Markdown 扩展 {#markdown-extensions}
 
-VitePress 带有内置的 Markdown 拓展。
+VitePress 带有内置的 Markdown 扩展。
 
 ## 标题锚点 {#header-anchors}
 
@@ -58,7 +58,7 @@ VitePress 带有内置的 Markdown 拓展。
 
 外部链接带有 `target="_blank" rel="noreferrer"`：
 
-- [vuejs.org](https://vuejs.org)
+- [vuejs.org](https://cn.vuejs.org)
 - [VitePress on GitHub](https://github.com/vuejs/vitepress)
 
 ## frontmatter {#frontmatter}
@@ -634,7 +634,7 @@ const line4 = 'This is line 4'
 <<< @/snippets/snippet.cs{1,2,4-6 c#:line-numbers}
 ```
 
-如果无法从文件拓展名推测出源语言，这将会很有帮助
+如果无法从文件扩展名推测出源语言，这将会很有帮助
 
 ## 代码组 {#code-groups}
 
@@ -870,7 +870,7 @@ export default {
 
 ## 高级配置 {#advanced-configuration}
 
-VitePress 使用 [markdown-it](https://github.com/markdown-it/markdown-it) 作为 Markdown 渲染器。上面提到的很多拓展功能都是通过自定义插件实现的。可以使用 `.vitepress/config.js` 中的 `markdown` 选项来进一步自定义 `markdown-it` 实例。
+VitePress 使用 [markdown-it](https://github.com/markdown-it/markdown-it) 作为 Markdown 渲染器。上面提到的很多扩展功能都是通过自定义插件实现的。可以使用 `.vitepress/config.js` 中的 `markdown` 选项来进一步自定义 `markdown-it` 实例。
 
 ```js
 import { defineConfig } from 'vitepress'

Diff for: docs/zh/guide/migration-from-vitepress-0.md

@@ -1,4 +1,4 @@
-# 从 VitePress 0.x 迁移 {#migration-from-vitepress-0-x}
+n# 从 VitePress 0.x 迁移 {#migration-from-vitepress-0-x}
 
 如果你来自 VitePress 0.x 版本，VitePress 有了一些重大更改。请按照本指南了解如何将应用程序迁移到最新的 VitePress。
 

Diff for: docs/zh/guide/mpa-mode.md

@@ -20,4 +20,4 @@ document.querySelector('h1').addEventListener('click', () => {
 
 `<script client>` 是 VitePress 独有的功能，而不是 Vue 的功能。它可以在 `.md` 和 `.vue` 文件中使用，但只能在 MPA 模式下使用。所有主题组件中的客户端脚本将被打包在一起，而特定页面的客户端脚本将会分开处理。
 
-请注意，`<script client>` **不会被视为 Vue 组件代码**：它会看做普通的 JavaScript 模块来处理。因此，只有在站点需要绝对最小的客户端交互性时，才应该使用 MPA 模式。
+请注意，`<script client>` **不会被视为 Vue 组件代码**：它将是普通的 JavaScript 模块。因此，只有在站点需要绝对最小的客户端交互性时，才应该使用 MPA 模式。