Hugo作品集博客

hugo-theme-iris — Hugo 作品集模板

作者 peaceiris

Hugo IRIS 主题：暗色作品集与博客，内置幻灯片、数学、图表等丰富短代码。

打开源站下载源码 ZIP

看看你的网站会是什么样

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

3 个预览视图

桌面端首页1 / 3

访问演示网站在新标签页打开

桌面端截图

演示站首页的真实桌面布局。

全部页面与视图 3

截图用于了解视觉与布局，交互效果请以实际项目为准。本截图因高度限制未包含整页。

采集于 2026-09-27查看来源

值得关注的模板亮点

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

暗色主题，响应式设计，支持多语言

内置 reveal.js 幻灯片页面，可用 Markdown 编写

支持 MathJax、mermaid、diff 等短代码

提供 repo 与 github-sponsors-list 短代码，可嵌入 GitHub 仓库卡片与赞助者列表

内置 SEO 支持：Google Analytics、Open Graph、JSON-LD、Canonical URL

键盘快捷键帮助弹窗（按 ? 显示）

模板详细介绍

Hugo IRIS 是一款面向作品集与博客的 Hugo 主题，整体采用暗色设计，强调内容展示的视觉冲击力。它内置了多种内容增强能力：除了常规的博客文章，还支持用 reveal.js 编写幻灯片页面，适合技术分享或课程讲义；MathJax 和 mermaid 短代码分别解决数学公式与流程图渲染，diff 短代码则能高亮代码差异，对技术写作比较友好。主题还提供了 repo 和 github-sponsors-list 短代码，可嵌入 GitHub 仓库卡片与赞助者列表，适合开源作者维护个人主页。

主题依赖 Hugo Modules，需要安装 Go 和 Node.js/npm，官方提供了 setup.sh 脚本快速初始化项目。内置功能包括响应式布局、多语言、分页、SEO 元数据（Open Graph、JSON-LD、canonical URL）、语法高亮、目录、随机文章列表、Disqus 评论，以及按 `?` 键唤出的快捷键帮助弹窗。图片支持响应式与 WebP（需 Hugo extended 版本），并有 OGP 图片生成能力。

需要留意的是，README 中“Customize Theme”部分仍标注 TBW，配置细节需自行查看源码或示例站点；Roadmap 中列出的分类、标签、作者、相关文章、分享按钮等功能尚未实现。部署方面官方提供了 Netlify 一键部署按钮和 GitHub Actions 的推荐方案，但实际生产使用前建议在示例站点上验证各短代码与 Hugo 版本的兼容性。

Hugo作品集博客

适合你的项目吗？

适用场景

个人作品集网站
技术博客
开源作者主页
技术演讲幻灯片

适合人群

熟悉 Hugo 和 Hugo Modules 的开发者
需要展示代码、图表、数学公式的技术写作者
希望快速搭建个人品牌页面的开发者

上手与定制指南

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

1
需要安装 Hugo（建议 extended 版本）、Go 和 Node.js/npm。
2
官方提供 setup.sh 脚本，可执行 `bash ./setup.sh homepage "your_github_id"` 初始化项目，然后 `npm ci` 和 `hugo server` 启动。
3
主题通过 Hugo Modules 管理，更新时使用 `hugo mod get -u`。

查看仓库使用说明