Update deploy and embed-files (#30)
* Update deploy and embed-files * Update
This commit is contained in:
parent
0d210dec78
commit
8db3d39d0a
|
@ -22,7 +22,7 @@
|
|||
* [CDN](zh-cn/cdn.md)
|
||||
* [离线模式(PWA)](zh-cn/pwa.md)
|
||||
* [服务端渲染 (SSR)](zh-cn/ssr.md)
|
||||
* [文件嵌入<sup style="color:red">(new)<sup>](zh-cn/embed-files.md)
|
||||
* [文件嵌入](zh-cn/embed-files.md)
|
||||
|
||||
* [Awesome docsify](zh-cn/awesome.md)
|
||||
* [Changelog](zh-cn/changelog.md)
|
||||
|
|
|
@ -38,6 +38,10 @@ pages:
|
|||
|
||||
!> 你可以用 `- cp -r docs/. public` 替换脚本, 如果 `./docs` 是你的 docsify 子文件夹。
|
||||
|
||||
## Gitee Pages
|
||||
|
||||
在对应的 Gitee 仓库服务中选择 `Gitee Pages`,选择您要部署的分支,填写您要部署的分支上的目录,例如`docs`,填写完成之后点击启动即可。
|
||||
|
||||
## Firebase 主机
|
||||
|
||||
!> 你需要先使用谷歌账号登陆 [Firebase 控制台](https://console.firebase.google.com) ,然后使用 `npm i -g firebase-tools` 命令安装 Firebase CLI 。
|
||||
|
|
|
@ -73,4 +73,79 @@ docsify 4.6 开始支持嵌入任何类型的文件到文档里。你可以将
|
|||
|
||||
[](../_media/example.html ':include :type=code text')
|
||||
|
||||
?> 如何高亮代码?你可以查看[这份文档](zh-cn/language-highlight.md).
|
||||
?> 如何高亮代码?你可以查看[这份文档](zh-cn/language-highlight.md)。
|
||||
|
||||
## 嵌入Gist
|
||||
|
||||
你可以将 Gist 作为 Markdown 内容或代码块嵌入。这是基于[嵌入文件](#embed-files)部分开头的方法,不过是嵌入一个原始的 Gist URL。
|
||||
|
||||
?> 这里**不需要**插件或修改配置来使其工作。事实上,即使你使用插件或修改配置来允许加载外部脚本,从 Gist 复制的 "Embed" `script`标签也无法加载。
|
||||
|
||||
### 确定Gist的元数据
|
||||
|
||||
从查看`gist.github.com`上的 Gist 开始。在本指南中,我们使用这个 Gist:
|
||||
|
||||
- https://gist.github.com/anikethsaha/f88893bb563bb7229d6e575db53a8c15
|
||||
|
||||
从 Gist 中找出以下内容:
|
||||
|
||||
| 字段 | 示例 | 说明 |
|
||||
| ------------ | ---------------------------------- | ------------------------------------------------------------------- |
|
||||
| **Username** | `anikethsaha` | Gist 的作者 |
|
||||
| **Gist ID** | `c2bece08f27c4277001f123898d16a7c` | Gist 的标识符。该标识在 Gist 的有效期内是固定的 |
|
||||
| **Filename** | `content.md` | 在 Gist 中选择一个文件名。即使是单文件的 Gist,也需要这样做才能嵌入 |
|
||||
|
||||
你将需要这些来为目标文件建立 _raw gist URL_ 。它的格式如下:
|
||||
|
||||
- `https://gist.githubusercontent.com/USERNAME/GIST_ID/raw/FILENAME`
|
||||
|
||||
下面是根据示例 Gist 举出的两个例子:
|
||||
|
||||
- https://gist.githubusercontent.com/anikethsaha/f88893bb563bb7229d6e575db53a8c15/raw/content.md
|
||||
- https://gist.githubusercontent.com/anikethsaha/f88893bb563bb7229d6e575db53a8c15/raw/script.js
|
||||
|
||||
?> 另外你也可以直接点击 Gist 文件上的 _Raw_ 按钮来获取原始 URL。但是如果你使用这种方法,请确保**删除**`raw/`和文件名之间的修订号,这样 URL 就会与上面的模式一致。否则当更新 Gist 时,你嵌入的 Gist 将**不会**显示最新的内容。
|
||||
|
||||
继续下面的一个部分,将 Gist 嵌入到 Docsify 页面上。
|
||||
|
||||
### 渲染 Gist 中的 Markdown 内容
|
||||
|
||||
这是一个很好的方法,可以将内容**无缝**地嵌入到你的文档中,而不需要将别人发送到外部链接。这种方法很适合在多个仓库的文档网站上重复使用一个 Gist,比如安装说明。这种方法同样适用于您的账户或其他用户拥有的 Gist。
|
||||
|
||||
格式:
|
||||
|
||||
```markdown
|
||||
[LABEL](https://gist.githubusercontent.com/USERNAME/GIST_ID/raw/FILENAME ':include')
|
||||
```
|
||||
|
||||
例如:
|
||||
|
||||
```markdown
|
||||
[gist: content.md](https://gist.githubusercontent.com/anikethsaha/f88893bb563bb7229d6e575db53a8c15/raw/content.md ':include')
|
||||
```
|
||||
|
||||
你会看到:
|
||||
|
||||
[gist: content.md](https://gist.githubusercontent.com/anikethsaha/f88893bb563bb7229d6e575db53a8c15/raw/content.md ':include')
|
||||
|
||||
`LABEL`可以是任何你想要的文本。如果链接被破坏,它可以作为一个 _fallback_ 信息。所以在这里重复文件名是很有用的,万一你需要修复一个破坏的链接。它还可以使嵌入的元素一目了然。
|
||||
|
||||
### 渲染 Gist 中的代码块
|
||||
|
||||
格式与上一节相同,但是在alt文本中添加了`:type=code`。与[嵌入的类型](#embedded-file-type)部分一样,语法高亮将从扩展名(如`.js`或`.py`)中**推断**,所以你可以将`type`设置为`code`。
|
||||
|
||||
格式:
|
||||
|
||||
```markdown
|
||||
[LABEL](https://gist.githubusercontent.com/USERNAME/GIST_ID/raw/FILENAME ':include :type=code')
|
||||
```
|
||||
|
||||
例如:
|
||||
|
||||
```markdown
|
||||
[gist: script.js](https://gist.githubusercontent.com/anikethsaha/f88893bb563bb7229d6e575db53a8c15/raw/script.js ':include :type=code')
|
||||
```
|
||||
|
||||
你会看到:
|
||||
|
||||
[gist: script.js](https://gist.githubusercontent.com/anikethsaha/f88893bb563bb7229d6e575db53a8c15/raw/script.js ':include :type=code')
|
||||
|
|
Loading…
Reference in New Issue