个人docsify在线文档搭建

一、创建docsify项目

官网：https://docsify.js.org/#/

1、前期准备

npm i docsify-cli -g

2、创建项目

  创建一个项目文件夹，并进入文件夹：

docsify init ./docs

二、docsify项目配置

1、侧边栏

• _sidebar.md

其作用类似于gitbook中的SUMMARY.md

- [首页](README)
- [第一章](part1/README.md)
  - [1.1 第一节](part1/writing.md)
  - [1.2 第二节](part1/gitbook.md)
- [第二章](part2/README.md)
  - [2.1 第一节](part2/feedback_please.md)
  - [2.2 第二节](part2/better_tools.md)

• index.html

      window.$docsify = {
        loadSidebar: true,
        subMaxLevel: 2,
      };

2、封面

• _coverpage.md

<!-- _coverpage.md -->

![logo](_media/icon.svg)

# docsify

> 一个神奇的文档网站生成器。

[GitHub](https://github.com/docsifyjs/docsify/)
[Get Started](README.md)

<!-- 背景图片 -->
![](_media/bg.png)

<!-- 背景色 -->
![color](#f0f0f0)

• index.html

      window.$docsify = {
        coverpage: true,
        onlyCover: true,
      };

三、部署

1、方式1

  在对应的 Gitee 仓库服务中选择 Gitee Pages，选择您要部署的分支，填写您要部署的分支上的目录，例如docs，填写完成之后点击启动即可。

2、方式2

  使用vercel 自动部署。