1. 本地部署 Docsify
安装环境:Windows 10
准备工具: Node.js、Markdown 编辑器、cpolar 内网穿透工具
首先检查 Node.js 是否已安装。
node -v
查看 npm 是否已安装。
npm -v
如未安装,请前往 Node.js 官网下载安装。
安装完成后,安装 Docsify 本地全局工具。
npm i docsify-cli -g
初始化 Docsify 本地项目。
docsify init ./docs
启用本地网页预览。
docsify serve docs
2. 使用 Docsify 搭建个人博客
打开 ./docs 目录,可以看到初始化成功后创建的几个文件:
index.html:入口文件README.md:主页内容渲染.nojekyll:阻止 GitHub Pages 忽略下划线开头的文件
直接编辑 docs/README.md 即可更新文档内容。也可以添加更多页面。
制作个人文档需要配置以下基本文件:
| 文件作用 | 文件 |
|---|---|
| 基础配置项(入口文件) | index.html |
| 封面配置文件 | _coverpage.md |
| 侧边栏配置文件 | _sidebar.md |
| 导航栏配置文件 | _navbar.md |
| 主页内容渲染文件 | README.md |
| 浏览器图标 | favicon.ico |
参考 Docsify 文档中的定制化配置项进行设置。建议采用默认的文件渲染以简化维护。
封面配置文件示例(_coverpage.md)
封面的生成是从 Markdown 文件渲染来的。开启渲染封面功能后在文档根目录创建 _coverpage.md 文件。
index.html
<!-- index.html -->
<script>
window.$docsify = {
coverpage: true
}
</script>
<script src="//cdn.jsdelivr.net/npm/docsify/lib/docsify.min.js">

# docsify 3.5
> 一个神奇的文档网站生成器。
- 简单、轻便 (压缩后 ~21kB)
- 无需生成 html 文件
- 众多主题 [开始使用](/README.md)


