免费开源项目，震撼上线，提供完整文档，欢迎各位股东：SpringBoot+VUE https://gitee.com/rodert/liawan-vue

前言

这是一篇基于Gitee搭建个人网站的保姆级教程。从零到一。如果你想基于云服务器搭建，我以前写过一篇菜鸟篇。

适合人群：入门级别教程，如果你想拥有一个自己的网站，又苦于没有云服务器，这个是你的不二选择。

本篇是基于 docsify 搭建，docsify 是一个文档类博客模板，简介且方便使用。

效果预览：
https://rodert.gitee.io/javapub-interview/
https://rodert.github.io/JavaPub-Interview/

如果你没有qiang👍，预览这里：http://javapub.net.cn/

准备

你需要已有的环境：node、git、npm

快速安装脚手架：

npm i docsify-cli -g

搭建预览

1. 新建一个文件夹

mkdir rodert

2. 进入文件夹并运行 docsify 初始化命令：cd rodert -> docsify init ./

你会发现 rodert 文件夹下面多了一些文件。后面一一解释

3. 本地预览网站：docsify serve ./ 然后访问：http://localhost:3000/

初始化后效果图

工程&配置介绍

https://rodert.github.io/JavaPub-Interview/

1. index.html：入口文件，docsify 的各项配置都在此页面设置。
2. README.md：默认展示的首页就是 README.md 里的内容。
3. .nojekyll：用于阻止 GitHub Pages 会忽略掉下划线开头的文件。

一些好用的插件

全文搜索功能

OK，有了搜索功能。

复制copy

需要引入 js 文件：

效果：

分页导航，在文档的最下方会展示上一个文档和下一个文档

pagination: {
  previousText: '上一章节',
  nextText: '下一章节',
}

需要引入两个 js 文件：

自定义配置

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

侧边栏 loadSidebar

loadSidebar: true,

增加 _sidebar.md 文件，编写文件格式如下：（也就是md语法）

- [CentOS](centos.md)
- [Docker](docker.md)
- [Mac](mac.md)
- [NPM](npm.md)
- [推荐](recommend.md)

部署

部署github

1. 新建仓库
2. 提交项目
3. 开启 Github Pages

同步国内Gitee、访问速度

现在Github网络非常不稳定，在码云部署一份

1. 导入 Github 项目
2. 选择 -> 服务 -> Gitee Pages
3. 庆祝一下，不妨给 JavaPub 留个言，分享一下喜悦。