1. Github page 相关配置

详见 github 文档

https://docs.github.com/en/pages/quickstart

2. 安装 Node.js

环境：WSL-Ubuntu 24.04 LTS

1
2
3
4
5
6
7
8
9
# 安装 nvm #
sudo apt-get install curl
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
. ~/.bashrc

# 安装 Node.js LTS 版本 #
nvm install --lts
node --version	## 验证 node 
npm version		## 验证 npm

https://learn.microsoft.com/zh-cn/windows/dev-environment/javascript/nodejs-on-wsl

3. 部署 Hexo 及其插件

3.1 安装 Hexo

1
2
npm install hexo-cli -g
hexo version	## 验证

3.2 初始化 Hexo 仓库及安装插件

1
2
3
4
hexo init <your-folder-name>	# 将文件夹名替换为你的，例如 hexo init reglucis.github.io
cd <your-folder-name>
npm install	
npm install hexo-deployer-git save	# 安装插件 hexo-deployer-git (使用 GitHub Pages 功能需要)

安装好后可在本地启动服务器，预览网站

1
hexo server -o

出现下述状态即为成功。
图片

4. 设置部署仓库和分支

打开仓库根目录的 _config.yml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: ''

#（修改为）	

deploy:
  type: git
  # rebo 填写你自己仓库的 ssh 连接
  repo: git@github.com:Reglucis/Reglucis.github.io.git
  # branch 要与你在仓库设置页指定的分支相同
  branch: main

4. 生成静态网页并发布

生成静态网页文件

1
hexo generate

生成后，静态网页保存在 public 文件夹中.
推送

1
hexo deploy

配合使用的插件

文章加密: hexo-blog-encrypt
公式渲染：hexo-renderer-pandoc

相关教程

https://tech.yemengstar.com/category/tech/hexo/