部署Docsify
1.docsify安装并启动(Windows系统)
1.管理员启动cmd,执行:
npm i docsify-cli -g
2.查看安装成功后的版本
docsify -v
3.新建一个文件夹,对它进行初始化,输入步骤如下
d:
cd D:\Corporation\Repository
docsify init
y
4.启动docsify
docsify serve
2.网站主题的修改
1.编辑目录下的index.html,修改.css
<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify@4/lib/themes/vue.css">
2.分别由五种主题:
* vue.css
* buble.css
* dark.css
* pure.css
* dolphin.css
3.开启封面功能
1.index.html中添加代码
coverpage: true
2.编辑封面内容
添加 _convertpage.md 文件
4.开启右上角导航栏
1.index.html中添加代码
loadNavbar: true
2.编辑导航栏内容
添加 _navbar.md 文件
5.以上步骤是本地部署,点击下方链接,参考部署Nginx
请参考另一篇文章,在Linux上配置Nginx环境,将docsify部署到公网访问
→ 搭建Linux环境
6.接着在nginx下新建文件夹,专门存放网站
cd /usr/local/nginx/sbin/nginx
mkdir www //新建一个www文件夹,把本地的Repository文件夹移过来
pwd //这条命令可以将目前文件夹路径完整显示出来,复制
7.修改配置文件
修改此路径下的配置文件 usr/local/nginx/conf/nginx.conf
修改成
8.修改完配置文件,重启nginx
/usr/local/nginx/sbin/nginx -s reload
9.也可以将本地配置部署到GitHub Pages (第四步执行完直接跳转过来)
- 创建GitHub 仓库,clone到本地,将之前的文件复制到刚才路径
- 文件提交到远程仓库
- 仓库 → Settings → Pages
填写Source 后就可以访问
(用户名.github.io/仓库名)
10.绑定自定义域名
前提是你要有一个域名
10.1 找到GitHub的主机IP地址
ping dotneter-hpf.github.io
10.2 在仓库根目录,创建文件
创建一个名为 CNAME 的文件,内容输入 {申请好的域名}
10.3 解析域名
-
添加如下两条记录,注意标红的地方不要填写错误,记录值按实际填写
-
一定要注意解析域名的时候 主机记录 不要乱写
10.4 配置GitHubPages
Custom domain 填写域名,校验
这个过程可能持续几分钟左右,多等一会或者多校验几次
校验成功后,勾选 Enforce HTTPS ,改成HTTPS
10.5 访问你的静态网页
到此为止,就有两个地址可以访问到: