Docsify静态博客网站搭建

参考：5分钟搭建个人博客平台 (qingfengpython.cn)

Docsify是一个搭建静态博客的工具，可以将markdown文章搭建成博客网站，供别人访问。

安装

1、下载nodejs

下载 | Node.js 中文网

2、安装docsify 

Nodejs下的npm命令安装Docsify了，但再次之前，你需要配置一下npm的淘宝仓库地址 

# 使用淘宝镜像
npm config set registry https://registry.npm.taobao.org
# 验证是否ok
npm config get registry

使用 npm i docsify-cli -g命令完成安装即可。

安装完成后，输入docsify -v 来查看是否安装ok

 创建仓库

这里推荐在Gitee - 基于 Git 的代码托管和研发协作平台

创建仓库，clone到本地，并且完成第一次push（需要git知识）

mkdir BlogTest
cd BlogTest
git init
touch README.md
echo # BreezePython >> README.md
git add README.md
git commit -m "first commit"
git remote add origin https://gitee.com/BreezePython/BlogTest.git
git push -u origin master

初始化博客

在博客目录下执行初始化操作

docsify init . 然后输入y 进行确认，此时我们就创建好了初始目录

index.html文件，就是Docsify唯一的配置文件。我们只需要维护这个入口html文件，即可完成所有的博客搭建操作

启动博客服务

docsify serve . 访问http://localhost:3000/

 博客配置

在index.html中进行博客配置，添加修改页面主题，插件，可以参考官网，或者我上面参考的网站进行个性化配置。

docsify

 _coverpage.md的文件，写入的内容可以在封面进行展示

_sidebar.md用来进行侧边栏配置，可以进行目录跳转，展示页面。注意目录后面要加/

 markdown目录放置需要展示的文档

 部署博客

这里推荐的是部署到gitee 

• 把刚才创建的目录提交仓库，git push即可。

• 进入Gitee Pages

• 

• 开始部署(正常第一次进来是部署，后续是更新)

• 等待部署完成后，会显示你的Gitee Pages域名地址

• 后续每次更新，把本地git push至仓库，在gitee点击更新即可。

 源码：BlogTest: 离离原上草一岁一枯荣 (gitee.com)