Writer-first 设计,界面克制,突出文章阅读体验
hugo-mini — Hugo 博客模板
作者 zavarovkv
Writer-first Hugo 博客主题,注重阅读体验,内置暗色模式、多语言、SEO 与可选 Telegram 集成。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
全部页面与视图 3
截图用于了解视觉与布局,交互效果请以实际项目为准。 本截图因高度限制未包含整页。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
自托管资源,CSS/JS/字体打包并指纹化,无前端框架
内置暗色模式、多语言导航、SEO 元数据、RSS/JSON Feed
可选 KaTeX 数学公式与 Mermaid 图表,按需加载
支持 Telegram 评论与反应计数,以及多种分析工具
设计令牌、模板钩子与命名块,便于定制扩展
模板详细介绍
Hugo Mini 是一个以写作者为中心的 Hugo 博客主题,核心目标是让文章本身成为页面焦点。它不依赖前端框架,CSS、JavaScript 和字体均打包并自托管,默认对性能友好。主题内置了干净的排版、系统感知的暗色模式、多语言导航、RSS 与 JSON Feed、Open Graph 与 JSON-LD 等 SEO 元数据,以及可选的 KaTeX 数学公式和 Mermaid 图表支持。
对于需要快速搭建个人博客或文本主导网站的开发者,Hugo Mini 提供了开箱即用的基础能力,同时保持较低的定制门槛。通过设计令牌、模板钩子和命名块,可以扩展菜单图标、颜色方案等。它还支持置顶文章、最近文章列表、代码复制、图片说明等写作辅助功能。多语言站点可配置每语言菜单和界面字符串,并自动生成 hreflang。Telegram 评论与反应计数、社交分享和分析工具(Yandex、Google、Plausible、Umami)均为可选,未配置时不会加载。
需要留意的是,Hugo Mini 明确不适合杂志式首页、视觉作品集或需要复杂交互的站点。它要求 Hugo Extended 0.146 或更高版本,且某些功能(如 Mermaid 按需加载)需要额外配置。上线前建议核对文档中关于部署、资源维护和 vendored assets 的说明,确保生产环境符合预期。
适合你的项目吗?
适用场景
- 个人技术博客或文字为主的网站
- 需要多语言支持的 Hugo 站点
- 希望快速搭建并保持低维护成本的内容站
- 对性能与隐私敏感,倾向自托管资源的项目
适合人群
- Hugo 用户,尤其是熟悉 Git 子模块和 TOML 配置的开发者
- 追求简洁排版与阅读体验的写作者
- 需要内置 SEO 与订阅功能的轻量博客
- 愿意阅读文档进行定制的中级用户
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
需要 Hugo Extended 0.146+,通过 Git 子模块安装。
- 2
基础配置只需替换 hugo.toml 并创建 blog 分区。
- 3
建议参考 exampleSite 和官方文档,特别是多语言、Telegram 集成与资源维护部分。
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明MIT许可证明确允许免费使用、修改、分发和商用,仅需保留版权与许可声明。
使用时需要遵守
- 保留原作者版权声明和 MIT 许可证声明。
- 在所有副本或实质性部分中包含版权声明和许可声明
额外费用与待核对事项
- README未单独说明示例图片、字体等第三方素材的授权范围
查看原文依据
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
许可证原文
The above copyright notice and this permission notice shall be included in all
许可证原文
https://github.com/zavarovkv/hugo-mini/blob/main/LICENSEhttps://github.com/zavarovkv/hugo-mini/blob/HEAD/README.mdPermission is hereby granted, free of char
许可证原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-09-24。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- GitHub
- 资料与维护参考分
- 资料较完整 · 77 / 100
- 技术栈
- Hugo
- 网站类型
- 博客
这个分数如何计算
本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2026-09-05
- 截图检查日期
- 2026-09-06
已收录演示链接。请用你的内容与屏幕尺寸检查;有演示不代表表单、认证或支付已经可用。
目录记录的主要技术栈是 Hugo。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
当前版本没有可核对的编辑审核记录;旧的应用时间不代表已完成事实审核。
这条历史介绍未保存固定版本的来源快照。请对照当前仓库,发现不一致可反馈。
反馈内容错误看看同类模板
对比同技术栈与用途的模板,找到更适合的视觉与内容结构。

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 · 文档
