docsify网站文档工具用法总结

docsify,网站文档动态生成工具，类似gitbook

npm i docsify-cli -g

进入项目根目录并初始化

docsify init ./docs

之后docs目录下会生成以下几个文件

index.html 入口文件
README.md 会做为主页内容渲染
.nojekyll 用于阻止 GitHub Pages 会忽略掉下划线开头的文件

运行服务

docsify serve ./docs

打开浏览器

设置 coverpage 参数

window.$docsify = {
    coverpage: true
  }

接着在根目录创建 _coverpage.md 文件

默认的背景是随机生成的渐变色

如要自定义背景图片或者背景色，在_coverpage.md中设置如下内容

<h3 id="自定义导航栏">自定义导航栏

直接在 HTML 里定义导航栏，链接以 #/ 开头

在index.html的body中添加以下代码

接着配置 loadNavbar

window.$docsify = {
    loadNavbar: true
  }

在navbar.md_中添加以下链接

* [En](/)
* [中文](/zh-cn/)

默认侧边栏会根据当前文档的标题生成目录。也可以设置文档链接，通过 Markdown 文件生成

先配置 loadSidebar 选项

window.$docsify = {
    loadSidebar: true
  }

然后创建 _sidebar.md 文件，这样我们左侧目录就会显示出来

* [首页](zh-cn/)
* [指南](zh-cn/guide)

需要在文档根目录创建 .nojekyll 命名的空文件，阻止 GitHub Pages 忽略命名是下划线开头的文件。

添加全文搜索引入search.js



<script src="//unpkg.com/gitalk/dist/gitalk.min.js">

猜你在找的Git相关文章