一、简介
使用 docsify 搭建个人的在线文档
如果不想努力了,这里有模板。点击查看:Docsify Template
或者:使用 WordPress 搭建自己的个人博客网站(个人工作室网站、个人视频网站、个人摄影网站等等)。教程暂时没空写,欢迎 联系作者。
我的个人博客网站:https://www.bbigsun.com/
我的在线笔记文档:http://docs.bbigsun.com/
二、正文
依赖环境
- CentOS7.9
- node.js
安装 Node.js
您可以在 Node.js 官网或者阿里云镜像仓库下载最新的Nodejs版本,本文以 v16.14.0 为例:
# 下载 nodejs 二进制文件
wget https://npm.taobao.org/mirrors/node/latest-v14.x/node-v14.6.0-linux-x64.tar.gz
# 解压
tar -zxvf node-v14.6.0-linux-x64.tar.gz
mv nodenode-v14.6.0-linux-x64 node-v14.6.0
# 配置环境变量
vim
cat > /etc/profile.d/nodejs.sh << EOF
export NODE_HOME=/usr/local/node-v14.6.0
export PATH=$PATH:$NODE_HOME/bin
EOF
# 刷新配置
source /etc/profile
# 验证
node -v
npm -v
# 为 npm 配置阿里云镜像源加速
npm config set registry "https://registry.npm.taobao.org"
# 验证 npm 设置阿里云源是否设置成功
npm config get registry
安装 docsify
想要了解更多关于 docsify 的内容,请查看官方文档
npm install -g docsify-cli
使用 docsify 初始化项目
# 创建目录
mkdir -p /data/docs
# 进入目录
cd /data/docs
# 初始化
docsify init -y
# 启动服务器
docsify serve
# 浏览器访问:localhost:3000
docsify 初始化文件说明
docs
- index.html # 网页,只要将这个放在你的 Gitee 仓库下面,服务选择 Gitee Pages 服务,就可以通过 Gitee 生成的域名访问你的静态文件网站了。
- README.md # 博客内容
使用 Gitee Pages 部署项目
开通 Gitee Pages 服务
- 实名认证
- 真实姓名/身份证号/身份证正反面(图片)/手持身份证(图片)
将 docsify 初始化生成的文件添加你的 Gitee 仓库中,使用 Gitee Pages 部署过后,即可访问静态文件网站。
yum install -y git
cd /data/docs
git config --global user.name "Gitee UserName"
git config --global user.email "Gitee Email"
git init
git pull https://gitee.com/xxx/docs.git
git add .
git commit -m "first commit"
git remote add origin https://gitee.com/xxx/docs.git
git push -u origin "master"