使用GitHub Pages 部署 Hexo
本文最后更新于 2024年3月27日 早上
准备工作
- 建立名为
maojunxyz.github.io的储存库。 - 将 Hexo 文件夹中的文件 push 到储存库的默认分支,默认分支通常名为
main。
将
main分支 push 到 GitHub:1
$ git push -u origin main默认情况下
public/不会被上传(也不该被上传),确保.gitignore文件中包含一行public/。
- 使用
node --version指令检查你电脑上的 Node.js 版本,并记下该版本 (例如:v16.y.z) - 在储存库中前往
Settings > Pages > Source,并将Source改为GitHub Actions。
注意:如果本地已经有了workflow配置文件pages.yml,推送代码到仓库执行actions后,再将
Source改为Deploy from a branch,并切换到构建后的gh-pages分支。
- 在储存库中建立
.github/workflows/pages.yml,并填入以下内容 (将 20行的版本16替换为上个步骤中记下的版本):
1 | |
- 部署完成后,前往
https://maojunxyz.github.io查看网站。
CNAME:若你使用了一个带有
CNAME的自定义域名,你需要在source/文件夹中新增CNAME文件。
项目页面
如果你希望网站部署在 maojunxyz.github.io 的子目录中:
- 建立名为
blog的储存库,这样你的博客网址为maojunxyz.github.io/blog。 - 编辑你的
_config.yml,将url:更改为maojunxyz.github.io/blog。 - 在储存库中前往
Settings > Pages > Source,并将Source改为GitHub Actions。 - Commit 并 push 到默认分支上。
- 部署完成后,前往
https://maojunxyz.github.io/blog查看网站。
Hexo 常用命令
创建一个新的文章
1 | |
更新信息: Writing
运行服务
1 | |
更新信息: Server
生成静态文件
1 | |
更新信息: Generating
部署远程站点
1 | |
更新信息: Deployment
(完)
使用GitHub Pages 部署 Hexo
https://maojun.xyz/blog/2023/07/使用GitHub Pages 部署 Hexo.html