爱了！Guide哥手把手教你搭建一个文档类型的网站！免费且高速这篇文章Guide哥就手把手教大家搭建一

文章插图
这篇文章 Guide 哥就手把手教大家搭建一个像下面这样的文档类型的网站，你可以用来当做项目的说明文档，也还可以当做自己专属的知识小仓库。
文章插图
官网教程的也很详细了，地址在这里：#/zh-cn/quickstart，不过我的这篇教程比较贴合实际使用。
下面演示的所有内容的源文件在这里：https://github.com/Snailclimb/docsify-demo
最终效果展示地址：#/
一.前置条件

确保自己电脑下载安装了 NPM 并且使用这个命令： npm i docsify-cli -g安装了 docsify-cli 这个工具。
确保自己有一个 Github 账号（码云账号为非必选项，有的话更好）。

二.初始化项目并预览1.新建一个文件夹：mkdir docsify-demo
2.进入文件夹并运行 docsify 初始化命令：cd docsify-demo -> docsify init ./
你会发现 docsify-demo 文件夹下面多了下面这些文件，一一为你解释一下它们是干嘛的！

文章插图
3.本地预览网站：docsify serve ./ 然后访问：http://localhost:3000/

文章插图
三.给我们的项目增加点颜色

文章插图
建议 clone 一下我的仓库：，在本地运行一下，这是一个比较典型的使用 docsify 搭建的网站，可以作为参考。如果你们想搭建一个不错的文档网站的话，可以在我的这个基础上去改。
3.1 修改配置文件 index.html主要配置了文档网站的名字以及开启了一些配置选项。
docsify-demo3.2 添加侧边栏文件在第一步中，我们在已经开启了侧边栏选项：
loadSidebar: true但是，仅仅这样还不行，我们需要定义一个名为 _sidebar.md的文件，文件的内容就是我们侧边栏的内容。
如下图所示，我们定义了一个侧边栏，并且为它添加了一些内容：
一般建议将文档放进 docs 文件下面，可以参考我的仓库：