From 639dc490c864960293a78f2d83e0553955e91d38 Mon Sep 17 00:00:00 2001
From: h7ml <h7ml@qq.com>
Date: Mon, 30 Dec 2024 11:02:32 +0800
Subject: [PATCH] =?UTF-8?q?docs(zh):=20=E4=BC=98=E5=8C=96=20API=20?=
 =?UTF-8?q?=E6=96=87=E6=A1=A3=E6=A0=BC=E5=BC=8F=E5=92=8C=E5=86=85=E5=AE=B9?=
 =?UTF-8?q?=20(#2569)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* docs(zh): 优化 API 文档格式和内容

- 调整文档结构，优化标题层级
- 修正部分语法错误和排版问题
- 统一代码样式

* docs(.zh): 使用zhlint优化 API 文档格式和内容

- 调整段落间距和标点符号，提高可读性
- 统一使用冒号和空格分隔标题和内容

* docs(.zh): 更新全局挂载选项示例说明

- 在文档中明确全局模拟示例中的 $t 变量可能来自 vue-i18n

* Update index.md

---------

Co-authored-by: Jinjiang <zhaojinjiang@me.com>
---
 docs/zh/api/index.md | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/docs/zh/api/index.md b/docs/zh/api/index.md
index 93337218a..e99162693 100644
--- a/docs/zh/api/index.md
+++ b/docs/zh/api/index.md
@@ -60,7 +60,7 @@ const wrapper = mount(Component, {
 
 #### options.global
 
-组件状态中，你可以通过 [`MountingOptions.global` 配置属性](#global)配置上述 Vue 3 应用程序。这对于提供组件期望可用的模拟值非常有用。
+在组件状态中，你可以通过 [`MountingOptions.global` 配置属性](#global)配置上述 Vue 3 应用程序。这对于提供组件期望可用的模拟值非常有用。
 
 ::: tip
 如果你发现自己需要为许多测试设置共同的应用配置，则可以使用导出的 [`config` 对象](#config)为整个测试套件设置配置。
@@ -1152,7 +1152,7 @@ export default {
 </script>
 ```
 
-`Component.spec.js`
+`Component.spec.js`:
 
 ```js
 import { mount } from '@vue/test-utils'
@@ -1163,7 +1163,7 @@ import Foo from '@/Foo.vue'
 test('findComponent', () => {
   const wrapper = mount(Component)
 
-  // All the following queries would return a VueWrapper
+  // 所有以下查询将返回一个 VueWrapper
 
   wrapper.findComponent('.foo')
   wrapper.findComponent('[data-test="foo"]')
@@ -1257,7 +1257,7 @@ import Component from './Component.vue'
 test('findAllComponents', () => {
   const wrapper = mount(Component)
 
-  // Returns an array of VueWrapper
+  // 返回一个 VueWrapper 数组
   wrapper.findAllComponents('[data-test="number"]')
 })
 ```
@@ -1363,7 +1363,7 @@ export default {
 </script>
 ```
 
-`Component.spec.js`
+`Component.spec.js`:
 
 ```js
 import { mount } from '@vue/test-utils'
@@ -1602,7 +1602,7 @@ export default {
 </script>
 ```
 
-`Component.spec.js`
+`Component.spec.js`:
 
 ```js
 import { mount } from '@vue/test-utils'
@@ -1852,7 +1852,7 @@ test('unmount', () => {
 })
 ```
 
-## Wrapper properties
+## Wrapper 属性
 
 ### vm
 
@@ -1954,7 +1954,7 @@ type GlobalMountOptions = {
 
 你可以选择在整个测试套件中配置挂载选项，而不是在每个测试中单独配置。这些配置将在每次 `mount` 组件时默认使用。如果需要，你可以在每个测试中覆盖这些默认设置。
 
-**Example :**
+**示例：**
 
 全局模拟来可能是自 vue-i18n 的 `$t` 变量和一个组件：
 
@@ -2014,9 +2014,9 @@ test('config.global mocks and stubs', () => {
 
 你可以使用此组件在渲染树中查找 `router-link` 组件。
 
-**Usage:**
+**用法：**
 
-在挂载选项中设置为替换组件 (stub)：
+在挂载选项中设置为替代组件：
 
 ```js
 import { mount, RouterLinkStub } from '@vue/test-utils'