github pages + hugo 搭建静态博客网站

体验地址

1. 起因, 目的:

  1. 其实6年前,我就写过这个。
    项目代码
    博客地址

  2. 最近想改写一下。

    github 推荐的主题是 Jekyll, 我当时用的就是这个,感觉很麻烦。尤其是文章命名。

  3. 新的主题 hugo 用起来还行。

2.过程:

过程记录, 需要详细! 因为问题非常多!

3. 参考教程:

  1. 视频教程: https://www.youtube.com/watch?v=_QSr2_pxIJs
  2. 配置文件,参考来源: https://theplaybook.dev/docs/deploy-hugo-to-github-pages/
一句话介绍 hugo:

hugo 是一个静态博客渲染工具, go 语言写的。

安装:

choco install hugo-extended # 失败。 估计是权限

scoop install hugo-extended # ok!

运行的话, 最好是使用 wsl , cmd 也行!!
新 hugo 建项目

hugo new site my_hugo_blog -f yaml

cd my_hugo_blog

安装主题,

git init

git clone https://github.com/adityatelange/hugo-PaperMod themes/PaperMod --depth=1

git submodule add --depth=1 https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod

修改 "hugo.toml", 增加一行

theme = "PaperMod"

新建文章

hugo new docs/test_file.md

!!! !!!

draft = true, ----> draft = false 否则无法渲染。 直接删掉这一行也行。

!! !!! !!! !!!

查看文章: localhost:7897/docs/test_file

下面就 github 相关的操作了
  • 创建github 项目,上传文件。
  • 新建一个分支, gh-pages !!! 这里名称不能变。 必须是 gh! 一个字都不能变!
  • 开启 github actions 读写权限 https://github.com/buxuele/my_hugo_blog/settings/actions
  • mkdir -p .github/workflows, 新建+修改 deploy.yml
  • 修改 "hugo.toml", 增加 baseUrl
报错:

其实就是修改一个 hugo 的版本。


老哥留步,支持一下。

相关推荐
dong_junshuai1 小时前
每天一个开源项目#162 NGINX:流式响应背后的缓冲、背压与重试
github
测试员周周2 小时前
【agent评测】:真实系统演示工具调用长什么样,用例怎么设计,怎么测
前端·后端·github
吴长建先生重名了3 小时前
Laravel 项目中使用 Eloquent 实现 IM
github
网易云信4 小时前
三折叠 IM 怎么适配?云信鸿蒙 UIKit 的分栏、导航与状态保留实践
github
guuguo4 小时前
【做个开源软件】Mac 上 node 进程莫名吃掉 6G 内存?给 AI / MCP 做了个深度归因和安全回收工具
人工智能·开源·github
一条Go5 小时前
源新生代雷达 · 第 16 期
github
一条Go5 小时前
SSH 命令审核流:为什么「能执行」必须先「被批准」
后端·架构·github
杨凯凡7 小时前
IT日报|2026-11-19:Oracle Java 紧急补丁、Optimizely 供应链攻击、GitHub 安全评估升级
java·oracle·github
徐小夕8 小时前
深度拆解 Design Agent:LangChain 出品,AI 设计从「好看」走向「可用」
前端·vue.js·github
严肃小白兔9 小时前
GitHub Copilot 团队级 Agent Plugins 正式发布:插件架构、共享配置与实战
github·copilot