依靠 GitHub Actions，在 GitHub Pages 部署 Hugo

• April 24, 2024
• Geek  
• Tutorial  

GitHub Pages 使用入门

GitHub Pages 适用于具有 GitHub Free 和组织的 GitHub Free 的公共存储库，以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和专用存储库。

从 2024 年 6 月 30 日起，所有 GitHub Pages 版本都将使用 GitHub Actions。 无需进行其他更改，但必须在存储库中启用 GitHub Actions 才能继续构建。

本地部署 Hugo

推荐 WSL 内部署 Hugo，再通过 Windows 的 VS Code 编辑。

配置 WSL 流程见另一篇博文：配置 WSL2

部署 Hugo：Install Hugo on Linux

创建 GitHub Pages 仓库

创建 GitHub Pages 站点

为附件创建仓库

一个仓库内文件太多可能导致性能问题。将这些仓库添加为 submodule。

使用 Git 拉取到 WSL

 git clone --recurse-submodules https://github.com/username/username.github.io.git

配置 GitHub Actions

1. 网上的教程会让你新建分支，不需要

2. 网上的教程会让你修改 GitHub Pages 的 Source，不需要

要做的只有一步：创建一个 Workflow，Host on GitHub Pages；若存放附件的仓库是私有的，则需要为 actions/checkout 配置 Personal access token。

每次 Pull 都会自动触发这个 Workflow，实现自动部署。