From f6c879d95f86a674b2bacb5a9d3cce1ee891053c Mon Sep 17 00:00:00 2001
From: liangzhensheng <1250564179@qq.com>
Date: Sun, 29 Jan 2023 13:06:20 +0800
Subject: [PATCH 01/11] docs: add zh-cn guide

---
 docs/.vitepress/locales/zh-cn.ts        | 13 +++++++++++++
 docs/zh-CN/guide/bundler-integration.md | 14 ++++++-------
 docs/zh-CN/guide/configurations.md      |  8 ++++----
 docs/zh-CN/guide/getting-started.md     | 26 ++++++++++++-------------
 docs/zh-CN/guide/nuxt-integration.md    | 10 +++++-----
 docs/zh-CN/macros/index.md              | 24 +++++++++++------------
 6 files changed, 54 insertions(+), 41 deletions(-)

diff --git a/docs/.vitepress/locales/zh-cn.ts b/docs/.vitepress/locales/zh-cn.ts
index 3ec9d7efd..f1955e7d0 100644
--- a/docs/.vitepress/locales/zh-cn.ts
+++ b/docs/.vitepress/locales/zh-cn.ts
@@ -12,6 +12,19 @@ export const nav: DefaultTheme.NavItem[] = [
 
 export const sidebar = common.sidebar('zh-CN')
 
+const sidebarTitle: string[] = ['指南', '宏', '特性']
+const sidebarItem: string[][] = [
+  ['入门', '打包器整合', 'Nuxt 整合', '配置'],
+  [''],
+  [''],
+]
+sidebar.forEach((bar, i) => {
+  bar.text = sidebarTitle[i]
+  bar.items.forEach((item, j) => {
+    if (sidebarItem[i][j]) item.text = sidebarItem[i][j]
+  })
+})
+
 export const themeConfig: DefaultTheme.Config = {
   ...common.themeConfig,
 
diff --git a/docs/zh-CN/guide/bundler-integration.md b/docs/zh-CN/guide/bundler-integration.md
index 1a9b553a7..b0b5a16e0 100644
--- a/docs/zh-CN/guide/bundler-integration.md
+++ b/docs/zh-CN/guide/bundler-integration.md
@@ -1,6 +1,6 @@
-# Bundler Integration
+# 打包器整合
 
-### Installation
+### 安装
 
 ::: code-group
 
@@ -96,7 +96,7 @@ module.exports = defineConfig({
 
 :::
 
-## TypeScript Support
+## TypeScript 支持
 
 ::: code-group
 
@@ -122,9 +122,9 @@ module.exports = defineConfig({
 
 :::
 
-## Volar Support
+## Volar 支持
 
-For detailed configuration, please refer to the description of the specific macro.
+详细配置请参考每个宏的具体说明。
 
 ```bash
 npm i -D @vue-macros/volar
@@ -147,6 +147,6 @@ npm i -D @vue-macros/volar
 }
 ```
 
-:tada: Congratulations! You have successfully set up `unplugin-vue-macros`.
+:tada: 祝贺你! 你已经成功设置完成 `unplugin-vue-macros`.
 
-To learn more about the macros, please visit [All Macros](/macros/) :laughing:.
+想要了解有关宏的更多信息, 请访问 [全部宏](/zh-CN/macros/) :laughing:.
diff --git a/docs/zh-CN/guide/configurations.md b/docs/zh-CN/guide/configurations.md
index ac601af36..1a1f14614 100644
--- a/docs/zh-CN/guide/configurations.md
+++ b/docs/zh-CN/guide/configurations.md
@@ -1,8 +1,8 @@
-# Configurations
+# 配置
 
-## Plugin Options
+## 插件选项
 
-All features are enabled by default, you can disable them by setting the option to `false`.
+所有功能将会被默认开启, 您可以将选项设置为 `false` 来禁用它们。
 
 ```ts
 VueMacros({
@@ -37,4 +37,4 @@ VueMacros({
 })
 ```
 
-See the features page for options for each feature.
+有关每个功能的选项，请参考功能页面。
diff --git a/docs/zh-CN/guide/getting-started.md b/docs/zh-CN/guide/getting-started.md
index 6db62e001..cf9c7e767 100644
--- a/docs/zh-CN/guide/getting-started.md
+++ b/docs/zh-CN/guide/getting-started.md
@@ -1,29 +1,29 @@
-# Getting Started
+# 入门
 
-Vue Macros is a library that implements proposals or ideas that have not been officially implemented by Vue. That means it will explore and extend more features and syntax sugar to Vue.
+Vue Macros 是一个库，用于实现尚未被 Vue 正式实现的提案或想法。这意味着它将探索和扩展 Vue 的更多功能和语法糖。
 
-We assume you are already familiar with the basic usages of Vue before you continue.
+在继续之前，我们假设您已经熟悉 Vue 的基本用法。
 
-## Requirements
+## 要求
 
 - Vue >= 2.7 or Vue >= 3.0.
-  - Some features need Vue >= 3.2.25.
-- VSCode with [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) extension.
-  - ❌ WebStorm is not supported.
+  - 某些功能需要 Vue >= 3.2.25
+- VSCode 安装了 [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) 扩展.
+  - ❌ 不支持 WebStorm
 
-## Demos
+## 示例
 
 - [Vite + Vue 3](https://github.com/sxzz/unplugin-vue-macros/tree/main/playground/vue3)
 - [Vite + Vue 2](https://github.com/sxzz/unplugin-vue-macros/tree/main/playground/vue2)
 - [Nuxt 3 + Vue 3](https://github.com/vue-macros/nuxt)
 - [Vue CLI + Vue 2](https://github.com/vue-macros/vue2-vue-cli)
 
-🌟 More demos are welcome!
+🌟 欢迎提供更多示例！
 
-## Nuxt Integration
+## Nuxt 整合
 
-If you're using [Nuxt 3](https://nuxt.com/), read the [Nuxt Integration](./nuxt-integration.md).
+如果您使用的是 [Nuxt 3](https://nuxt.com/), 请阅读 [Nuxt 整合](./nuxt-integration.md).
 
-## Bundler Integrations
+## 打包器整合
 
-If you're using [Vite](https://vitejs.dev/), [Rollup](https://rollupjs.org/), [esbuild](https://esbuild.github.io/), or [Webpack](https://webpack.js.org/), read the [Bundler Integration](./bundler-integration.md).
+如果您使用的是 [Vite](https://vitejs.dev/), [Rollup](https://rollupjs.org/), [esbuild](https://esbuild.github.io/), 或 [Webpack](https://webpack.js.org/)这一类的打包工具, 请阅读 [打包器整合](./bundler-integration.md).
diff --git a/docs/zh-CN/guide/nuxt-integration.md b/docs/zh-CN/guide/nuxt-integration.md
index 4e60bf0c3..a44d75af5 100644
--- a/docs/zh-CN/guide/nuxt-integration.md
+++ b/docs/zh-CN/guide/nuxt-integration.md
@@ -1,6 +1,6 @@
-# Nuxt Integration
+# Nuxt 整合
 
-### Installation
+### 安装
 
 ::: code-group
 
@@ -18,7 +18,7 @@ pnpm add -D @vue-macros/nuxt
 
 :::
 
-## Configuration
+## 配置
 
 ```ts
 // nuxt.config.ts
@@ -33,6 +33,6 @@ export default {
 }
 ```
 
-:tada: Congratulations! That's all.
+:tada: 祝贺你! 成功完成了 Nuxt 整合.
 
-To learn more about the macros, please visit [All Macros](/macros/) :laughing:.
+想要了解有关宏的更多信息, 请访问 [全部宏](/zh-CN/macros/) :laughing:.
diff --git a/docs/zh-CN/macros/index.md b/docs/zh-CN/macros/index.md
index 5a69f305b..7cc6ca97c 100644
--- a/docs/zh-CN/macros/index.md
+++ b/docs/zh-CN/macros/index.md
@@ -1,15 +1,15 @@
-# Usage
+# 用法
 
-List of all available macros.
+所有可用宏的列表。
 
-Please make sure `unplugin-vue-macros` is set up correctly. If you haven't yet, read [Getting Started](/guide/getting-started) first.
+请确保 `unplugin-vue-macros` 设置正确。如果您还没有设置, 请先阅读 [入门](/zh-CN/guide/getting-started)
 
-- [defineOptions](/macros/define-options)
-- [defineModel](/macros/define-model)
-- [defineProps](/macros/define-props)
-- [defineSlots](/macros/define-slots)
-- [defineRender](/macros/define-render)
-- [shortEmits](/macros/short-emits)
-- [shortVmodel](/macros/short-vmodel)
-- [setupComponent](/macros/setup-component) <WarnBadge>Experimental</WarnBadge>
-- [setupSFC](/macros/setup-sfc) <WarnBadge>Experimental</WarnBadge>
+- [defineOptions](/zh-CN/macros/define-options)
+- [defineModel](/zh-CN/macros/define-model)
+- [defineProps](/zh-CN/macros/define-props)
+- [defineSlots](/zh-CN/macros/define-slots)
+- [defineRender](/zh-CN/macros/define-render)
+- [shortEmits](/zh-CN/macros/short-emits)
+- [shortVmodel](/zh-CN/macros/short-vmodel)
+- [setupComponent](/zh-CN/macros/setup-component) <WarnBadge>实验性</WarnBadge>
+- [setupSFC](/zh-CN/macros/setup-sfc) <WarnBadge>实验性</WarnBadge>

From d597a684096ee79f6e5b4d886df9b6ae8052c6ce Mon Sep 17 00:00:00 2001
From: liangzhensheng <1250564179@qq.com>
Date: Sun, 29 Jan 2023 15:29:59 +0800
Subject: [PATCH 02/11] docs: add zh-cn macros

---
 docs/.vitepress/locales/zh-cn.ts        |  2 +-
 docs/zh-CN/guide/bundler-integration.md |  4 ++--
 docs/zh-CN/guide/configurations.md      |  2 +-
 docs/zh-CN/guide/getting-started.md     |  8 +++----
 docs/zh-CN/guide/nuxt-integration.md    |  4 ++--
 docs/zh-CN/macros/define-model.md       | 22 +++++++++---------
 docs/zh-CN/macros/define-options.md     | 18 +++++++--------
 docs/zh-CN/macros/define-props-refs.md  | 10 ++++-----
 docs/zh-CN/macros/define-props.md       | 14 ++++++------
 docs/zh-CN/macros/define-render.md      |  8 +++----
 docs/zh-CN/macros/define-slots.md       | 22 +++++++++---------
 docs/zh-CN/macros/setup-component.md    | 24 +++++++++++---------
 docs/zh-CN/macros/setup-sfc.md          | 20 +++++++++--------
 docs/zh-CN/macros/short-emits.md        | 10 ++++-----
 docs/zh-CN/macros/short-vmodel.md       | 30 ++++++++++++-------------
 15 files changed, 101 insertions(+), 97 deletions(-)

diff --git a/docs/.vitepress/locales/zh-cn.ts b/docs/.vitepress/locales/zh-cn.ts
index f1955e7d0..e56e6e15c 100644
--- a/docs/.vitepress/locales/zh-cn.ts
+++ b/docs/.vitepress/locales/zh-cn.ts
@@ -15,7 +15,7 @@ export const sidebar = common.sidebar('zh-CN')
 const sidebarTitle: string[] = ['指南', '宏', '特性']
 const sidebarItem: string[][] = [
   ['入门', '打包器整合', 'Nuxt 整合', '配置'],
-  [''],
+  ['全部宏'],
   [''],
 ]
 sidebar.forEach((bar, i) => {
diff --git a/docs/zh-CN/guide/bundler-integration.md b/docs/zh-CN/guide/bundler-integration.md
index b0b5a16e0..747d9b9da 100644
--- a/docs/zh-CN/guide/bundler-integration.md
+++ b/docs/zh-CN/guide/bundler-integration.md
@@ -147,6 +147,6 @@ npm i -D @vue-macros/volar
 }
 ```
 
-:tada: 祝贺你! 你已经成功设置完成 `unplugin-vue-macros`.
+:tada: 祝贺你! 你已经成功设置完成 `unplugin-vue-macros`。
 
-想要了解有关宏的更多信息, 请访问 [全部宏](/zh-CN/macros/) :laughing:.
+想要了解有关宏的更多信息, 请访问 [全部宏](/zh-CN/macros/) :laughing:。
diff --git a/docs/zh-CN/guide/configurations.md b/docs/zh-CN/guide/configurations.md
index 1a1f14614..f626beb76 100644
--- a/docs/zh-CN/guide/configurations.md
+++ b/docs/zh-CN/guide/configurations.md
@@ -2,7 +2,7 @@
 
 ## 插件选项
 
-所有功能将会被默认开启, 您可以将选项设置为 `false` 来禁用它们。
+所有功能将会被默认开启，您可以将选项设置为 `false` 来禁用它们。
 
 ```ts
 VueMacros({
diff --git a/docs/zh-CN/guide/getting-started.md b/docs/zh-CN/guide/getting-started.md
index cf9c7e767..5ccfdccfa 100644
--- a/docs/zh-CN/guide/getting-started.md
+++ b/docs/zh-CN/guide/getting-started.md
@@ -6,9 +6,9 @@ Vue Macros 是一个库，用于实现尚未被 Vue 正式实现的提案或想
 
 ## 要求
 
-- Vue >= 2.7 or Vue >= 3.0.
+- Vue >= 2.7 or Vue >= 3.0
   - 某些功能需要 Vue >= 3.2.25
-- VSCode 安装了 [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) 扩展.
+- VSCode 安装了 [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) 扩展
   - ❌ 不支持 WebStorm
 
 ## 示例
@@ -22,8 +22,8 @@ Vue Macros 是一个库，用于实现尚未被 Vue 正式实现的提案或想
 
 ## Nuxt 整合
 
-如果您使用的是 [Nuxt 3](https://nuxt.com/), 请阅读 [Nuxt 整合](./nuxt-integration.md).
+如果您使用的是 [Nuxt 3](https://nuxt.com/)，请阅读 [Nuxt 整合](./nuxt-integration.md)。
 
 ## 打包器整合
 
-如果您使用的是 [Vite](https://vitejs.dev/), [Rollup](https://rollupjs.org/), [esbuild](https://esbuild.github.io/), 或 [Webpack](https://webpack.js.org/)这一类的打包工具, 请阅读 [打包器整合](./bundler-integration.md).
+如果您使用的是 [Vite](https://vitejs.dev/)，[Rollup](https://rollupjs.org/)，[esbuild](https://esbuild.github.io/)，或 [Webpack](https://webpack.js.org/)这一类的打包工具，请阅读 [打包器整合](./bundler-integration.md)。
diff --git a/docs/zh-CN/guide/nuxt-integration.md b/docs/zh-CN/guide/nuxt-integration.md
index a44d75af5..1f02bc972 100644
--- a/docs/zh-CN/guide/nuxt-integration.md
+++ b/docs/zh-CN/guide/nuxt-integration.md
@@ -33,6 +33,6 @@ export default {
 }
 ```
 
-:tada: 祝贺你! 成功完成了 Nuxt 整合.
+:tada: 祝贺你! 成功完成了 Nuxt 整合。
 
-想要了解有关宏的更多信息, 请访问 [全部宏](/zh-CN/macros/) :laughing:.
+想要了解有关宏的更多信息, 请访问 [全部宏](/zh-CN/macros/) :laughing:。
diff --git a/docs/zh-CN/macros/define-model.md b/docs/zh-CN/macros/define-model.md
index bd1f400cd..4103ec66b 100644
--- a/docs/zh-CN/macros/define-model.md
+++ b/docs/zh-CN/macros/define-model.md
@@ -1,17 +1,17 @@
 # defineModel
 
-<small>Stability: <code class="!text-green-600">stable</code></small>
+<small>稳定性: <code class="!text-green-600">稳定</code></small>
 
-Declaring and mutate `v-model` props as the same as normal variable using the `defineModel`.
+使用 `defineModel`声明和改变 `v-model` 的 props 和普通变量相同。
 
-|   Features   |     Supported      |
+|     特性     |        支持        |
 | :----------: | :----------------: |
 |    Vue 3     | :white_check_mark: |
 |    Nuxt 3    | :white_check_mark: |
 |    Vue 2     | :white_check_mark: |
 | Volar Plugin | :white_check_mark: |
 
-## Options
+## 选项
 
 ```ts
 VueMacros({
@@ -26,9 +26,9 @@ VueMacros({
 })
 ```
 
-## Usage
+## 用法
 
-Requires [`@vueuse/core`](https://www.npmjs.com/package/@vueuse/core), install it by yourself before using.
+需要 [`@vueuse/core`](https://www.npmjs.com/package/@vueuse/core)，在使用之前请自行安装
 
 ```vue
 <script setup lang="ts">
@@ -42,7 +42,7 @@ modelValue.value = 'newValue'
 </script>
 ```
 
-::: warning ❌ Object declaring is not supported.
+::: warning ❌ 不支持对象声明
 
 ```vue
 <script setup lang="ts">
@@ -54,15 +54,15 @@ const { modelValue } = defineModel({
 
 :::
 
-## With Reactivity Transform
+## 响应性语法糖
 
 ::: warning
 
-Assignment expression is only supported in `<script setup>` block. In other words invalid in `<template>`.
+赋值表达式 仅在 `<script setup>` 块中受支持。换句话说，在 `<template>`中无效。
 
 :::
 
-[`@vueuse/core`](https://www.npmjs.com/package/@vueuse/core) is not required.
+[`@vueuse/core`](https://www.npmjs.com/package/@vueuse/core) 不是必需的。
 
 ```vue {7-9}
 <script setup lang="ts">
@@ -99,7 +99,7 @@ emit('update:count', count + 1)
 
 :::
 
-## Volar Configuration
+## Volar 配置
 
 ```jsonc {6,9-12}
 // tsconfig.json
diff --git a/docs/zh-CN/macros/define-options.md b/docs/zh-CN/macros/define-options.md
index d9033662e..117a129a5 100644
--- a/docs/zh-CN/macros/define-options.md
+++ b/docs/zh-CN/macros/define-options.md
@@ -1,23 +1,23 @@
 # defineOptions
 
-<small>Stability: <code class="!text-green-600">stable</code></small>
+<small>稳定性: <code class="!text-green-600">稳定</code></small>
 
-Options API can be declared using the `defineOptions` in `<script setup>`, specifically to be able to set `name`, `props`, `emits`, and `render` inside of one function.
+可以使用 `defineOptions`函数在 `<script setup>`中使用选项式 API，特别是能够在一个函数内设置`name`, `props`, `emits`, `render` 。
 
-If you support this feature, feel free to hit like :+1: or comment on the [RFC Discussion](https://github.com/vuejs/rfcs/discussions/430). Thanks!
+如果您支持此功能, 请随意点击 :+1: 或在 [RFC 讨论](https://github.com/vuejs/rfcs/discussions/430)中发表评论。谢谢！
 
-|  Features  |     Supported      |
+|    特性    |        支持        |
 | :--------: | :----------------: |
 |   Vue 3    | :white_check_mark: |
 |   Nuxt 3   | :white_check_mark: |
 |   Vue 2    | :white_check_mark: |
 | TypeScript | :white_check_mark: |
 
-## Installation Standalone Version
+## 安装独立版本
 
-if you need `defineOptions` feature only, the standalone version is more appropriate for you.
+如果您只需要 `defineOptions` 功能, 独立版本更适合您。
 
-### Installation
+### 安装
 
 ::: code-group
 
@@ -74,7 +74,7 @@ module.exports = {
 
 :::
 
-### TypeScript Support
+### TypeScript 支持
 
 ```json
 // tsconfig.json
@@ -86,7 +86,7 @@ module.exports = {
 }
 ```
 
-## Basic Usage
+## 基本用法
 
 ```vue {3-6}
 <script setup lang="ts">
diff --git a/docs/zh-CN/macros/define-props-refs.md b/docs/zh-CN/macros/define-props-refs.md
index 8957a2f9c..0d21ba192 100644
--- a/docs/zh-CN/macros/define-props-refs.md
+++ b/docs/zh-CN/macros/define-props-refs.md
@@ -1,19 +1,19 @@
 # definePropsRefs
 
-<small>Stability: <code class="!text-yellow-600">unstable</code></small>
+<small>稳定性: <code class="!text-yellow-600">不稳定</code></small>
 
-Returns refs from `defineProps` instead of a reactive object. It can be destructured without losing reactivity.
+从 `defineProps` 返回的 refs 不是响应式对象，它可以在不失去响应式的情况下被解构。
 
 `toRefs(defineProps())` => `definePropsRefs()`
 
-|         Features          |     Supported      |
+|           特性            |        支持        |
 | :-----------------------: | :----------------: |
 |           Vue 3           | :white_check_mark: |
 |          Nuxt 3           | :white_check_mark: |
 |           Vue 2           | :white_check_mark: |
 | TypeScript / Volar Plugin | :white_check_mark: |
 
-## Basic Usage
+## 基本用法
 
 ```vue {2-3,8}
 <script setup lang="ts">
@@ -27,7 +27,7 @@ console.log(foo.value, bar.value)
 </script>
 ```
 
-## Volar Configuration
+## Volar 配置
 
 ```jsonc {6}
 // tsconfig.json
diff --git a/docs/zh-CN/macros/define-props.md b/docs/zh-CN/macros/define-props.md
index 610f63fc3..52434738d 100644
--- a/docs/zh-CN/macros/define-props.md
+++ b/docs/zh-CN/macros/define-props.md
@@ -1,12 +1,12 @@
 # defineProps
 
-<small>Stability: <code class="!text-green-600">stable</code></small>
+<small>稳定性: <code class="!text-green-600">稳定</code></small>
 
-Correct types of destructured props using `$defineProps`.
+使用 `$defineProps` 正确的解构 props 类型
 
-See also [Vue issue](https://github.com/vuejs/core/issues/6876), [Reactivity Transform RFC](https://github.com/vuejs/rfcs/blob/reactivity-transform/active-rfcs/0000-reactivity-transform.md#defineprops-destructure-details).
+参见 [Vue issue](https://github.com/vuejs/core/issues/6876), [Reactivity Transform RFC](https://github.com/vuejs/rfcs/blob/reactivity-transform/active-rfcs/0000-reactivity-transform.md#defineprops-destructure-details).
 
-|         Features          |     Supported      |
+|           特性            |        支持        |
 | :-----------------------: | :----------------: |
 |           Vue 3           | :white_check_mark: |
 |          Nuxt 3           | :white_check_mark: |
@@ -15,11 +15,11 @@ See also [Vue issue](https://github.com/vuejs/core/issues/6876), [Reactivity Tra
 
 ::: warning
 
-[Reactivity Transform](https://vuejs.org/guide/extras/reactivity-transform.html) is required. You should enable it first.
+[响应性语法糖](https://cn.vuejs.org/guide/extras/reactivity-transform.html) 是必须的。你必须先开启它。
 
 :::
 
-## Basic Usage
+## 基本用法
 
 ```vue
 <script setup lang="ts">
@@ -33,7 +33,7 @@ const fooRef = $$(foo)
 </script>
 ```
 
-## Volar Configuration
+## Volar 配置
 
 ```jsonc {6}
 // tsconfig.json
diff --git a/docs/zh-CN/macros/define-render.md b/docs/zh-CN/macros/define-render.md
index ee96c3919..b0fd84569 100644
--- a/docs/zh-CN/macros/define-render.md
+++ b/docs/zh-CN/macros/define-render.md
@@ -1,17 +1,17 @@
 # defineRender
 
-<small>Stability: <code class="!text-green-600">stable</code></small>
+<small>稳定性: <code class="!text-green-600">稳定</code></small>
 
-Defining render function in `<script setup>` using the `defineRender`.
+使用 `defineRender` 在 `<script setup>` 中定义渲染函数。
 
-|  Features  |     Supported      |
+|    特性    |        支持        |
 | :--------: | :----------------: |
 |   Vue 3    | :white_check_mark: |
 |   Nuxt 3   | :white_check_mark: |
 |   Vue 2    | :white_check_mark: |
 | TypeScript | :white_check_mark: |
 
-## Basic Usage
+## 基本用法
 
 ```vue
 <script setup lang="tsx">
diff --git a/docs/zh-CN/macros/define-slots.md b/docs/zh-CN/macros/define-slots.md
index d857053eb..b126c31f3 100644
--- a/docs/zh-CN/macros/define-slots.md
+++ b/docs/zh-CN/macros/define-slots.md
@@ -1,18 +1,18 @@
 # defineSlots
 
-<small>Stability: <code class="!text-yellow-600">unstable</code></small>
+<small>稳定性: <code class="!text-yellow-600">不稳定</code></small>
 
-Declaring type of SFC slots in `<script setup>` using the `defineSlots`.
+使用 `defineSlots` 在 `<script setup>` 中声明 SFC slots 的类型
 
-|       Features       |              Supported              |
-| :------------------: | :---------------------------------: |
-|        Vue 3         |         :white_check_mark:          |
-|        Nuxt 3        |         :white_check_mark:          |
-|        Vue 2         |         :white_check_mark:          |
-| Volar Plugin + Vue 3 |         :white_check_mark:          |
-| Volar Plugin + Vue 2 | :x: (Volar does not support it yet) |
+|         特性         |         支持         |
+| :------------------: | :------------------: |
+|        Vue 3         |  :white_check_mark:  |
+|        Nuxt 3        |  :white_check_mark:  |
+|        Vue 2         |  :white_check_mark:  |
+| Volar Plugin + Vue 3 |  :white_check_mark:  |
+| Volar Plugin + Vue 2 | :x: (Volar 还不支持) |
 
-## Basic Usage
+## 基本用法
 
 ```vue
 <script setup lang="ts">
@@ -26,7 +26,7 @@ defineSlots<{
 </script>
 ```
 
-## Volar Configuration
+## Volar 配置
 
 ```jsonc {6}
 // tsconfig.json
diff --git a/docs/zh-CN/macros/setup-component.md b/docs/zh-CN/macros/setup-component.md
index a6c7ae244..a931345cd 100644
--- a/docs/zh-CN/macros/setup-component.md
+++ b/docs/zh-CN/macros/setup-component.md
@@ -1,28 +1,30 @@
 # setupComponent
 
 <small mr-2>
-  Stability: <code class="!text-red-600">experimental</code>
+  稳定性: <code class="!text-red-600">实验性</code>
 </small>
-<WarnBadge>Experimental, use at your risk</WarnBadge>
+<WarnBadge>实验性功能，风险自负</WarnBadge>
 
 ::: tip
 
-If you're using `setupComponent`, then `defineRender` cannot be disabled.
+如果您使用的是 `setupComponent`，则无法禁用 `defineRender`。
 
-Files in `node_modules` will not be ignored by default.
+默认情况下不会忽略 `node_modules` 中的文件。
 
 :::
 
-With `defineSetupComponent`, `<script setup>` code can be put in **pure JS/TS(X)** without [Volar](https://github.com/johnsoncodehk/volar) extension.
+<!-- defineSetupComponent，<script setup>  [Volar](https://github.com/johnsoncodehk/volar) 的纯 JS/TS(X) 中 -->
 
-|  Features  |     Supported      |
+使用 `defineSetupComponent`, `<script setup>` 的代码可以放在没有 [Volar](https://github.com/johnsoncodehk/volar) 扩展的 **纯 JS/TS(X)** 中。
+
+|    特性    |        支持        |
 | :--------: | :----------------: |
 |   Vue 3    | :white_check_mark: |
 |   Nuxt 3   |        :x:         |
 |   Vue 2    |        :x:         |
 | TypeScript |        :x:         |
 
-## Basic Usage
+## 基本用法
 
 ```ts
 export const App = defineSetupComponent(() => {
@@ -42,7 +44,7 @@ export const App = defineSetupComponent(() => {
 })
 ```
 
-## Type Annotation
+## 类型注解
 
 ```ts
 export const App: SetupFC = () => {
@@ -60,7 +62,7 @@ export const App: SetupFC = () => {
 }
 ```
 
-## Known Issues
+## 已知的问题
 
-- TypeScript support is not yet completed.
-- The source map does not correspond properly.
+- TypeScript 支持尚未完成。
+- Source map 不能正确对应。
diff --git a/docs/zh-CN/macros/setup-sfc.md b/docs/zh-CN/macros/setup-sfc.md
index b293841a1..7076aacc4 100644
--- a/docs/zh-CN/macros/setup-sfc.md
+++ b/docs/zh-CN/macros/setup-sfc.md
@@ -1,24 +1,24 @@
 # setupSFC
 
 <small mr-2>
-  Stability: <code class="!text-red-600">experimental</code>
+  稳定性: <code class="!text-red-600">实验性</code>
 </small>
-<WarnBadge>Experimental, use at your risk</WarnBadge>
+<WarnBadge>实验性功能，风险自负</WarnBadge>
 
 ::: tip
 
-If you're using `setupSFC`, then `defineRender` cannot be disabled.
+如果您使用的是 `setupSFC`，则无法禁用 `defineRender`。
 
 :::
 
-|      Features      |     Supported      |
+|        特性        |        支持        |
 | :----------------: | :----------------: |
 |       Vue 3        | :white_check_mark: |
 |       Nuxt 3       |        :x:         |
 |       Vue 2        | :white_check_mark: |
 | TypeScript / Volar |        :x:         |
 
-## Setup
+## 安装
 
 ::: code-group
 
@@ -66,7 +66,7 @@ export default defineConfig({
 
 :::
 
-## Basic Usage
+## 基本用法
 
 ```tsx
 // Foo.setup.tsx
@@ -85,7 +85,9 @@ export default () => (
 )
 ```
 
-## Known Issues
+## 已知的问题
 
-- The source map does not correspond properly in JSX/TSX files.
-- TypeScript support is not yet completed.
+源映射在 JSX/TSX 文件中不正确对应
+
+- Source map 在 JSX/TSX 文件中不能正确的对应。
+- TypeScript 支持尚未完成。
diff --git a/docs/zh-CN/macros/short-emits.md b/docs/zh-CN/macros/short-emits.md
index 6d5f093b3..6ca22c7cf 100644
--- a/docs/zh-CN/macros/short-emits.md
+++ b/docs/zh-CN/macros/short-emits.md
@@ -1,18 +1,18 @@
 # shortEmits
 
-<small>Stability: <code class="!text-green-600">stable</code></small>
+<small>稳定性: <code class="!text-green-600">稳定</code></small>
 
-Simplify the definition of emits.
+简化 emits 的定义
 
-|  Features  |     Supported      |
+|    特性    |        功能        |
 | :--------: | :----------------: |
 |   Vue 3    | :white_check_mark: |
 |   Vue 2    | :white_check_mark: |
 | TypeScript | :white_check_mark: |
 
-## Basic Usage
+## 基本用法
 
-Using type `ShortEmits` or for short `SE`.
+使用类型 `ShortEmits` 或简称 `SE`.
 
 ```vue
 <script setup lang="ts">
diff --git a/docs/zh-CN/macros/short-vmodel.md b/docs/zh-CN/macros/short-vmodel.md
index 74d776fca..301ca3c41 100644
--- a/docs/zh-CN/macros/short-vmodel.md
+++ b/docs/zh-CN/macros/short-vmodel.md
@@ -1,29 +1,29 @@
 # shortVmodel
 
-<small>Stability: <code class="!text-green-600">stable</code></small>
+<small>稳定性: <code class="!text-green-600">稳定</code></small>
 
-A shorthand for `v-model`.
+`v-model`的语法糖.
 
 `v-model` -> `::` / `$` / `*`
 
-If you have any questions about this feature, you can comment on [RFC Discussion](https://github.com/vuejs/rfcs/discussions/395).
+如果您对此功能有任何疑问，可以在 [RFC 讨论](https://github.com/vuejs/rfcs/discussions/395) 中发表评论。
 
-|   Features   |     Supported      |
+|     特性     |        支持        |
 | :----------: | :----------------: |
 |    Vue 3     | :white_check_mark: |
 |    Nuxt 3    | :white_check_mark: |
 |    Vue 2     |        :x:         |
 | Volar Plugin | :white_check_mark: |
 
-## Setup
+## 设置
 
-### Installation
+### 安装
 
 ```bash
 npm i @vue-macros/short-vmodel
 ```
 
-### Vite Integration
+### Vite 整合
 
 ```ts {9-17}
 // vite.config.ts
@@ -48,13 +48,13 @@ export default defineConfig({
 })
 ```
 
-## Options
+## 选项
 
 `prefix`: `'::' | '$' | '*'`, defaults to `'$'`
 
-## Usage
+## 用法
 
-### `$` Dollar Sign (Default)
+### `$` 美元符号 (默认)
 
 ```vue
 <template>
@@ -65,7 +65,7 @@ export default defineConfig({
 </template>
 ```
 
-### `::` Double Binding
+### `::` 双引号
 
 ```vue
 <template>
@@ -77,7 +77,7 @@ export default defineConfig({
 </template>
 ```
 
-### `*` Asterisk Sign
+### `*` 星号
 
 ```vue
 <template>
@@ -88,7 +88,7 @@ export default defineConfig({
 </template>
 ```
 
-## Volar Configuration
+## Volar 配置
 
 ```jsonc {5,9}
 // tsconfig.json
@@ -106,6 +106,6 @@ export default defineConfig({
 }
 ```
 
-## Known Issues
+## 已知的问题
 
-- Prettier will format `::=` to `:=`, prettier-ignore is required if prefix is `::`.
+- Prettier 会将 `::=` 格式化为 `:=`，如果 prefix 为 `::`，则需要 prettier-ignore

From 97371161a55e0c345e79b84f3ac846798a1d019a Mon Sep 17 00:00:00 2001
From: liangzhensheng <1250564179@qq.com>
Date: Sun, 29 Jan 2023 16:21:29 +0800
Subject: [PATCH 03/11] docs: add zh-cn features

---
 docs/zh-CN/features/better-define.md        | 34 ++++++++++-----------
 docs/zh-CN/features/export-props.md         | 11 ++++---
 docs/zh-CN/features/hoist-static.md         | 20 ++++++------
 docs/zh-CN/features/named-template.md       | 20 ++++++------
 docs/zh-CN/features/reactivity-transform.md | 16 +++++-----
 5 files changed, 51 insertions(+), 50 deletions(-)

diff --git a/docs/zh-CN/features/better-define.md b/docs/zh-CN/features/better-define.md
index 99608743e..99d84b686 100644
--- a/docs/zh-CN/features/better-define.md
+++ b/docs/zh-CN/features/better-define.md
@@ -1,19 +1,19 @@
 # betterDefine
 
-<small>Stability: <code class="!text-green-600">stable</code></small>
+<small>稳定性: <code class="!text-green-600">稳定</code></small>
 
-With enabling `betterDefine`, imported types are supported in `<script setup>` type-based-macros.
+通过启用 `betterDefine` ，`<script setup>` type-based-macros 支持导入的类型。
 
-[Related issue](https://github.com/vuejs/core/issues/4294)
+[相关问题](https://github.com/vuejs/core/issues/4294)
 
-|  Features  |     Supported      |
+|    特性    |        支持        |
 | :--------: | :----------------: |
 |   Vue 3    | :white_check_mark: |
 |   Nuxt 3   | :white_check_mark: |
 |   Vue 2    | :white_check_mark: |
 | TypeScript | :white_check_mark: |
 
-## Basic Usage
+## 基本用法
 
 ::: code-group
 
@@ -36,29 +36,29 @@ export interface BaseProps {
 
 :::
 
-## ⚠️ Limitations
+## ⚠️ 限制
 
-### Complex types
+### 复杂类型
 
-Complex types are not supported in some key places. For example:
+在一些 key 的位置不支持复杂类型。例如：
 
-#### What are Complex Types?
+#### 什么是复杂类型？
 
-- All utility types
-  - [Built-in types](https://www.typescriptlang.org/docs/handbook/utility-types.html)
-  - All types from `type-fest` package.
+- 所有实用类型
+  - [内置类型](https://www.typescriptlang.org/docs/handbook/utility-types.html)
+  - 来自 `type-fest` 包的所有类型。
   - ...
-- Index Signature
+- 索引签名
   ```ts
   interface Type {
     [key: string]: string
   }
   ```
-- Generics will be ignored directly
+- 泛型将被直接忽略
 
-#### What are Key Places?
+#### 什么是 key 的位置?
 
-- The names of props.
+- props 的名称
 
 ```ts
 // ✅
@@ -72,7 +72,7 @@ defineProps<{
 }>()
 ```
 
-- The names of events.
+- events 的名称
 
 ```ts
 interface Emits {
diff --git a/docs/zh-CN/features/export-props.md b/docs/zh-CN/features/export-props.md
index 23fd83bd3..bef413a79 100644
--- a/docs/zh-CN/features/export-props.md
+++ b/docs/zh-CN/features/export-props.md
@@ -1,19 +1,22 @@
 # exportProps
 
-<small py2>Stability: <code class="!text-red-600">experimental</code></small>
+<div py2 flex>
+  <small>稳定性: <code class="!text-red-600">实验性</code></small>
+  <WarnBadge>实验性功能，风险自负</WarnBadge>
+</div>
 
 [Svelte-like Declaring props](https://svelte.dev/docs#component-format-script-1-export-creates-a-component-prop) for Vue.
 
-|   Features   |     Supported      |
+|     特性     |        支持        |
 | :----------: | :----------------: |
 |    Vue 3     | :white_check_mark: |
 |    Nuxt 3    |         ?          |
 |    Vue 2     |         ?          |
 | Volar Plugin | :white_check_mark: |
 
-## Usage
+## 用法
 
-Using export syntax to declare props.
+使用导出的语法来声明 props。
 
 ```vue
 <script setup lang="ts">
diff --git a/docs/zh-CN/features/hoist-static.md b/docs/zh-CN/features/hoist-static.md
index eb43958a4..e2adb00bd 100644
--- a/docs/zh-CN/features/hoist-static.md
+++ b/docs/zh-CN/features/hoist-static.md
@@ -1,18 +1,18 @@
 # hoistStatic
 
-<small>Stability: <code class="!text-green-600">stable</code></small>
+<small>稳定性: <code class="!text-green-600">稳定</code></small>
 
-With enabling `hoistStatic`, constants declared in macros of `<script setup>` can be referenced.
+通过启用 `hoistStatic`, 可以引用 `<script setup>`的宏中声明的常量。
 
-If you support this feature, feel free to hit like :+1: or comment on the [Vue PR](https://github.com/vuejs/core/pull/5752). Thanks!
+如果您支持此功能，请随意点击 :+1: 或者在 [Vue PR](https://github.com/vuejs/core/pull/5752) 上发表评论. 谢谢!
 
-| Features |     Supported      |
-| :------: | :----------------: |
-|  Vue 3   | :white_check_mark: |
-|  Nuxt 3  | :white_check_mark: |
-|  Vue 2   | :white_check_mark: |
+|  特性  |        支持        |
+| :----: | :----------------: |
+| Vue 3  | :white_check_mark: |
+| Nuxt 3 | :white_check_mark: |
+| Vue 2  | :white_check_mark: |
 
-## Basic Usage
+## 基本用法
 
 ```vue
 <script setup lang="ts">
@@ -36,7 +36,7 @@ export default {
 
 :::
 
-## Magic Comments
+## 魔法注释
 
 ```vue
 <script setup lang="ts">
diff --git a/docs/zh-CN/features/named-template.md b/docs/zh-CN/features/named-template.md
index c7bef0707..e2abb08b2 100644
--- a/docs/zh-CN/features/named-template.md
+++ b/docs/zh-CN/features/named-template.md
@@ -1,26 +1,24 @@
 # namedTemplate
 
-
 <div py2 flex>
-  <small>Stability: <code class="!text-red-600">experimental</code></small>
-  <WarnBadge>Experimental, use at your risk</WarnBadge>
+  <small>稳定性: <code class="!text-red-600">实验性</code></small>
+  <WarnBadge>实验性功能，风险自负</WarnBadge>
 </div>
 
+通过启用 `namedTemplate` ，`<template>` 可以像变量一样被引用。
 
-With enabling `namedTemplate`, `<template>` can be referenced like a variable.
-
-Sometimes we need to reverse the order of the very simple components, and don't want to give the features of Vue template up and use JSX/TSX. Then this feature is much helpful.
+有时候我们需要把非常简单的组件颠倒顺序，又不想放弃 Vue 模板的特性而使用 JSX/TSX。那么这个功能就非常有用了。
 
-If you support this feature, you can go to [the discussion](https://github.com/vuejs/core/discussions/6898) and hit like :+1: or comment.
+如果你支持这个功能, 你可以去 [这个讨论](https://github.com/vuejs/core/discussions/6898) 点赞 :+1: 或评论。
 
-|      Features      |     Supported      |
+|        特性        |        支持        |
 | :----------------: | :----------------: |
 |       Vue 3        | :white_check_mark: |
 |       Nuxt 3       |        :x:         |
 |       Vue 2        |        :x:         |
 | TypeScript / Volar |        :x:         |
 
-## Basic Usage
+## 基本用法
 
 ```vue {5-7,10-12,16-18}
 <script setup>
@@ -44,6 +42,6 @@ const pager = 'top'
 </template>
 ```
 
-## Known Usage
+## 已知的问题
 
-- TypeScript / Volar support is not yet completed.
+- TypeScript / Volar 支持尚未完成。
diff --git a/docs/zh-CN/features/reactivity-transform.md b/docs/zh-CN/features/reactivity-transform.md
index d487fcf55..4da59c447 100644
--- a/docs/zh-CN/features/reactivity-transform.md
+++ b/docs/zh-CN/features/reactivity-transform.md
@@ -1,19 +1,19 @@
 # Reactivity Transform
 
-<small>Stability: <code class="!text-green-600">stable</code></small>
+<small>稳定性: <code class="!text-green-600">稳定</code></small>
 
-|      Features      |     Supported      |
+|        特性        |        支持        |
 | :----------------: | :----------------: |
 |       Vue 3        | :white_check_mark: |
 |       Nuxt 3       | :white_check_mark: |
 |       Vue 2        | :white_check_mark: |
 | TypeScript / Volar | :white_check_mark: |
 
-## Installation Standalone Version
+## 安装独立版本
 
-if you need Reactivity Transform feature only, the standalone version is more appropriate for you.
+如果您只需要 `Reactivity Transform` 功能，独立版本更适合您。
 
-### Installation
+### 安装
 
 ::: code-group
 
@@ -70,7 +70,7 @@ module.exports = {
 
 :::
 
-### TypeScript Support
+### TypeScript 支持
 
 ```json
 // tsconfig.json
@@ -82,6 +82,6 @@ module.exports = {
 }
 ```
 
-## Usage
+## 用法
 
-Refer to [official docs](https://vuejs.org/guide/extras/reactivity-transform.html).
+参见 [官方文档](https://cn.vuejs.org/guide/extras/reactivity-transform.html).

From e0fd137af03f021c5e23d7a8112c016dcad2d191 Mon Sep 17 00:00:00 2001
From: liangzhensheng <1250564179@qq.com>
Date: Mon, 30 Jan 2023 12:13:27 +0800
Subject: [PATCH 04/11] docs: modify definePropsRefs  description

---
 docs/zh-CN/macros/define-props-refs.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/zh-CN/macros/define-props-refs.md b/docs/zh-CN/macros/define-props-refs.md
index 0d21ba192..591494f72 100644
--- a/docs/zh-CN/macros/define-props-refs.md
+++ b/docs/zh-CN/macros/define-props-refs.md
@@ -2,7 +2,7 @@
 
 <small>稳定性: <code class="!text-yellow-600">不稳定</code></small>
 
-从 `defineProps` 返回的 refs 不是响应式对象，它可以在不失去响应式的情况下被解构。
+从 `defineProps` 将返回的 refs 而不是响应式对象，它可以在不失去响应式的情况下被解构。
 
 `toRefs(defineProps())` => `definePropsRefs()`
 

From 599ed4b746617363f1f1dc821ca289ae794e0a28 Mon Sep 17 00:00:00 2001
From: liangzhensheng <1250564179@qq.com>
Date: Mon, 30 Jan 2023 19:15:12 +0800
Subject: [PATCH 05/11] docs: update better-define

---
 docs/zh-CN/features/better-define.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/zh-CN/features/better-define.md b/docs/zh-CN/features/better-define.md
index 99d84b686..be382a80c 100644
--- a/docs/zh-CN/features/better-define.md
+++ b/docs/zh-CN/features/better-define.md
@@ -44,7 +44,7 @@ export interface BaseProps {
 
 #### 什么是复杂类型？
 
-- 所有实用类型
+- 所有工具类型
   - [内置类型](https://www.typescriptlang.org/docs/handbook/utility-types.html)
   - 来自 `type-fest` 包的所有类型。
   - ...

From a2e62ae0b57b089bdb659a59f17a695d3914d177 Mon Sep 17 00:00:00 2001
From: liangzhensheng <1250564179@qq.com>
Date: Mon, 30 Jan 2023 19:19:34 +0800
Subject: [PATCH 06/11] docs: update define-options

---
 docs/zh-CN/macros/define-options.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/zh-CN/macros/define-options.md b/docs/zh-CN/macros/define-options.md
index 117a129a5..5274d6a8c 100644
--- a/docs/zh-CN/macros/define-options.md
+++ b/docs/zh-CN/macros/define-options.md
@@ -2,7 +2,7 @@
 
 <small>稳定性: <code class="!text-green-600">稳定</code></small>
 
-可以使用 `defineOptions`函数在 `<script setup>`中使用选项式 API，特别是能够在一个函数内设置`name`, `props`, `emits`, `render` 。
+可以使用 `defineOptions`函数在 `<script setup>`中使用选项式 API，也就是说我们可以把 `name`, `props`, `emits`, `render` 放到一个函数里。
 
 如果您支持此功能, 请随意点击 :+1: 或在 [RFC 讨论](https://github.com/vuejs/rfcs/discussions/430)中发表评论。谢谢！
 

From 724891945fa902e5ab0bd117b872b7abc941551c Mon Sep 17 00:00:00 2001
From: liangzhensheng <1250564179@qq.com>
Date: Tue, 31 Jan 2023 15:15:40 +0800
Subject: [PATCH 07/11] fix: add sidebar type assertion

---
 docs/.vitepress/locales/zh-cn.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/.vitepress/locales/zh-cn.ts b/docs/.vitepress/locales/zh-cn.ts
index e56e6e15c..e3ab85652 100644
--- a/docs/.vitepress/locales/zh-cn.ts
+++ b/docs/.vitepress/locales/zh-cn.ts
@@ -10,7 +10,7 @@ export const nav: DefaultTheme.NavItem[] = [
   { text: '特性', link: '/zh-CN/features/hoist-static' },
 ]
 
-export const sidebar = common.sidebar('zh-CN')
+export const sidebar = common.sidebar('zh-CN') as DefaultTheme.SidebarGroup[]
 
 const sidebarTitle: string[] = ['指南', '宏', '特性']
 const sidebarItem: string[][] = [

From 973b291f70a690367ae1c95fd93932a58caec67e Mon Sep 17 00:00:00 2001
From: liangzhensheng <1250564179@qq.com>
Date: Fri, 3 Feb 2023 17:32:05 +0800
Subject: [PATCH 08/11] docs: update guide

---
 docs/zh-CN/guide/bundler-integration.md |  6 +++---
 docs/zh-CN/guide/configurations.md      |  4 ++--
 docs/zh-CN/guide/getting-started.md     | 10 +++++-----
 docs/zh-CN/guide/nuxt-integration.md    |  4 ++--
 4 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/docs/zh-CN/guide/bundler-integration.md b/docs/zh-CN/guide/bundler-integration.md
index 747d9b9da..91b04df74 100644
--- a/docs/zh-CN/guide/bundler-integration.md
+++ b/docs/zh-CN/guide/bundler-integration.md
@@ -124,7 +124,7 @@ module.exports = defineConfig({
 
 ## Volar 支持
 
-详细配置请参考每个宏的具体说明。
+有关宏的详细配置请参考每个宏的具体说明。
 
 ```bash
 npm i -D @vue-macros/volar
@@ -147,6 +147,6 @@ npm i -D @vue-macros/volar
 }
 ```
 
-:tada: 祝贺你! 你已经成功设置完成 `unplugin-vue-macros`。
+:tada: 恭喜你! 目前你已经成功将 `unplugin-vue-macros` 设置完成。
 
-想要了解有关宏的更多信息, 请访问 [全部宏](/zh-CN/macros/) :laughing:。
+如果你还想要了解有关宏的更多信息, 请访问 [全部宏](/zh-CN/macros/) :laughing:。
diff --git a/docs/zh-CN/guide/configurations.md b/docs/zh-CN/guide/configurations.md
index f626beb76..c1dae06bd 100644
--- a/docs/zh-CN/guide/configurations.md
+++ b/docs/zh-CN/guide/configurations.md
@@ -2,7 +2,7 @@
 
 ## 插件选项
 
-所有功能将会被默认开启，您可以将选项设置为 `false` 来禁用它们。
+在 Vue Macros 中所有功能都将会被默认开启，你可以将选项设置为 `false` 来禁用它们。
 
 ```ts
 VueMacros({
@@ -37,4 +37,4 @@ VueMacros({
 })
 ```
 
-有关每个功能的选项，请参考功能页面。
+有关每个宏的配置选项，请参考对应宏的页面。
diff --git a/docs/zh-CN/guide/getting-started.md b/docs/zh-CN/guide/getting-started.md
index 5ccfdccfa..7fa817f39 100644
--- a/docs/zh-CN/guide/getting-started.md
+++ b/docs/zh-CN/guide/getting-started.md
@@ -1,12 +1,12 @@
 # 入门
 
-Vue Macros 是一个库，用于实现尚未被 Vue 正式实现的提案或想法。这意味着它将探索和扩展 Vue 的更多功能和语法糖。
+Vue Macros 是一个库，用于实现尚未被 Vue 正式实现的提案或想法。这意味着它将探索并扩充更多宏和语法糖到 Vue。
 
-在继续之前，我们假设您已经熟悉 Vue 的基本用法。
+在继续之前，我们假设你已经熟悉 Vue 的基本用法。
 
 ## 要求
 
-- Vue >= 2.7 or Vue >= 3.0
+- Vue >= 2.7 或 Vue >= 3.0
   - 某些功能需要 Vue >= 3.2.25
 - VSCode 安装了 [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) 扩展
   - ❌ 不支持 WebStorm
@@ -22,8 +22,8 @@ Vue Macros 是一个库，用于实现尚未被 Vue 正式实现的提案或想
 
 ## Nuxt 整合
 
-如果您使用的是 [Nuxt 3](https://nuxt.com/)，请阅读 [Nuxt 整合](./nuxt-integration.md)。
+如果你使用的是 [Nuxt 3](https://nuxt.com/)，请阅读 [Nuxt 整合](./nuxt-integration.md)。
 
 ## 打包器整合
 
-如果您使用的是 [Vite](https://vitejs.dev/)，[Rollup](https://rollupjs.org/)，[esbuild](https://esbuild.github.io/)，或 [Webpack](https://webpack.js.org/)这一类的打包工具，请阅读 [打包器整合](./bundler-integration.md)。
+如果你使用的是 [Vite](https://vitejs.dev/)，[Rollup](https://rollupjs.org/)，[esbuild](https://esbuild.github.io/)，或 [Webpack](https://webpack.js.org/) 这一类的打包器，请阅读 [打包器整合](./bundler-integration.md)。
diff --git a/docs/zh-CN/guide/nuxt-integration.md b/docs/zh-CN/guide/nuxt-integration.md
index 1f02bc972..d99e3e46d 100644
--- a/docs/zh-CN/guide/nuxt-integration.md
+++ b/docs/zh-CN/guide/nuxt-integration.md
@@ -33,6 +33,6 @@ export default {
 }
 ```
 
-:tada: 祝贺你! 成功完成了 Nuxt 整合。
+:tada: 恭喜你! 现在已经成功完成了对 Nuxt 的整合过程。
 
-想要了解有关宏的更多信息, 请访问 [全部宏](/zh-CN/macros/) :laughing:。
+如果你还想要了解有关宏的更多信息, 请访问 [全部宏](/zh-CN/macros/) :laughing:。

From 346069d77f3e1e0ea35186f31e40e80f2cf7c2bf Mon Sep 17 00:00:00 2001
From: liangzhensheng <1250564179@qq.com>
Date: Fri, 3 Feb 2023 17:44:33 +0800
Subject: [PATCH 09/11] docs: update macros

---
 docs/zh-CN/macros/define-model.md      | 10 ++++++----
 docs/zh-CN/macros/define-options.md    |  8 ++++----
 docs/zh-CN/macros/define-props-refs.md |  2 +-
 docs/zh-CN/macros/define-props.md      |  4 ++--
 docs/zh-CN/macros/define-render.md     |  2 +-
 docs/zh-CN/macros/define-slots.md      |  2 +-
 docs/zh-CN/macros/index.md             |  4 ++--
 docs/zh-CN/macros/setup-component.md   |  6 +++---
 docs/zh-CN/macros/setup-sfc.md         |  6 ++----
 docs/zh-CN/macros/short-emits.md       |  4 ++--
 docs/zh-CN/macros/short-vmodel.md      |  6 +++---
 11 files changed, 27 insertions(+), 27 deletions(-)

diff --git a/docs/zh-CN/macros/define-model.md b/docs/zh-CN/macros/define-model.md
index 4103ec66b..b10e0c489 100644
--- a/docs/zh-CN/macros/define-model.md
+++ b/docs/zh-CN/macros/define-model.md
@@ -2,7 +2,9 @@
 
 <small>稳定性: <code class="!text-green-600">稳定</code></small>
 
-使用 `defineModel`声明和改变 `v-model` 的 props 和普通变量相同。
+<!-- 使用 `defineModel`声明和改变 `v-model` 的 props 和普通变量相同。 -->
+
+使用 `defineModel` 可以简化之前声明和改变 `v-model` 的步骤，让你可以像使用普通变量那样去使用。
 
 |     特性     |        支持        |
 | :----------: | :----------------: |
@@ -28,7 +30,7 @@ VueMacros({
 
 ## 用法
 
-需要 [`@vueuse/core`](https://www.npmjs.com/package/@vueuse/core)，在使用之前请自行安装
+> 在开始之前，请先自行安装 [`@vueuse/core`](https://www.npmjs.com/package/@vueuse/core)
 
 ```vue
 <script setup lang="ts">
@@ -62,7 +64,7 @@ const { modelValue } = defineModel({
 
 :::
 
-[`@vueuse/core`](https://www.npmjs.com/package/@vueuse/core) 不是必需的。
+> [`@vueuse/core`](https://www.npmjs.com/package/@vueuse/core) 在这不是必需的。
 
 ```vue {7-9}
 <script setup lang="ts">
@@ -77,7 +79,7 @@ count++
 </script>
 ```
 
-::: details Compiled Code
+::: details 编译后代码
 
 ```vue
 <script setup lang="ts">
diff --git a/docs/zh-CN/macros/define-options.md b/docs/zh-CN/macros/define-options.md
index 5274d6a8c..cc6696f37 100644
--- a/docs/zh-CN/macros/define-options.md
+++ b/docs/zh-CN/macros/define-options.md
@@ -4,7 +4,7 @@
 
 可以使用 `defineOptions`函数在 `<script setup>`中使用选项式 API，也就是说我们可以把 `name`, `props`, `emits`, `render` 放到一个函数里。
 
-如果您支持此功能, 请随意点击 :+1: 或在 [RFC 讨论](https://github.com/vuejs/rfcs/discussions/430)中发表评论。谢谢！
+如果你支持此功能，欢迎在 [RFC](https://github.com/vuejs/rfcs/discussions/430) 中点赞 :+1: 或发表评论。
 
 |    特性    |        支持        |
 | :--------: | :----------------: |
@@ -15,7 +15,7 @@
 
 ## 安装独立版本
 
-如果您只需要 `defineOptions` 功能, 独立版本更适合您。
+如果你只需要 `defineOptions` 功能, 那么独立版本更加适合你。
 
 ### 安装
 
@@ -99,7 +99,7 @@ const slots = useSlots()
 </script>
 ```
 
-::: details Compiled Code
+::: details 编译后代码
 
 ```vue
 <script lang="ts">
@@ -128,7 +128,7 @@ defineOptions({
 </script>
 ```
 
-::: details Compiled Code
+::: details 编译后代码
 
 ```vue
 <script lang="tsx">
diff --git a/docs/zh-CN/macros/define-props-refs.md b/docs/zh-CN/macros/define-props-refs.md
index 591494f72..26121599e 100644
--- a/docs/zh-CN/macros/define-props-refs.md
+++ b/docs/zh-CN/macros/define-props-refs.md
@@ -2,7 +2,7 @@
 
 <small>稳定性: <code class="!text-yellow-600">不稳定</code></small>
 
-从 `defineProps` 将返回的 refs 而不是响应式对象，它可以在不失去响应式的情况下被解构。
+从 `defineProps` 中将返回 refs 而不是响应式对象，但 `definePropsRefs` 可以在不失去响应式的情况下被解构。
 
 `toRefs(defineProps())` => `definePropsRefs()`
 
diff --git a/docs/zh-CN/macros/define-props.md b/docs/zh-CN/macros/define-props.md
index 52434738d..b8d8c1609 100644
--- a/docs/zh-CN/macros/define-props.md
+++ b/docs/zh-CN/macros/define-props.md
@@ -2,7 +2,7 @@
 
 <small>稳定性: <code class="!text-green-600">稳定</code></small>
 
-使用 `$defineProps` 正确的解构 props 类型
+使用 `$defineProps` 可以正确的解构 `props` 的类型
 
 参见 [Vue issue](https://github.com/vuejs/core/issues/6876), [Reactivity Transform RFC](https://github.com/vuejs/rfcs/blob/reactivity-transform/active-rfcs/0000-reactivity-transform.md#defineprops-destructure-details).
 
@@ -15,7 +15,7 @@
 
 ::: warning
 
-[响应性语法糖](https://cn.vuejs.org/guide/extras/reactivity-transform.html) 是必须的。你必须先开启它。
+在开始之前，你必须先开启 [响应性语法糖](https://cn.vuejs.org/guide/extras/reactivity-transform.html)
 
 :::
 
diff --git a/docs/zh-CN/macros/define-render.md b/docs/zh-CN/macros/define-render.md
index b0fd84569..c4cf7edfe 100644
--- a/docs/zh-CN/macros/define-render.md
+++ b/docs/zh-CN/macros/define-render.md
@@ -2,7 +2,7 @@
 
 <small>稳定性: <code class="!text-green-600">稳定</code></small>
 
-使用 `defineRender` 在 `<script setup>` 中定义渲染函数。
+使用 `defineRender` 可以直接在 `<script setup>` 中定义渲染函数。
 
 |    特性    |        支持        |
 | :--------: | :----------------: |
diff --git a/docs/zh-CN/macros/define-slots.md b/docs/zh-CN/macros/define-slots.md
index b126c31f3..27e1fe235 100644
--- a/docs/zh-CN/macros/define-slots.md
+++ b/docs/zh-CN/macros/define-slots.md
@@ -2,7 +2,7 @@
 
 <small>稳定性: <code class="!text-yellow-600">不稳定</code></small>
 
-使用 `defineSlots` 在 `<script setup>` 中声明 SFC slots 的类型
+使用 `defineSlots` 可以在 `<script setup>` 中声明 SFC 中 slots 的类型
 
 |         特性         |         支持         |
 | :------------------: | :------------------: |
diff --git a/docs/zh-CN/macros/index.md b/docs/zh-CN/macros/index.md
index 7cc6ca97c..020ca4f18 100644
--- a/docs/zh-CN/macros/index.md
+++ b/docs/zh-CN/macros/index.md
@@ -1,8 +1,8 @@
 # 用法
 
-所有可用宏的列表。
+以下是所有可用宏的列表。
 
-请确保 `unplugin-vue-macros` 设置正确。如果您还没有设置, 请先阅读 [入门](/zh-CN/guide/getting-started)
+在开始之前，请确保 `unplugin-vue-macros` 设置正确。如果你还没有设置，请先阅读 [入门](/zh-CN/guide/getting-started)
 
 - [defineOptions](/zh-CN/macros/define-options)
 - [defineModel](/zh-CN/macros/define-model)
diff --git a/docs/zh-CN/macros/setup-component.md b/docs/zh-CN/macros/setup-component.md
index a931345cd..120488780 100644
--- a/docs/zh-CN/macros/setup-component.md
+++ b/docs/zh-CN/macros/setup-component.md
@@ -7,7 +7,7 @@
 
 ::: tip
 
-如果您使用的是 `setupComponent`，则无法禁用 `defineRender`。
+如果你使用的是 `setupComponent`，则无法禁用 `defineRender`。
 
 默认情况下不会忽略 `node_modules` 中的文件。
 
@@ -15,7 +15,7 @@
 
 <!-- defineSetupComponent，<script setup>  [Volar](https://github.com/johnsoncodehk/volar) 的纯 JS/TS(X) 中 -->
 
-使用 `defineSetupComponent`, `<script setup>` 的代码可以放在没有 [Volar](https://github.com/johnsoncodehk/volar) 扩展的 **纯 JS/TS(X)** 中。
+使用 `defineSetupComponent`, 可以将 `<script setup>` 中的代码放在没有 [Volar](https://github.com/johnsoncodehk/volar) 扩展的 **纯 JS/TS(X)** 中。
 
 |    特性    |        支持        |
 | :--------: | :----------------: |
@@ -65,4 +65,4 @@ export const App: SetupFC = () => {
 ## 已知的问题
 
 - TypeScript 支持尚未完成。
-- Source map 不能正确对应。
+- Source map 不能正确映射。
diff --git a/docs/zh-CN/macros/setup-sfc.md b/docs/zh-CN/macros/setup-sfc.md
index 7076aacc4..c6bb08dc0 100644
--- a/docs/zh-CN/macros/setup-sfc.md
+++ b/docs/zh-CN/macros/setup-sfc.md
@@ -7,7 +7,7 @@
 
 ::: tip
 
-如果您使用的是 `setupSFC`，则无法禁用 `defineRender`。
+如果你使用的是 `setupSFC`，则无法禁用 `defineRender`。
 
 :::
 
@@ -87,7 +87,5 @@ export default () => (
 
 ## 已知的问题
 
-源映射在 JSX/TSX 文件中不正确对应
-
-- Source map 在 JSX/TSX 文件中不能正确的对应。
+- Source map 在 JSX/TSX 文件中不能正确的映射。
 - TypeScript 支持尚未完成。
diff --git a/docs/zh-CN/macros/short-emits.md b/docs/zh-CN/macros/short-emits.md
index 6ca22c7cf..4c6f468ab 100644
--- a/docs/zh-CN/macros/short-emits.md
+++ b/docs/zh-CN/macros/short-emits.md
@@ -2,7 +2,7 @@
 
 <small>稳定性: <code class="!text-green-600">稳定</code></small>
 
-简化 emits 的定义
+简化 `emits` 的定义
 
 |    特性    |        功能        |
 | :--------: | :----------------: |
@@ -12,7 +12,7 @@
 
 ## 基本用法
 
-使用类型 `ShortEmits` 或简称 `SE`.
+使用 `ShortEmits` 或简写为 `SE`，可以使用元组或方法定义。
 
 ```vue
 <script setup lang="ts">
diff --git a/docs/zh-CN/macros/short-vmodel.md b/docs/zh-CN/macros/short-vmodel.md
index 301ca3c41..33ba3a733 100644
--- a/docs/zh-CN/macros/short-vmodel.md
+++ b/docs/zh-CN/macros/short-vmodel.md
@@ -2,11 +2,11 @@
 
 <small>稳定性: <code class="!text-green-600">稳定</code></small>
 
-`v-model`的语法糖.
+`v-model`的语法糖。
 
 `v-model` -> `::` / `$` / `*`
 
-如果您对此功能有任何疑问，可以在 [RFC 讨论](https://github.com/vuejs/rfcs/discussions/395) 中发表评论。
+如果你对此功能有任何疑问，欢迎在 [RFC](https://github.com/vuejs/rfcs/discussions/395) 中发表评论。
 
 |     特性     |        支持        |
 | :----------: | :----------------: |
@@ -50,7 +50,7 @@ export default defineConfig({
 
 ## 选项
 
-`prefix`: `'::' | '$' | '*'`, defaults to `'$'`
+`prefix`: `'::' | '$' | '*'`，默认为 `'$'`
 
 ## 用法
 

From c6d16f1482797635751f5c05853b24ea8a2c3407 Mon Sep 17 00:00:00 2001
From: liangzhensheng <1250564179@qq.com>
Date: Fri, 3 Feb 2023 17:52:44 +0800
Subject: [PATCH 10/11] docs: update features

---
 docs/zh-CN/features/better-define.md        | 14 +++++++-------
 docs/zh-CN/features/export-props.md         |  4 ++--
 docs/zh-CN/features/hoist-static.md         | 10 ++++++----
 docs/zh-CN/features/named-template.md       |  6 +++---
 docs/zh-CN/features/reactivity-transform.md |  2 +-
 5 files changed, 19 insertions(+), 17 deletions(-)

diff --git a/docs/zh-CN/features/better-define.md b/docs/zh-CN/features/better-define.md
index be382a80c..424627b06 100644
--- a/docs/zh-CN/features/better-define.md
+++ b/docs/zh-CN/features/better-define.md
@@ -2,9 +2,9 @@
 
 <small>稳定性: <code class="!text-green-600">稳定</code></small>
 
-通过启用 `betterDefine` ，`<script setup>` type-based-macros 支持导入的类型。
+通过开启 `betterDefine` ，支持在 `<script setup>` 中导入 TS 类型来定义 `props` 和 `emits`。
 
-[相关问题](https://github.com/vuejs/core/issues/4294)
+如果你对此功能有任何疑问，欢迎在 [issues](https://github.com/vuejs/core/issues/4294) 中发表评论。
 
 |    特性    |        支持        |
 | :--------: | :----------------: |
@@ -40,7 +40,7 @@ export interface BaseProps {
 
 ### 复杂类型
 
-在一些 key 的位置不支持复杂类型。例如：
+在一些**关键的位置**不支持**复杂类型**。例如：
 
 #### 什么是复杂类型？
 
@@ -54,11 +54,11 @@ export interface BaseProps {
     [key: string]: string
   }
   ```
-- 泛型将被直接忽略
+- 泛型将会被直接忽略
 
-#### 什么是 key 的位置?
+#### 什么是**关键的位置**?
 
-- props 的名称
+- **props** 的名称
 
 ```ts
 // ✅
@@ -72,7 +72,7 @@ defineProps<{
 }>()
 ```
 
-- events 的名称
+- **events** 的名称
 
 ```ts
 interface Emits {
diff --git a/docs/zh-CN/features/export-props.md b/docs/zh-CN/features/export-props.md
index bef413a79..03be6ee88 100644
--- a/docs/zh-CN/features/export-props.md
+++ b/docs/zh-CN/features/export-props.md
@@ -5,7 +5,7 @@
   <WarnBadge>实验性功能，风险自负</WarnBadge>
 </div>
 
-[Svelte-like Declaring props](https://svelte.dev/docs#component-format-script-1-export-creates-a-component-prop) for Vue.
+在 Vue 中像 Svelte 那样声明 `props`，[Svelte 对应文档](https://svelte.dev/docs#component-format-script-1-export-creates-a-component-prop)。
 
 |     特性     |        支持        |
 | :----------: | :----------------: |
@@ -16,7 +16,7 @@
 
 ## 用法
 
-使用导出的语法来声明 props。
+使用导出的语法来声明 `props`。
 
 ```vue
 <script setup lang="ts">
diff --git a/docs/zh-CN/features/hoist-static.md b/docs/zh-CN/features/hoist-static.md
index e2adb00bd..1b44aaa45 100644
--- a/docs/zh-CN/features/hoist-static.md
+++ b/docs/zh-CN/features/hoist-static.md
@@ -2,9 +2,11 @@
 
 <small>稳定性: <code class="!text-green-600">稳定</code></small>
 
-通过启用 `hoistStatic`, 可以引用 `<script setup>`的宏中声明的常量。
+<!-- 通过开启 `hoistStatic`, 你可以引用 `<script setup>` 宏中声明的常量。 -->
 
-如果您支持此功能，请随意点击 :+1: 或者在 [Vue PR](https://github.com/vuejs/core/pull/5752) 上发表评论. 谢谢!
+通过开启 `hoistStatic`, 可以在宏内部引用 `<script setup>` 中的变量
+
+如果你支持此功能，欢迎在 [Vue PR](https://github.com/vuejs/core/pull/5752) 中点赞 :+1: 或发表评论。
 
 |  特性  |        支持        |
 | :----: | :----------------: |
@@ -23,7 +25,7 @@ defineOptions({
 </script>
 ```
 
-::: details Compiled Code
+::: details 编译后代码
 
 ```vue
 <script lang="ts">
@@ -48,7 +50,7 @@ defineOptions({
 </script>
 ```
 
-::: details Compiled Code
+::: details 编译后代码
 
 ```vue
 <script lang="ts">
diff --git a/docs/zh-CN/features/named-template.md b/docs/zh-CN/features/named-template.md
index e2abb08b2..6c52c91ae 100644
--- a/docs/zh-CN/features/named-template.md
+++ b/docs/zh-CN/features/named-template.md
@@ -5,11 +5,11 @@
   <WarnBadge>实验性功能，风险自负</WarnBadge>
 </div>
 
-通过启用 `namedTemplate` ，`<template>` 可以像变量一样被引用。
+通过开启 `namedTemplate` ，`<template>` 可以像变量一样被引用。
 
-有时候我们需要把非常简单的组件颠倒顺序，又不想放弃 Vue 模板的特性而使用 JSX/TSX。那么这个功能就非常有用了。
+有时候我们需要把非常简单的组件颠倒顺序，但又不想放弃 Vue 模板的特性而使用 JSX/TSX。那么这个功能就非常有用了。
 
-如果你支持这个功能, 你可以去 [这个讨论](https://github.com/vuejs/core/discussions/6898) 点赞 :+1: 或评论。
+如果你支持此功能，欢迎在 [讨论](https://github.com/vuejs/core/discussions/6898) 中点赞 :+1: 或评论。
 
 |        特性        |        支持        |
 | :----------------: | :----------------: |
diff --git a/docs/zh-CN/features/reactivity-transform.md b/docs/zh-CN/features/reactivity-transform.md
index 4da59c447..e39875600 100644
--- a/docs/zh-CN/features/reactivity-transform.md
+++ b/docs/zh-CN/features/reactivity-transform.md
@@ -11,7 +11,7 @@
 
 ## 安装独立版本
 
-如果您只需要 `Reactivity Transform` 功能，独立版本更适合您。
+如果你只需要 `Reactivity Transform` 功能，独立版本更适合你。
 
 ### 安装
 

From 66e80880486c09208499962e39e9d1e3943a6b68 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E4=B8=89=E5=92=B2=E6=99=BA=E5=AD=90=20Kevin=20Deng?=
 <sxzz@sxzz.moe>
Date: Fri, 17 Feb 2023 00:06:00 +0100
Subject: [PATCH 11/11] fix: type error

---
 docs/.vitepress/locales/common.ts | 2 +-
 docs/.vitepress/locales/zh-cn.ts  | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/.vitepress/locales/common.ts b/docs/.vitepress/locales/common.ts
index ce9cd4d3e..5f4fa5172 100644
--- a/docs/.vitepress/locales/common.ts
+++ b/docs/.vitepress/locales/common.ts
@@ -30,7 +30,7 @@ gtag('config', 'G-29NKGSL23C');`,
   ],
 ]
 
-export const sidebar = (lang: string): DefaultTheme.Sidebar => {
+export const sidebar = (lang: string): DefaultTheme.SidebarItem[] => {
   const urlPrefix = lang ? `/${lang}` : ''
   return [
     {
diff --git a/docs/.vitepress/locales/zh-cn.ts b/docs/.vitepress/locales/zh-cn.ts
index e3ab85652..f19d824db 100644
--- a/docs/.vitepress/locales/zh-cn.ts
+++ b/docs/.vitepress/locales/zh-cn.ts
@@ -10,7 +10,7 @@ export const nav: DefaultTheme.NavItem[] = [
   { text: '特性', link: '/zh-CN/features/hoist-static' },
 ]
 
-export const sidebar = common.sidebar('zh-CN') as DefaultTheme.SidebarGroup[]
+export const sidebar = common.sidebar('zh-CN')
 
 const sidebarTitle: string[] = ['指南', '宏', '特性']
 const sidebarItem: string[][] = [
@@ -20,7 +20,7 @@ const sidebarItem: string[][] = [
 ]
 sidebar.forEach((bar, i) => {
   bar.text = sidebarTitle[i]
-  bar.items.forEach((item, j) => {
+  bar.items!.forEach((item, j) => {
     if (sidebarItem[i][j]) item.text = sidebarItem[i][j]
   })
 })