docsify动态文档工具

type

status

date

slug

summary

1.0 docsify 介绍

docsify 可以快速帮你生成文档网站。不同于 GitBook、Hexo 的地方是它不会生成静态的 .html 文件，所有转换工作都是在运行时。如果你想要开始使用它，只需要创建一个 index.html 就可以开始编写文档并直接部署在 GitHub Pages。

官网：https://docsify.js.org/#/zh-cn

docsify 的目录结构配置非常简单，如果你不需要修改的话，只是 md 目录编写文档，在 _sidebar.md 配置文章路径即可。

index.html 用于配置一些网站的基础信息，包括：网站采集、留言板、地址等。

_coverpage.md 用于配置博客首页的介绍信息和网站Logo等

所有的文章内容，都是使用 MD 格式进行编写。放心你不会用到太复杂的内容。

MD 使用文档：https://www.runoob.com/markdown/md-tutorial.html

2.0 快速搭建博客

这里给大家提供 GitHub/Gitee 两种仓库来搭建博客，方便有些小白访问 GitHub 费劲也能用 Gitee 搭建博客。

仓库：https://github.com/fuzhengwei/fuzhengwei.github.io

说明：这是一个 docsify 的博客仓库地址，一些必要的简单配置信息小傅哥已经帮你处理好了，直接使用即可。

1. GitHub Page

优点：规范、部署不限制、自由度高、配置域名不收费

缺点：国内访问速度慢、仓库不能设置私有

1.1 第一步：Fork

打开 https://github.com/fuzhengwei/fuzhengwei.github.io 点击 fork 到自己的仓库。

1.2 第二步：配置

点击 Setting 进入 General 配置工程名称页面。

注意：你必须把 fuzhengwei.github.io 修改为你的名称 xxx.github.io 这里的 xxx 就是你的GitHub的名称，也是 https://github.com/{xxxx} 链接后面的名称，不要修改错了，否则你就失败了。

1.3 第三步：开启

点击 Setting 进入 Page 页面

按照上图修改博客资源空间到 docs 文件夹下，这个步骤是选择博客空间地址，记得不要配置错了。

1.4 第四步：访问

好了，当你在配置后看到已经提醒你 Your site is published at https://fuzhengwei.github.io/ 证明你成功了，你可以访问自己的博客地址了。PS：这里要 xuewei 的等一下，因为初始化有一个过程，正在编译稍后就可以访问了。

2. Gitee Page

优点：访问速度快、博客仓库可以设置私有

缺点：不能配置自己的域名，需要上传身份信息后才可以使用

2.1 第一步：导入

与使用 GitHub 不同，这里是在 Gitee 中导入博客仓库，如下：

进入导入工程页面：https://gitee.com/projects/import/url - 也可以从 gitee 右上角的 + 号进入。

复制博客模板：https://github.com/fuzhengwei/fuzhengwei.github.io 粘贴到 Git 仓库 URL 即可。

修改仓库名称、路径，为你的 gitee 账号名称，我这里的名称为 yamiedei，你复制自己的就可以了。

2.2 第二步：配置

从 服务 的 Gitee Pages 进入即可进入配置博客页面。

不过由于大家基本都是初次使用 Gitee Pages 它会要求你上传认证信息，一天内审核完成。

2.3 第三步：认证

如果你到了这个页面，可以提交资料后，第二天再继续了。

2.4 第四步：开启

如果以上步骤都完事了，接下来你就可以开启自己的博客了，同样会给你一个博客地址，每次上传新的文章点击更新即可。

【来源】：https://cloud.tencent.com/developer/article/1965360

🗒️docsify动态文档工具