Update docs (#23)

This commit is contained in:
沈唁 2020-08-21 20:21:28 +08:00 committed by GitHub
parent cefb56f9c7
commit c83adf75d8
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
4 changed files with 34 additions and 7 deletions

3
cdn.md
View File

@ -52,7 +52,8 @@ CSS 的压缩文件位于 `/lib/themes/` 目录下JS 的压缩文件是原有
## 其他 CDN
- http://www.bootcdn.cn/docsify (支持国内)
- https://www.bootcdn.cn/docsify/ (支持国内)
- https://cdn.jsdelivr.net/npm/docsify/ (国内外都支持)
- https://cdnjs.com/libraries/docsify
- https://unpkg.com/browse/docsify/

View File

@ -59,6 +59,14 @@ docsify 扩展了一些 Markdown 语法,可以让文档更易读。
[link](/demo ':disabled')
```
## 跨域链接
只有当你同时设置了 `routerMode: 'history'``externalLinkTarget: '_self'` 时,你需要为这些跨域链接添加这个配置。
```md
[example.com](https://example.com/ ':crossorgin')
```
## Github 任务列表
```md
@ -100,6 +108,7 @@ docsify 扩展了一些 Markdown 语法,可以让文档更易读。
```md
![logo](https://docsify.js.org/_media/icon.svg ':class=someCssClass')
```
### 设置图片的 ID
```md

View File

@ -101,24 +101,24 @@ docs/zh-cn/guide.md => http://domain.com/zh-cn/guide
## 忽略副标题
当设置了 `subMaxLevel` 时,默认情况下每个标题都会自动添加到目录中。如果你想忽略特定的标题,可以给它添加  `{docsify-ignore}` 。
当设置了 `subMaxLevel` 时,默认情况下每个标题都会自动添加到目录中。如果你想忽略特定的标题,可以给它添加 `<!-- {docsify-ignore} -->` 。
```markdown
# Getting Started
## Header {docsify-ignore}
## Header <!-- {docsify-ignore} -->
该标题不会出现在侧边栏的目录中。
```
要忽略特定页面上的所有标题,你可以在页面的第一个标题上使用 `{docsify-ignore-all}` 。
要忽略特定页面上的所有标题,你可以在页面的第一个标题上使用 `<!-- {docsify-ignore-all} -->` 。
```markdown
# 入门 {docsify-ignore-all}
# Getting Started <!-- {docsify-ignore-all} -->
## 标题
## Header
该标题不会出现在侧边栏的目录中。
```
在使用时, `{docsify-ignore}` 和 `{docsify-ignore-all}` 都不会在页面上呈现。
在使用时, `<!-- {docsify-ignore} -->` 和 `<!-- {docsify-ignore-all} -->` 都不会在页面上呈现。

View File

@ -38,6 +38,23 @@
// 搜索标题的最大层级, 1 - 6
depth: 2,
hideOtherSidebarContent: false, // 是否隐藏其他侧边栏内容
// 避免搜索索引冲突
// 同一域下的多个网站之间
namespace: 'website-1',
// 使用不同的索引作为路径前缀namespaces
// 注意:仅适用于 paths: 'auto' 模式
//
// 初始化索引时,我们从侧边栏查找第一个路径
// 如果它与列表中的前缀匹配,我们将切换到相应的索引
pathNamespaces: ['/zh-cn', '/ru-ru', '/ru-ru/v1'],
// 您可以提供一个正则表达式来匹配前缀。在这种情况下,
// 匹配到的字符串将被用来识别索引
pathNamespaces: /^(\/(zh-cn|ru-ru))?(\/(v1|v2))?/
}
}
</script>