New Crowdin translations by GitHub Action

README.md

@@ -1,31 +1,29 @@
-## docsify
+# docsify
 
 > 一个神奇的文档网站生成器。
 
 ## 概述
 
-docsify 可以快速帮你生成文档网站。不同于 GitBook、Hexo 的地方是它不会生成静态的 `.html` 文件，所有转换工作都是在运行时。如果你想要开始使用它，只需要创建一个 `index.html` 就可以开始编写文档并直接[部署在 GitHub Pages](zh-cn/deploy.md)。
+docsify 可以快速帮你生成文档网站。 不同于 GitBook 的地方是它不会生成静态的 `.html` 文件。 相反，它能智能加载和解析 Markdown 文件，并将其显示为网站。 要开始使用它，只需创建一个 `index.html` 并将其[部署到 GitHub Pages](zh-cn/deploy.md)。
 
 查看[快速开始](zh-cn/quickstart.md)了解详情。
 
 ## 特性
 
-- 无需构建，写完文档直接发布
-- 容易使用并且轻量 (压缩后 ~21kB)
+- 没有静态生成的 html 文件
+- 简单和轻量
 - 智能的全文搜索
 - 提供多套主题
 - 丰富的 API
 - 支持 Emoji
-- 兼容 IE11
-- 支持服务端渲染 SSR ([示例](https://github.com/docsifyjs/docsify-ssr-demo))
 
 ## 示例
 
 可以查看 [Showcase](https://github.com/docsifyjs/docsify/#showcase) 来了解更多在使用 docsify 的文档项目。
 
 ## 捐赠
 
-如果你觉得 docsify 对你有帮助，或者想对我微小的工作一点资瓷，欢迎给我[捐赠](https://github.com/QingWei-Li/donate)。
+如果你认为 docsify 对你有帮助，或者我的工作有价值，请考虑捐赠。 欢迎帮我[买杯咖啡](https://github.com/QingWei-Li/donate)。 :heart:
 
 ## 社区
 

_sidebar.md

@@ -1,28 +1,32 @@
-* 入门
-
-  * [快速开始](zh-cn/quickstart.md)
-  * [多页文档](zh-cn/more-pages.md)
-  * [定制导航栏](zh-cn/custom-navbar.md)
-  * [封面](zh-cn/cover.md)
-
-* 定制化
-
-  * [配置项](zh-cn/configuration.md)
-  * [主题](zh-cn/themes.md)
-  * [插件列表](zh-cn/plugins.md)
-  * [开发插件](zh-cn/write-a-plugin.md)
-  * [Markdown 配置](zh-cn/markdown.md)
-  * [代码高亮](zh-cn/language-highlight.md)
-
-* 指南
-
-  * [部署](zh-cn/deploy.md)
-  * [文档助手](zh-cn/helpers.md)
-  * [兼容 Vue](zh-cn/vue.md)
-  * [CDN](zh-cn/cdn.md)
-  * [离线模式(PWA)](zh-cn/pwa.md)
-  * [服务端渲染 (SSR)](zh-cn/ssr.md)
-  * [文件嵌入](zh-cn/embed-files.md)
-
-* [Awesome docsify](zh-cn/awesome.md)
-* [Changelog](zh-cn/changelog.md)
+<!-- markdownlint-disable first-line-h1 -->
+
+- 入门
+
+  - [快速开始](zh-cn/quickstart.md)
+  - [添加页面](zh-cn/adding-pages.md)
+  - [封面](zh-cn/cover.md)
+  - [定制导航栏](zh-cn/custom-navbar.md)
+
+- 定制化
+
+  - [配置项](zh-cn/configuration.md)
+  - [主题](zh-cn/themes.md)
+  - [插件列表](zh-cn/plugins.md)
+  - [开发插件](zh-cn/write-a-plugin.md)
+  - [Markdown 配置](zh-cn/markdown.md)
+  - [代码高亮](zh-cn/language-highlight.md)
+  - [Emoji](zh-cn/emoji.md)
+
+- 指南
+
+  - [部署](zh-cn/deploy.md)
+  - [文档助手](zh-cn/helpers.md)
+  - [兼容 Vue](zh-cn/vue.md)
+  - [CDN](zh-cn/cdn.md)
+  - [离线模式(PWA)](zh-cn/pwa.md)
+  - [文件嵌入](zh-cn/embed-files.md)
+  - [UI Kit](zh-cn/ui-kit.md)
+
+- [Awesome docsify](zh-cn/awesome.md)
+
+- [Changelog](zh-cn/changelog.md)

adding-pages.md

@@ -0,0 +1,156 @@
+# 添加页面
+
+如果你需要更多页面，你可以简单地在 docsify 目录中创建更多 markdown 文件。 如果创建了名为 `guide.md` 的文件，则可通过 `/#/guide` 访问该文件。
+
+例如，目录结构如下：
+
+```text
+.
+└── docs
+    ├── README.md
+    ├── guide.md
+    └── zh-cn
+        ├── README.md
+        └── guide.md
+```
+
+匹配路由
+
+```text
+docs/README.md        => http://domain.com
+docs/guide.md         => http://domain.com/#/guide
+docs/zh-cn/README.md  => http://domain.com/#/zh-cn/
+docs/zh-cn/guide.md   => http://domain.com/#/zh-cn/guide
+```
+
+## 侧边栏
+
+为了拥有侧边栏，你可以创建自己的侧边栏 `_sidebar.md`（有关示例，请参阅[本文档的侧边栏](https://github.com/docsifyjs/docsify/blob/main/docs/_sidebar.md)）：
+
+首先，你需要设置为 `loadSidebar` 为 **true**。 详情请参见[配置段落](zh-cn/configuration#loadsidebar)。
+
+```html
+<!-- index.html -->
+
+<script>
+  window.$docsify = {
+    loadSidebar: true,
+  };
+</script>
+<script src="//cdn.jsdelivr.net/npm/docsify@5/dist/docsify.min.js"></script>
+```
+
+创建 `_sidebar.md`：
+
+```markdown
+<!-- docs/_sidebar.md -->
+
+- [Home](/)
+- [Page 1](page-1.md)
+```
+
+创建章节标题：
+
+```markdown
+<!-- docs/_sidebar.md -->
+
+- Section Header 1
+
+  - [Home](/)
+  - [Page 1](page-1.md)
+
+- Section Header 2
+
+  - [Page 2](page-2.md)
+  - [Page 3](page-3.md)
+```
+
+需要在 `./docs` 目录创建 `.nojekyll` 命名的空文件，阻止 GitHub Pages 忽略命名是下划线开头的文件。
+
+!> Docsify 只查找当前文件夹中的 `_sidebar.md`，并使用它，否则会返回到使用 `window.$docsify.loadSidebar` 配置。
+
+示例文件结构：
+
+```text
+└── docs/
+    ├── _sidebar.md
+    ├── index.md
+    ├── getting-started.md
+    └── running-services.md
+```
+
+## 嵌套侧边栏
+
+你可能希望侧边栏在导航后更新以反映当前目录。 这可以通过在每个文件夹中添加一个 `_sidebar.md` 文件来实现。
+
+`_sidebar.md` 会从每一级目录加载。 如果当前目录中没有 `_sidebar.md`，则会返回上一级目录。 例如，如果当前路径是 `/guide/quick-start`，则将从 `/guide/_sidebar.md` 加载 `_sidebar.md`。
+
+你可以指定 `alias` 以避免不必要的回退。
+
+```html
+<script>
+  window.$docsify = {
+    loadSidebar: true,
+    alias: {
+      '/.*/_sidebar.md': '/_sidebar.md',
+    },
+  };
+</script>
+```
+
+!> 你可以在一个子目录中创建一个 `README.md` 文件来作为路由的默认网页。
+
+## 用侧边栏中选定的条目名称作为页面标题
+
+页面的 `title` 标签是根据_选定的_侧边栏项目名称生成的。 为了更好地进行搜索引擎优化，你可以在文件名后指定一个字符串来自定义标题。
+
+```markdown
+<!-- docs/_sidebar.md -->
+
+- [Home](/)
+- [Guide](guide.md 'The greatest guide in the world')
+```
+
+## 目录
+
+创建 `_sidebar.md` 后，侧边栏内容将根据 markdown 文件中的标题自动生成。
+
+自定义侧边栏还可以通过设置 `subMaxLevel` 自动生成目录，请比较 [subMaxLevel 配置](zh-cn/configuration#submaxlevel)。
+
+```html
+<!-- index.html -->
+
+<script>
+  window.$docsify = {
+    loadSidebar: true,
+    subMaxLevel: 2,
+  };
+</script>
+<script src="//cdn.jsdelivr.net/npm/docsify@5/dist/docsify.min.js"></script>
+```
+
+## 忽略副标题
+
+当设置了 `subMaxLevel` 时，默认情况下每个标题都会自动添加到目录中。 如果你想忽略特定的标题，可以给它添加 `<!-- {docsify-ignore} -->` 。
+
+```markdown
+# Getting Started
+
+## Header <!-- {docsify-ignore} -->
+
+该标题不会出现在侧边栏目录中。
+```
+
+要忽略特定页面上的所有标题，你可以在页面的第一个标题上使用 `<!-- {docsify-ignore-all} -->` 。
+
+```markdown
+# Getting Started <!-- {docsify-ignore-all} -->
+
+## Header
+
+该标题不会出现在侧边栏的目录中。
+```
+
+在使用时，`<!-- {docsify-ignore} -->` 和 `<!-- {docsify-ignore-all} -->` 都不会在页面上呈现。
+
+`{docsify-ignore}` 和 `{docsify-ignore-all}` 也可以做同样的事情。

cdn.md

@@ -1,59 +1,58 @@
 # CDN
 
-推荐使用 [jsDelivr](//cdn.jsdelivr.net)，能及时获取到最新版。你也可以在[cdn.jsdelivr.net/npm/docsify/](cdn.jsdelivr.net/npm/docsify/)中浏览npm包的源代码。
+Docsify 的 [npm package](https://www.npmjs.com/package/docsify) 是随着每个版本自动发布到 CDN 中的。 内容可以在每个 CDN 上查看。
 
-## 获取最新版本
+Docsify 推荐 [jsDelivr](//cdn.jsdelivr.net) 为其首选的 CDN：
 
-不指定特定版本号时将引入最新版。
+- https://cdn.jsdelivr.net/npm/docsify/ (国内外都支持)
 
-```html
-<!-- 引入 css -->
-<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/themes/vue.css">
+在没有 jsDelivr 的地方，也可能需要其他的 CDN：
 
-<!-- 引入 script -->
-<script src="//cdn.jsdelivr.net/npm/docsify/lib/docsify.js"></script>
-```
+- https://cdnjs.com/libraries/docsify
+- https://unpkg.com/browse/docsify/
+- https://www.bootcdn.cn/docsify/ (支持国内)
 
-也可以使用 [压缩版文件](#compressed-file).
+## 指定版本
 
-## 获取指定版本
+请注意以下 CDN URL 中的`@`版本锁定。 这样就可以指定最新的主版本、次版本、补丁或特定 [semver](https://semver.org) 版本号。
 
-如果担心频繁地版本更新又可能引入未知 Bug，我们也可以使用具体的版本。规则是 `//cdn.jsdelivr.net/npm/docsify@VERSION/`
+- MAJOR 版本包括不兼容变更<br>
+  `1.0.0` → `2.0.0`
+- MINOR 版本包括兼容性的新功能<br>
+  `1.0.0` → `1.1.0`
+- PATCH版本包括兼容性的错误修复<br>
+  `1.0.0` → `1.0.1`
 
-```html
-<!-- 引入 css -->
-<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/[email protected]/themes/vue.css">
+从文件名中移除`.min`，可获取未压缩的资源。
 
-<!-- 引入 script -->
-<script src="//cdn.jsdelivr.net/npm/[email protected]/lib/docsify.js"></script>
-```
+## 最新主要版本
 
-!> 指定 *VERSION* 为 `latest` 可以强制每次都请求最新版本。
+指定最新的主要版本允许您的网站在发布时接收所有非破坏性的增强("次级"更新)和错误修复("补丁"更新)。 对于那些倾向于零维护又可以随着新版本的发布更新其网站的风险最小化的人来说，这是一个好的选择。
 
-## 压缩版
+?> 发布新的主要版本时，你需要在你的 CDN URLs 中的 `@` 符号后手动更新主要版本号。
 
-CSS 的压缩文件位于 `/lib/themes/` 目录下，JS 的压缩文件是原有文件路径的基础上加 `.min` 后缀。
+<!-- prettier-ignore -->
 
 ```html
-<!-- 引入 css -->
-<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/lib/themes/vue.css">
+<!-- 主题 -->
+<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify@5/themes/vue.min.css" />
 
-<!-- 引入 script -->
-<script src="//cdn.jsdelivr.net/npm/docsify/lib/docsify.min.js"></script>
+<!-- Docsify -->
+<script src="//cdn.jsdelivr.net/npm/docsify@5/dist/docsify.min.js"></script>
 ```
 
-```html
-<!-- 引入 css -->
-<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/[email protected]/lib/themes/vue.css">
+## 获取指定版本 :id=specific-version
 
-<!-- 引入 script -->
-<script src="//cdn.jsdelivr.net/npm/[email protected]/lib/docsify.min.js"></script>
-```
+指定一个准确的版本可以防止将来的任何更新影响你的网站。 对于那些愿意在发布新版本时手动更新资源的人来说，这是一个很好的选项。
 
-## 其他 CDN
+?> 新版本发布后，你需要在你的 CDN URLs 中的 '@' 符号后手动更新版本号。
 
-- https://www.bootcdn.cn/docsify/ (支持国内)
-- https://cdn.jsdelivr.net/npm/docsify/ (国内外都支持)
-- https://cdnjs.com/libraries/docsify
-- https://unpkg.com/browse/docsify/
+<!-- prettier-ignore -->
+
+```html
+<!-- 主题 -->
+<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/[email protected]/themes/vue.min.css" />
 
+<!-- Docsify -->
+<script src="//cdn.jsdelivr.net/npm/[email protected]/dist/docsify.min.js"></script>
+```