我的第一篇博客文章
我的第一篇博客文章
找到前进的方向后,这是第一篇博客教程文章,内容我就打算写写关于使用 Cloudflare+Hugo+GitHub 搭建一个最简单的个人博客。
接下来,让我来梳理一下使用 Cloudflare Pages 和 Hugo 部署一个最简单网站的步骤。这里的“最简单”意味着:
- 使用
Hugo官方推荐的基础主题(如Ananke),不做任何自定义修改。 - 只包含一篇文章。
- 利用
Cloudflare Pages的Hugo预设进行部署。
前提条件:
- 你已经安装了
Git。 - 你已经安装了
Hugo。 (可以通过hugo version命令检查) - 你有一个
GitHub账号。 - 你有一个
Cloudflare账号。
步骤:
第一步:本地创建 Hugo 站点并添加内容
- 打开终端或命令行工具。
- 创建新的 Hugo 站点:
将
hugo new site my-simple-blog cd my-simple-blogmy-simple-blog替换为你想要的项目名称。 - 初始化 Git 仓库:
git init - 添加 Ananke 主题(或其他基础主题):
我们使用 Git Submodule 来添加主题,这是推荐的方式。
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke - 配置 Hugo 使用该主题:
打开项目根目录下的
hugo.toml文件(如果是旧版本 Hugo,可能是config.toml),添加或修改theme配置行:注意:# hugo.toml baseURL = 'http://example.org/' # 稍后会被 Cloudflare 覆盖 languageCode = 'en-us' # 或 'zh-cn' title = 'My Simple Blog' theme = 'ananke' # 确保这行存在且正确baseURL在本地测试时随意写一个,部署到 Cloudflare Pages 后它会自动处理。 - 创建第一篇文章:
hugo new content posts/my-first-post.md - 编辑文章内容:
打开
content/posts/my-first-post.md文件,修改内容。确保将draft: true改为draft: false,否则文章不会被构建。--- title: "My First Post" date: 2025-03-28T12:00:00+08:00 # 修改为当前日期时间 draft: false # 设为 false 来发布 --- Hello World! This is my first post using Hugo and Cloudflare Pages. - (可选) 本地预览:
在项目根目录运行:
然后在浏览器中打开
hugo server -Dhttp://localhost:1313(或终端提示的地址),你应该能看到带有 Ananke 主题和你的第一篇文章的网站。按Ctrl+C停止本地服务器。
