一、简介

使用 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"
Logo

华为开发者空间,是为全球开发者打造的专属开发空间,汇聚了华为优质开发资源及工具,致力于让每一位开发者拥有一台云主机,基于华为根生态开发、创新。

更多推荐