使用 Hugo 生成静态站点,内容与配置集中在 content/、config.toml 和 even-config.toml
blog (YoungZM339) — Hugo 博客模板
作者 YoungZM339
基于 Hugo 的中文博客源仓库,使用 diary 主题组织文章与页面,master 分支经 GitHub Actions 构建后发布到 gh-page 分支。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
全部页面与视图 3
截图用于了解视觉与布局,交互效果请以实际项目为准。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
采用 diary 主题组织文章、关于页与链接页
master 分支推送后由 GitHub Actions 自动构建并发布到 gh-page 分支
通过 static/CNAME 声明自定义域名,演示站点为 blog.youngzm.com
本地可用 hugo server -D 预览含草稿的内容,hugo -D 生成 public/ 构建产物
模板详细介绍
这是一个个人中文博客的源仓库,采用 Hugo 作为静态站点生成器,站点内容与配置围绕 diary 主题组织。仓库结构清晰:content/ 存放文章、关于页和链接页;themes/diary/ 为 Hugo 主题;static/ 保存静态资源与 CNAME 文件;config.toml 是站点主配置,even-config.toml 为扩展配置;.github/workflows/ 定义自动构建与发布流程。
本地预览需先安装 Hugo,然后在仓库根目录执行 hugo server -D,该命令会把草稿内容一并纳入预览。构建时执行 hugo -D,生成的静态文件位于 public/ 目录,该目录属于构建产物,不应与源内容混用。
发布流程由 GitHub Actions 驱动:当 master 分支收到推送时,工作流运行 Hugo 构建并将 public/ 发布到 gh-page 分支。仓库通过 CNAME 声明自定义域名,演示站点为 blog.youngzm.com。发布前需要确认部署密钥已作为仓库秘密安全配置、CNAME 与域名托管设置一致,并检查新文章、外链、评论配置和图片是否适合公开。
写作与维护方面,新增文章前应检查 front matter、发布日期、草稿状态和资源路径;不要在文章、配置或静态资源中提交密钥、私人联系信息或未获授权的素材。仓库采用 MIT 许可,但文章、图片和主题可能适用不同的版权或许可,第三方素材需按各自许可核对。
适合你的项目吗?
适用场景
- 搭建个人中文博客并托管到 GitHub Pages
- 以 Hugo 与 diary 主题为基础维护文章、关于页和链接页
- 通过 GitHub Actions 实现推送后自动构建与发布
- 需要自定义域名并通过 CNAME 指向托管服务的博客站点
适合人群
- 熟悉或愿意学习 Hugo 基本命令与目录结构的个人博主
- 希望用 Git 仓库管理博客源内容并自动发布的开发者
- 需要中文博客界面、并接受 diary 主题默认样式的使用者
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
本地预览前需安装 Hugo,然后在仓库根目录执行 hugo server -D
- 2
构建命令为 hugo -D,生成结果位于 public/,该目录不应与源内容混淆
- 3
发布前确认 GitHub Actions 部署密钥已作为仓库秘密安全配置
- 4
确认 CNAME 与域名托管设置一致,并检查新文章、外链、评论配置和图片是否适合公开
- 5
文章、图片和主题可能适用不同版权或许可,第三方素材需按各自许可核对
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明本次收录的是公开仓库中采用 MIT 许可的免费版本;免费范围为该版本代码,不代表外部服务或第三方素材免费。
使用时需要遵守
- 允许免费使用、修改、商用和分发该版本代码。
- 分发代码副本或实质性部分时,保留原作者版权声明和完整 MIT 许可声明。
- 代码按现状提供;担保与责任限制以原许可证及适用法律为准。
额外费用与待核对事项
- 演示图片、字体、图标及其他第三方素材需按各自许可核对,不能仅凭代码的 MIT 许可判断。
- 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
- 发布到 gh-page 分支前,必须将 GitHub Actions 部署密钥配置为仓库秘密,否则自动发布流程无法安全运行。
- 使用自定义域名时,需保证 static/CNAME 中的域名与域名托管服务设置一致,否则站点域名解析可能失败。
- 禁止在文章、配置或静态资源中提交密钥、私人联系信息或未获授权的素材,使用者需自行确保内容合规。
- 仓库代码采用 MIT 许可,但文章、图片和主题可能适用不同的版权或许可,第三方素材需按各自许可单独核对。
查看原文依据
Permission is hereby granted, free of charge
许可证原文
发布前请确认: - GitHub Actions 部署密钥已经作为仓库秘密安全配置;
README 原文
- CNAME 与域名托管设置一致;
README 原文
不要在文章、配置或静态资源中提交密钥、私人联系信息或未获授权的素材。
README 原文
https://github.com/YoungZM339/blog/blob/master/LICENSEhttps://github.com/YoungZM339/blog/blob/master/README.md文章、图片和主题可能适用不同的版权或许可。
README 原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-10-11。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- GitHub
- 资料与维护参考分
- 资料较完整 · 83 / 100
- 技术栈
- Hugo
- 网站类型
- 博客
这个分数如何计算
本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2026-08-15
- 截图检查日期
- 2026-10-11
已收录演示链接。请用你的内容与屏幕尺寸检查;有演示不代表表单、认证或支付已经可用。
目录记录的主要技术栈是 Hugo。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
审核声明: [email protected] · 2026-10-13
查看当时使用的来源资料
SHA-256: 9f8541e707eea5c0460eeac65abb6c3de6678566c49bed14ed8dc5bee8baaa81
2026-10-11T18:16:26.192Z
来源文件 / 仓库# Blog
一个基于 Hugo 的中文博客源仓库,使用 diary 主题组织文章、页面和站点配置。仓库包含静态资源、自定义域名声明以及 GitHub Actions 发布工作流。
## 结构
- content/:文章、关于页和链接页等内容。
- themes/diary/:Hugo 主题。
- static/:静态资源与 CNAME。
- config.toml:站点主配置。
- even-config.toml:扩展配置。
- .github/workflows/:自动构建和发布工作流。
## 本地预览
安装 Hugo 后,在仓库根目录执行:
hugo server -D
该命令会将草稿内容一并用于本地预览。
## 构建
生成静态站点:
hugo -D
生成结果位于 public/。该目录是构建产物,不应与源内容混淆。
## 发布流程
当 master 分支收到推送时,GitHub Actions 会运行 Hugo 构建,并将 public/ 发布到 gh-page 分支。发布前请确认:
- GitHub Actions 部署密钥已经作为仓库秘密安全配置;
- CNAME 与域名托管设置一致;
- 新文章、外链、评论配置和图片都适合公开。
## 写作与维护
新增文章前请检查 front matter、发布日期、草稿状态和资源路径。不要在文章、配置或静态资源中提交密钥、私人联系信息或未获授权的素材。
## 许可证
请参阅仓库中的 LICENSE 文件。文章、图片和主题可能适用不同的版权或许可。看看同类模板
对比同技术栈与用途的模板,找到更适合的视觉与内容结构。

hugo-PaperMod
PaperMod 是 Hugo 生态里知名度较高的主题之一,定位很明确:给博客和轻量作品集站点提供一套干净、响应式的阅读界面。
Hugo · 作品集

LoveIt
❤️A clean, elegant but advanced blog theme for Hugo 一个简洁、优雅且高效的 Hugo 主题
Hugo · 博客

hugo-coder
A minimalist blog theme for hugo.
Hugo · 博客

blowfish
Personal Website & Blog Theme for Hugo
Hugo · 博客

hugo-paper
🪺 A simple, clean, customizable Hugo theme
Hugo · 博客

hextra
Hextra 是一个 Hugo 主题,定位在文档站与博客之间:既提供侧边栏导航、目录、面包屑、分页这类文档站结构,也能承载博客内容。
Hugo · 文档
