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