通过 CloudFlare Pages 部署 Hugo 博客

[TOC]

0 安装 Hugo

Github Releases · gohugoio/hugo 下载最新版的 Hugo 程序。

使用方法一:随便放一个文件夹,然后把文件夹路径加入到环境变量里。
使用方法二:直接绝对路径来调用。

不管是 Windows 系统还是 Linux 系统,都可以适配方法一和方法二。

1 新建站点仓库

这里同样有两条路径:
先新建仓库,设置远程仓库->在仓库文件夹下新建站点->推送
先新建站点->再新建仓库,设置远程仓库->推送

GitHub 新建仓库,然后克隆下来,这样少了设置远程仓库这一步。

1
git clone <your-blog-repo-url>

进入仓库目录当中,新建站点

1
2
3
4
5
hugo new site . --force
# 如果要添加主题
# <hugo-theme-url> 为主题仓库链接
# <hugo-theme-name> 自定义存放主题文件夹的名字
git submodule add <hugo-theme-url> themes/<hugo-theme-name>

2 编辑配置

如果使用主题,必须在 hugo.toml 中设置主题

1
theme = '<hugo-theme-name>'

其他设置,请自行参考主题说明和 Hugo 文档。

3 本地调试

在站点目录下使用 hugo server 命令,可以在本地运行一个服务器来调试博客的效果。

4 推送到远程仓库

add commit push 一条龙。

5 部署到 CloudFlare Pages

登录 CloudFlare 账号。

进入到 Dashboard -> Workers & Pages 选项。

点击 Create 创建 Pages

再点击 Connect to Git -> Connect GitHub,登录 GitHub 账号,并选择欲授权访问的博客仓库。

授权完成后,点击 Begin Setup,设置项目名称和仓库分支,重点是 Build settings

Framework preset 选择 HugoBuild command 填入 hugo -b $CF_PAGES_URL

在下面的 Environment variables (advanced) 添加环境变量 HUGO_VERSION=0.144.2,然后保存并部署。

固定版本号确保最后构建的效果和本地一致。
如果不知道版本号,可以使用 hugo version 命令。


CF+hugo部署要点随记-阿里云开发者社区

使用 Hugo 构建
主题 StackJimmy 设计