Hugo博客

blog (YoungZM339) — Hugo 博客模板

作者 YoungZM339

基于 Hugo 的中文博客源仓库,使用 diary 主题组织文章与页面,master 分支经 GitHub Actions 构建后发布到 gh-page 分支。

看看你的网站会是什么样

浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。

3 个预览视图
桌面端首页1 / 3
桌面端截图首屏预览

由服务器浏览器实际访问页面后截取。

全部页面与视图 3

截图用于了解视觉与布局,交互效果请以实际项目为准。

采集于 2026-10-11查看来源

值得关注的模板亮点

从已有项目资料中,快速了解它的特点。

01

使用 Hugo 生成静态站点,内容与配置集中在 content/、config.toml 和 even-config.toml

02

采用 diary 主题组织文章、关于页与链接页

03

master 分支推送后由 GitHub Actions 自动构建并发布到 gh-page 分支

04

通过 static/CNAME 声明自定义域名,演示站点为 blog.youngzm.com

05

本地可用 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 许可,但文章、图片和主题可能适用不同的版权或许可,第三方素材需按各自许可核对。

Hugo博客

适合你的项目吗?

适用场景

  • 搭建个人中文博客并托管到 GitHub Pages
  • 以 Hugo 与 diary 主题为基础维护文章、关于页和链接页
  • 通过 GitHub Actions 实现推送后自动构建与发布
  • 需要自定义域名并通过 CNAME 指向托管服务的博客站点

适合人群

  • 熟悉或愿意学习 Hugo 基本命令与目录结构的个人博主
  • 希望用 Git 仓库管理博客源内容并自动发布的开发者
  • 需要中文博客界面、并接受 diary 主题默认样式的使用者

上手与定制指南

结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。

  1. 1

    本地预览前需安装 Hugo,然后在仓库根目录执行 hugo server -D

  2. 2

    构建命令为 hugo -D,生成结果位于 public/,该目录不应与源内容混淆

  3. 3

    发布前确认 GitHub Actions 部署密钥已作为仓库秘密安全配置

  4. 4

    确认 CNAME 与域名托管设置一致,并检查新文章、外链、评论配置和图片是否适合公开

  5. 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 原文

文章、图片和主题可能适用不同的版权或许可。

README 原文
https://github.com/YoungZM339/blog/blob/master/LICENSEhttps://github.com/YoungZM339/blog/blob/master/README.md

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 文件。文章、图片和主题可能适用不同的版权或许可。
反馈内容错误

看看同类模板

对比同技术栈与用途的模板,找到更适合的视觉与内容结构。