docsify - 一个优雅的静态文档生成器

docsify好在哪里

docsify相比于其他的静态文档站点生成器相比更加的简洁，易用。

先拿Sphinx来说吧，Sphinx因背后有python的驱动，功能十分强大，但是rst的语法还是比较复杂的

vuepress更适合大型项目的文档编写，而且维护成本高。

全局安装Docsify-cli:

本文不再对配置方面进行过多的论述，可以参考配置项 (docsify.js.org)

docsify会自动识别目录下的所有markdown文件，所以在docs目录新增markdown文件即可编写文档

这里要注意一下路径：

假设你的目录结构如下：

那么渲染后的路径就是：

将Github Pages的工作目录设置到docsify所在目录。

选中docsify所在仓库，点击下面的deploy

将docsify所在文件夹上传到网站目录即可