环境准备
安装 node.js
进入 nodejs 官网下载安装包：
https://nodejs.org/en/download/
下载和安装步骤省略一万字……
安装好了之后可以测试一下：
npm -v 回显： 7.5.0
出现版本说明安装成功！
安装 docsify-cli
下一步通过 npm 命令安装 docsify-cli 工具
npm i docsify-cli -g
测试一下是否安装成功：
docsify -v 回显： docsify-cli version: 4.4.3
至此环境工具都已经安装完毕，下面正式开始搭建工作。
初始化工程目录
比如说我们想做一个 Java 项目，可以通过 IDEA 创建一个工程，那我们想搭建一个博客，这里可以直接用 docsify 命令行工具初始化一个功能即可。
执行 docsify init 命令（后面的目录大家可以根据情况自行更换）
docsify init ./leixiaoshuai-blog
初始化成功后回显：
Initialization succeeded! Please run docsify serve ./leixiaoshuai-blog
可以看到 ./leixiaoshuai-blog 目录下已经创建好了3个文件。
- index.html 入口文件
- README.md 会做为主页内容渲染
- .nojekyll 用于阻止 GitHub Pages 会忽略掉下划线开头的文件
小芝士：
Github Pages 默认是基于 Jekyll 构建，Jekyll 是一个将纯文本转换为静态网站的工具，它构建的网站下各种目录都是特定的以下划线开头命名的文件夹，例如 _layouts、_posts ，它会忽略掉其它的以下划线开头的文件夹和文件。
.nojekyll 就是告诉 Github Pages 当前网站不是基于 Jekyll 构建的，不要忽略掉下划线开头的文件和文件夹。
可见 .nojekyll 主要就是用于 Github Pages 这种有默认规则的网站部署平台，如果是部署在自己的服务器上，可以把它删掉。
反之，如果你的网站不是 Jekyll 构建的，要部署到 Github Pages ，并且包含下划线开头的文件或文件夹，那么你就需要在根目录添加一个 .nojekyll 空文件。
本地预览博客网站
在正式发布博客网站前我们可以在本地预览一下，类似于写代码的时候在本地调试。
docsify serve leixiaoshuai-blog
效果如下：
哈哈，好激动，博客的 hello world 已经出来啦~
但好像有点丑，没关系，我们一步一步优化，往下看。
定制化
多页文档
如果需要创建多个页面，或者需要多级路由的网站，在 docsify 里也能很容易的实现。
假设你的目录结构如下：
└── leixiaoshuai-blog ├── README.md ├── Java ├── README.md └── Go └── README.md
.那么对应的访问页面将是
leixiaoshuai-blog/README.md => http://xxx.com leixiaoshuai-blog/Java/README.md => http://xxx.com/Java/ leixiaoshuai-blog/Go/README.md => http://xxx.com/Go/
有了多个页面，你肯定需要一个侧边栏，点击不同的链接可以跳到不同的页面，配置方法如下：
步骤一：配置 loadSidebar 选项，开始侧边栏
<!-- index.html --> <script> window.$docsify = { loadSidebar: true } </script> <script src="//cdn.jsdelivr.net/npm/docsify/lib/docsify.min.js"></script>
步骤二：在项目根目录下创建 _sidebar.md 文件，内容如下
<!-- leixiaoshuai-demo/_sidebar.md --> * [Java 学习](Java/) * [Go 学习](Go/)
需要在 ./leixiaoshuai-blog 目录创建 .nojekyll 命名的空文件，阻止 GitHub Pages 忽略命名是下划线开头的文件。如果已存在该文件，这里可以忽略。
效果预览：
添加封面
docsify 还支持在博客的首页加一个欢迎封面，我们试着加一下。
步骤一：打开配置开关
<!-- index.html --> <script> window.$docsify = { coverpage: true } </script> <script src="//cdn.jsdelivr.net/npm/docsify/lib/docsify.min.js"></script>
步骤二：在项目的根目录下新创建一个 _coverpage.md 文件，文件命名不要漏了下划线。
源码参考如下：
<!-- _coverpage.md --> # 欢迎来到程序员雷小帅的博客 - 公众号：爱笑的架构师 - B站: 程序员雷小帅 [Gitee](http://coderleixiaoshuai.gitee.io/java-eight-part/#/) [Get Started](#leixiaoshuai-blog)
效果预览：
更换主题
docsify 官方默认提供了5 套主题，默认是 vue 风格的，大家可以根据喜好自行更换。
<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/themes/vue.css"> <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/themes/buble.css"> <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/themes/dark.css"> <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/themes/pure.css"> <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/themes/dolphin.css">
我们选择一个暗黑风格的进行演示，在 index.htm 头部中引用以下的 css 文件，记得把老的注释掉。
<!-- index.html --> <!-- Theme: Dark --> <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/themes/dark.css">
本地预览看一下效果：
自定义插件
搜索框
全文搜索插件会根据当前页面上的超链接获取文档内容，在 localStorage 内建立文档索引。默认过期时间为一天，当然我们可以自己指定需要缓存的文件列表或者配置过期时间。
配置代码如下：
<!-- index.html --> search: { maxAge: 86400000, // 过期时间，单位毫秒，默认一天 paths: [], // or 'auto' placeholder: '请输入关键字搜索', noData: '找不到结果!', // 搜索标题的最大层级, 1 - 6 depth: 2 }
效果展示：
字数统计
这是一款为docsify提供文字统计的插件。
它提供了统计中文汉字和英文单词的功能，并且排除了一些markdown语法的特殊字符例如*、-等。
步骤一：添加 js
<!-- index.html --> <script src="//unpkg.com/docsify-count/dist/countable.js"></script>
步骤二：添加配置
<!-- index.html --> window.$docsify = { count:{ countable:true, fontsize:'0.9em', color:'rgb(90,90,90)', language:'chinese' } }
效果展示
右上角会出现字数统计和预估阅读时间。
部署到 Gitee
好了，个人博客网站已经配置差不多了，本地也能预览看到效果了。
但是问题来了，如何把网站部署到外网上去供其他技术小伙伴看呢？买阿里云服务器？好像有点费钱。
那有没有免费可以白嫖的方式？当然有了，答案就是 Gitee Pages 。我们可以把博客代码推送到 Gitee 仓库中，然后开启 Pages 配置就可以通过外网访问啦~
开干吧……
创建 Gitee 仓库
Gitee 中文名是码云，可以理解为中国版的 Github，没用过的小伙伴先自行注册一个账号吧。
新建代码仓：
推送本地博客项目代码
我们先将本地的工程初始化为一个 Git 仓库。
cd leixiaoshuai-blog git init git add . git commit -m "first commit"
Git 仓库初始化完毕，开始推送代码至远端。
git remote add origin https://gitee.com/CoderLeixiaoshuai/leixiaoshuai-blog.git git push -u origin master
这一步可能需要输入用户名和密码，或者大家百度搜一下如何配置公钥私钥。
开启 pages
代码推送成功后，我们就可以正式开始部署项目了。
进入代码仓，点击 Gitee Pages
点击部署，部署成功后会显示访问地址
注意：
首次部署可能需要实名认证，大家安装要求提供身份证照片和手持身份证照片，一般 24 小时之内就可以审核通过了，大家耐心等待一下吧。
参考文档：
（1）更多玩法可以参考官网的教程文档：
https://docsify.js.org/#/zh-cn/
（2）如果还有不熟悉的可以参考视频教程
https://www.bilibili.com/video/BV1AQ4y1q7eB/
总结
不花一分钱，全靠白嫖就可以搭建属于自己的个人博客，真是太香了。
大家可以参考我已经搭建好的个人技术博客：
个人技术博客网站
Description
http://coderleixiaoshuai.gitee.io/java-eight-part/#/
还愣着干啥，赶紧动手吧。
后面还会给大家分享如何绑定个人域名，想看的小伙伴三连支持一下吧。
