Skip to content

New Crowdin Translations #54

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 1 commit into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 7 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,32 +1,30 @@
## docsify
## 对齐化

> 一个神奇的文档网站生成器。

## 概述
## 什么是

docsify 可以快速帮你生成文档网站。不同于 GitBook、Hexo 的地方是它不会生成静态的 `.html` 文件,所有转换工作都是在运行时。如果你想要开始使用它,只需要创建一个 `index.html` 就可以开始编写文档并直接[部署在 GitHub Pages](zh-cn/deploy.md)。
虚拟生成您的文档网站。 docsify 可以快速帮你生成文档网站。不同于 GitBook、Hexo 的地方是它不会生成静态的 `.html` 文件,所有转换工作都是在运行时。如果你想要开始使用它,只需要创建一个 `index.html` 就可以开始编写文档并直接[部署在 GitHub Pages](zh-cn/deploy.md)。 相反,它智能地加载和解析您的Markdown文件并将其显示为网站。 要开始使用它,您需要创建一个 `index.html` 并[部署在 GitHub Pages](deption.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:

## 社区

在 [Discord](https://discord.gg/3NwKFyR) 的社区里可以找到 docsify 的用户和开发者团队
用户和开发团队通常在[Discord服务器](https://discord.gg/3NwKFyR)。
45 changes: 23 additions & 22 deletions _sidebar.md
Original file line number Diff line number Diff line change
@@ -1,28 +1,29 @@
* 入门
- 入门

* [快速开始](zh-cn/quickstart.md)
* [多页文档](zh-cn/more-pages.md)
* [定制导航栏](zh-cn/custom-navbar.md)
* [封面](zh-cn/cover.md)
- [快速开始](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/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](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)
* [服务端渲染 (SSR)](zh-cn/ssr.md)
* [文件嵌入](zh-cn/embed-files.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)

* [Awesome docsify](zh-cn/awesome.md)
* [Changelog](zh-cn/changelog.md)
- [Awesome docsify](zh-cn/awesome.md)

- [Changelog](zh-cn/changelog.md)
71 changes: 35 additions & 36 deletions cdn.md
Original file line number Diff line number Diff line change
@@ -1,59 +1,58 @@
# CDN

推荐使用 [jsDelivr](//cdn.jsdelivr.net),能及时获取到最新版。你也可以在[cdn.jsdelivr.net/npm/docsify/](cdn.jsdelivr.net/npm/docsify/)中浏览npm包的源代码
文档化[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">
## 获取指定版本

<!-- 引入 script -->
<script src="//cdn.jsdelivr.net/npm/[email protected]/lib/docsify.min.js"></script>
```
指定一个准确的版本可以防止将来的任何更新影响您的网站。 对于那些愿意在发布新版本时手动更新资源的人来说,这是一个很好的选项。

## 其他 CDN
?> 新版本发布后,您需要在您的 CDN URL中的 '@' 符号后手动更新版本号。

- 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>
```
Loading