docs: add simplified chinese translation

.github/workflows/documents.yml

@@ -43,6 +43,7 @@ jobs:
         run: |
           cp CHANGELOG.md ./docs/en/changelog.md
           cp CHANGELOG.md ./docs/ko/changelog.md
+          cp CHANGELOG.md ./docs/zhHans/changelog.md
 
       # install dependencies if the cache did not hit
       - name: Install dependencies

docs/.vitepress/config.ts

@@ -14,14 +14,15 @@ const commonSidebarConfig: VitePressSidebarOptions = {
   capitalizeFirst: true,
   useTitleFromFileHeading: true,
   useTitleFromFrontmatter: true,
-  convertSameNameSubFileToGroupIndexPage: true,
+  useFolderTitleFromIndexFile: true,
   frontmatterOrderDefaultValue: 9, // For 'CHANGELOG.md'
   sortMenusByFrontmatterOrder: true
 };
 
 const defineSupportLocales = [
   { label: defaultLocale, translateLocale: defaultLocale },
-  { label: 'ko', translateLocale: 'ko' }
+  { label: 'ko', translateLocale: 'ko' },
+  { label: 'zhHans', translateLocale: 'zhHans' }
 ];
 
 // Ref: https://vitepress.dev/reference/site-config
@@ -45,7 +46,7 @@ export default defineConfig({
   themeConfig: {
     logo: { src: '/logo-32.png', width: 24, height: 24 },
     sidebar: generateSidebar([
-      ...[defaultLocale, 'ko'].map((lang) => {
+      ...[defaultLocale, 'ko', 'zhHans'].map((lang) => {
         return {
           ...commonSidebarConfig,
           documentRootPath: `/docs/${lang}`,
@@ -74,15 +75,19 @@ export default defineConfig({
     editLinkPattern: editLinkPattern,
     label: {
       en: 'English',
-      ko: '한국어'
+      ko: '한국어',
+      zhHans: '简体中文'
     },
     lang: {
       en: 'en-US',
-      ko: 'ko-KR'
+      ko: 'ko-KR',
+      zhHans: 'zh-CN'
     },
     description: {
       en: 'VitePress Sidebar is a VitePress plugin that automatically generates sidebar menus with one setup and no hassle. Save time by easily creating taxonomies for tons of articles.',
-      ko: 'VitePress Sidebar는 번거로운 작업 없이 한번의 설정만으로 사이드바 메뉴를 자동으로 생성하는 VitePress 플러그인입니다. 수많은 문서에 대한 분류를 손쉽게 만들어 시간을 절약하세요.'
+      ko: 'VitePress Sidebar는 번거로운 작업 없이 한번의 설정만으로 사이드바 메뉴를 자동으로 생성하는 VitePress 플러그인입니다. 수많은 문서에 대한 분류를 손쉽게 만들어 시간을 절약하세요.',
+      zhHans:
+        'VitePress Sidebar是一款VitePress插件,只需一次设置即可自动生成侧边栏菜单,无需任何麻烦。轻松为大量文章创建分类,节省时间。'
     },
     themeConfig: {
       en: {
@@ -116,6 +121,22 @@ export default defineConfig({
             link: '/ko/changelog'
           }
         ]
+      },
+      zhHans: {
+        nav: [
+          {
+            text: '安装',
+            link: '/zhHans/guide/getting-started'
+          },
+          {
+            text: 'API',
+            link: '/zhHans/guide/api'
+          },
+          {
+            text: '变化',
+            link: '/zhHans/changelog'
+          }
+        ]
       }
     }
   })

docs/en/guide/api.md

@@ -196,7 +196,7 @@ Sorts the menu items by the `order` property of the frontmatter. For each folder
 - Type: `boolean`
 - Default: `false`
 
-Sorts the menu items by the `date` property of the frontmatter. It also sorts the `date` property values in ascending order by oldest date (or descending order if the ``option is`true`) The date format must match `YYYY-MM-DD` or the JavaScript Date data type.
+Sorts the menu items by the `date` property of the frontmatter. It also sorts the `date` property values in ascending order by oldest date (or descending order if the `sortMenusOrderByDescending` option is `true`) The date format must match `YYYY-MM-DD` or the JavaScript Date data type.
 
 ## `sortMenusOrderByDescending`
 

docs/ko/guide/api.md

@@ -196,7 +196,7 @@ name: 이 것은 Frontmatter의 제목값입니다.
 - Type: `boolean`
 - Default: `false`
 
-앞부분의 `date` 속성을 기준으로 메뉴 항목을 정렬합니다. 또한 `date` 속성 값을 가장 오래된 날짜 순으로 오름차순으로 정렬합니다(`옵션`이 `true`인 경우 내림차순). 날짜 형식은 `YYYY-MM-DD` 또는 JavaScript 날짜 데이터 유형과 일치해야 합니다.
+앞부분의 `date` 속성을 기준으로 메뉴 항목을 정렬합니다. 또한 `date` 속성 값을 가장 오래된 날짜 순으로 오름차순으로 정렬합니다(`sortMenusOrderByDescending` 옵션이 `true`인 경우 내림차순). 날짜 형식은 `YYYY-MM-DD` 또는 JavaScript 날짜 데이터 유형과 일치해야 합니다.
 
 ## `sortMenusOrderByDescending`
 

docs/zhHans/advanced-usage/index.md

@@ -0,0 +1,3 @@
+---
+title: 高级使用
+---

docs/zhHans/advanced-usage/multi-level-sidebar-with-indents.md

@@ -0,0 +1,51 @@
+# 带缩进的多级侧边栏
+
+在多层侧边栏中，菜单显示时每层都会缩进。不过，VitePress 默认从第二层开始缩进。例如
+
+![Multi level docs before](/doc-multi-level-docs-before.png)
+
+上面,`directory-level-2`是`directory-level-1`的子文件,但看起来处于相同的层级。
+
+这不是VitePress侧边栏的问题,要解决这个问题,您需要通过**[VitePress的自定义CSS](https://vitepress.dev/guide/extending-default-theme#customizing-css)**自定义现有主题的样式。
+
+在`.vitepress`目录下创建一个`theme`目录,以覆盖现有样式所需的样式。然后在`theme`目录下创建一个`index.js`文件(如果您使用的是Typescript,请使用`index.ts`而不是`index.js`)和一个`custom.css`文件。
+
+```text
+/
+├─ package.json
+├─ src/
+├─ docs/
+│  ├─ .vitepress/
+│  │  └─ theme/            <------------ Add this
+│  │     ├─ custom.css     <------------ Add this
+│  │     └─ index.js       <------------ Add this
+│  ├─ example.md
+│  └─ index.md
+└─ ...
+```
+
+然后在 `index.js` 文件中添加以下内容：
+
+```javascript
+import DefaultTheme from 'vitepress/theme';
+import './custom.css';
+
+export default DefaultTheme;
+```
+
+接下来，在 `custom.css` 文件中添加以下内容：
+
+```css
+.group:has([role='button']) .VPSidebarItem.level-0 .items {
+  padding-left: 16px !important;
+  border-left: 1px solid var(--vp-c-divider);
+  border-radius: 2px;
+  transition: background-color 0.25s;
+}
+```
+
+现在启动 VitePress 服务器。这样就能更容易地看到子内容所在组的第一级层次结构。
+
+![Multi level docs before](/doc-multi-level-docs-after.png)
+
+需要注意的是,这里看到的垂直分隔线只是用CSS创建的;它应该创建为一个带有CSS类名为`indicator`的`div`,所以你应该知道,当你以后创建动态页面时,垂直分隔线可能不会被选中。

docs/zhHans/advanced-usage/multiple-sidebars-how-to.md

@@ -0,0 +1,241 @@
+# 多侧边栏操作方法
+
+多侧边栏是一项允许根据特定 URI 路径显示不同侧边栏菜单的功能。
+
+只需在 `vitepress-sidebar` 中进行一些简单设置，就能轻松实现这一功能。最终，**VitePress**将按照预期输出选项。
+
+要先了解有关多侧边栏的更多信息，我们建议您查看下面**VitePress 的**官方文档：
+
+https://vitepress.dev/reference/default-theme-sidebar#multiple-sidebars
+
+## 基本用法
+
+首先，假设你有一个名为 `docs` 的根项目，其中有名为 `guide` 和 `config` 的子目录，就像这样：
+
+```
+docs/
+├─ guide/
+│  ├─ index.md
+│  ├─ one.md
+│  ├─ two.md
+│  └─ do-not-include.md
+└─ config/
+   ├─ index.md
+   ├─ three.md
+   └─ four.md
+```
+
+当URL位于`/guide`页面时,用户希望菜单仅显示`guide`的子菜单,隐藏`config`的子菜单。同样,当`guide`位于`/config`页面时,您希望隐藏`guide`的子菜单。
+
+要在 `vitepress-sidebar` 中实现此功能,您需要采用与现有设置不同的方法。
+
+像以前一样使用`generateSidebar`函数,但传递一个数组。该数组至少包含一个来自`vitepress-sidebar`的选项。数组中的值可以是任意数量的URL。当然,您也可以使用不同的设置进行配置。
+
+```javascript
+// 必须传递数组参数!!!!
+generateSidebar([
+  {
+    documentRootPath: 'docs',
+    scanStartPath: 'guide',
+    basePath: '/guide/',
+    resolvePath: '/guide/',
+    useTitleFromFileHeading: true,
+    excludeFiles: ['do-not-include.md']
+  },
+  {
+    documentRootPath: 'docs',
+    scanStartPath: 'config',
+    resolvePath: '/config/',
+    useTitleFromFrontmatter: true
+  }
+]);
+```
+
+这些选项的值在结果中的使用情况如下：
+
+```text
+{
+  <resolvePath>: [
+    {
+      base: <basePath or resolvePath>,
+      items: [...] // `<scanStartPath>/path/to/items`
+    }
+  ]
+}
+```
+
+下面是上述设置的输出示例：
+
+```json5
+{
+  '/guide/': {
+    base: '/guide/',
+    items: [
+      {
+        text: 'One',
+        link: 'one'
+      },
+      {
+        text: 'Two',
+        link: 'two'
+      }
+    ]
+  },
+  '/config/': {
+    base: '/config/',
+    items: [
+      {
+        text: 'Three',
+        link: 'three'
+      },
+      {
+        text: 'Four',
+        link: 'four'
+      }
+    ]
+  }
+}
+```
+
+## 多个侧边栏选项
+
+以下选项可用于多个侧边栏:`scanStartPath`、`basePath`和`resolvePath`。每个选项都是可选的,但应根据具体情况正确使用。
+
+下文将对每个选项进行说明。但我们建议您首先参考[API](/zhHans/guide/api)页面上对每个选项的描述。
+
+以下描述基于以下示例：
+
+```text
+docs/
+├─ .vitepress/
+├─ guide/
+│  ├─ api/
+│  │  ├─ api-one.md
+│  │  └─ api-two.md
+│  ├─ one.md
+│  └─ two.md
+└─ config/
+   ├─ index.md
+   ├─ three.md
+   └─ four.md
+```
+
+### `scanStartPath`
+
+此选项用于为不同的路由规则指定不同的根目录。`documentRootPath`是实际要扫描的根目录(即`.vitepress`目录所在的位置),而`scanStartPath`是此路由规则中实际要显示的根目录。
+
+例如,若要仅包含`/guide`目录中的文件,请将`scanStartPath`的值指定为`guide`。但是,`documentRootPath`中的路径不应包含在内。
+
+### `resolvePath`
+
+VitePress使用此选项在遇到特定URI时显示相关菜单。例如,如果您想在到达`example.com/guide/api`时仅显示`guide/api`目录的内容,则`resolvePath`的值为`/guide/api`。建议您在路径前添加`/`。
+
+通常,它的值与 `scanStartPath` 类似,但有时您可能需要为 **i18n** 路由指定不同的值。
+
+### `basePath`
+
+此选项主要用于VitePress的重写规则,否则为可选。
+
+它取代了VitePress中`base`路径的值。如果未指定该值,则指定`resolvePath`的值或根路径(`/`)。
+
+如果目录的实际路径与URI中的路径结构不同,您应该能够通过重写功能导航到页面。通常情况下,侧边栏会根据根目录生成路径,而不会引用VitePress中的重写路径。
+
+例如,假设您有一个重写规则,如下所示:
+
+```javascript
+export default defineConfig({
+  rewrites: {
+    'guide/:page': 'help/:page'
+  },
+  themeConfig: {
+    sidebar: generateSidebar([
+      {
+        documentRootPath: 'docs',
+        scanStartPath: 'guide',
+        resolvePath: '/guide/'
+      }
+    ])
+  }
+});
+```
+
+`guide/one.md` 文档显示在 `help/one` 的路径中。但是,如果您这样做,侧边栏将不会显示菜单,因为它会尝试找到 `help/one`,而这是路径本身。
+
+要解决这个问题,请将`basePath`中的路径改为`help`:
+
+```javascript
+export default defineConfig({
+  rewrites: {
+    'guide/:page': 'help/:page'
+  },
+  themeConfig: {
+    sidebar: generateSidebar([
+      {
+        documentRootPath: 'docs',
+        scanStartPath: 'guide',
+        basePath: 'help', // <---------------------- Add this
+        resolvePath: '/guide/'
+      }
+    ])
+  }
+});
+```
+
+## 显示带有复杂路径和 URI 的菜单
+
+上面的例子通常是在路径按步骤定义的情况下，但当你想显示按步骤深入的文件夹时，特别是当 URI 较短或使用与实际文件夹路径不同的约定时，你需要使用额外的方法。例如，你有一个这样的文件夹结构：
+
+```
+docs/
+├─ guide/
+│  ├─ api/
+│  │  ├─ api-one.md
+│  │  └─ api-two.md
+│  ├─ one.md
+│  └─ two.md
+└─ config/
+   ├─ index.md
+   ├─ three.md
+   └─ four.md
+```
+
+这次,我们希望当到达单级 URI `/api` 时,在 `docs/guide/api` 中显示菜单。预期的菜单仅显示 `api-one.md` 和 `api-two.md`。
+
+```javascript
+generateSidebar([
+  {
+    documentRootPath: 'docs',
+    scanStartPath: 'guide/api',
+    resolvePath: '/api/'
+  }
+]);
+```
+
+但是,如果您这样配置选项,将无法显示菜单,因为`api`目录是`guide`的子目录。**VitePress**无法检测到这一点,并会导航到一个不存在的文档。
+
+要解决这个问题,您需要同时使用**VitePress的**路由功能,请参阅以下文章以获取说明:
+
+https://vitepress.dev/guide/routing#route-rewrites
+
+按照上面的示例,我们将把“重写`rewrites`**VitePress的**`config.js`文件中,该文件应位于`themeConfig`之外:
+
+```javascript
+export default defineConfig({
+  /* [START] Add This */
+  rewrites: {
+    'guide/api/:page': 'api/:page'
+  },
+  /* [END] Add This */
+  themeConfig: {
+    sidebar: generateSidebar([
+      {
+        documentRootPath: 'docs',
+        scanStartPath: 'guide/api',
+        resolvePath: '/api/'
+      }
+    ])
+  }
+});
+```
+
+现在，当 URI 路径以 `/api` 开头时，将显示 `docs/guide/api` 的子菜单！