Hugo作品集博客

hugo-tifrueh — Hugo 作品集模板

作者 tifrueh

一个用于个人网站与博客的 Hugo 主题模块，提供作者信息、版权、RSS 元数据等站点参数与书页式排版选项。

打开源站下载源码 ZIP

看看你的网站会是什么样

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

3 个预览视图

桌面端首页1 / 3

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

桌面端截图首屏预览

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

全部页面与视图 3

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

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

值得关注的模板亮点

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

站点参数可配置作者、编辑、站长、版权年份与实体，以及 GitHub、Mastodon 链接

页面级参数支持 book-style 书页式排版、drop-cap 首字下沉与 math 数学公式加载

blog 分区页面自动启用书页式排版与首字下沉，并额外支持 table-of-contents 参数

RSS 与 Atom 模板从 blog 分区拉取文章，编辑与站长信息用于 feed 元数据

README 明确 /subscribe/、/contact/、/legal-information/ 三个顶层页面被硬引用

模板详细介绍

这是作者为个人网站编写的 Hugo 主题模块，仓库以 MIT 许可公开。主题围绕个人站点与博客场景组织内容：站点级参数覆盖作者、编辑、站长、版权与社交链接，页面级参数可控制书页式排版、首字下沉与数学公式加载。README 说明 /subscribe/、/contact/、/legal-information/ 三个顶层页面被多处硬引用，使用时应保留；blog 分区在技术上非必需，但 RSS 与 Atom 模板默认从该分区取文章，且该分区内页面强制启用 book-style 与 drop-cap，无法关闭。主题的配置合并主要涉及 markup.highlight 与 outputFormats.rss 两组设置。

Hugo作品集博客

适合你的项目吗？

适用场景

搭建个人网站并发布博客文章
需要按页面控制书页式排版与首字下沉的写作场景
需要为 RSS/Atom 订阅提供作者、编辑与站长元数据的站点
希望以 MIT 许可使用并修改主题代码的个人项目

适合人群

使用 Hugo 构建个人网站或博客的开发者
需要站点级与页面级参数控制排版细节的作者
接受保留 /subscribe/、/contact/、/legal-information/ 固定页面的站点
以 blog 分区作为文章源并依赖 RSS/Atom 输出的站点

上手与定制指南

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

1
README 未提供安装步骤，需按 Hugo 主题模块的常规方式引入仓库
2
需创建 /subscribe/、/contact/、/legal-information/ 三个顶层页面，否则多处硬引用会失效
3
blog 分区在技术上非必需，但 RSS 与 Atom 模板默认从该分区取文章
4
blog 分区内页面强制启用 book-style 与 drop-cap，无法通过参数关闭
5
配置合并主要涉及 markup.highlight 与 outputFormats.rss 两组设置

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

本次收录的是公开仓库中采用 MIT 许可的免费版本；免费范围为该版本代码，不代表外部服务或第三方素材免费。

使用时需要遵守

允许免费使用、修改、商用和分发该版本代码。
分发代码副本或实质性部分时，保留原作者版权声明和完整 MIT 许可声明。
代码按现状提供；担保与责任限制以原许可证及适用法律为准。

额外费用与待核对事项

演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
使用该主题时必须创建 /subscribe/、/contact/、/legal-information/ 三个顶层页面，否则多处硬引用会失效。
blog 分区内所有页面强制启用 book-style 与 drop-cap，无法通过参数关闭。
RSS 与 Atom 模板默认从 blog 分区拉取文章，若缺少该分区则订阅输出无内容。

查看原文依据

Permission is hereby granted, free of charge
许可证原文

The following three top-level pages should always exist, as they are hard-referenced from multiple places:
README 原文

Also note that the `book-style`, `drop-cap` parameters are automatically enabled for all pages in this section and cannot be disabled.
README 原文

The `blog` section doesn't *technically* have to exist when using this template, but the general assumption is that it does. It is where the RSS and Atom templates pull the posts from.
README 原文

https://github.com/tifrueh/hugo-tifrueh/blob/main/LICENSE.txt https://github.com/tifrueh/hugo-tifrueh/blob/main/README.md

DeepSeek 根据仓库许可证和 README 整理 ·2026-10-12。结果仅覆盖已读取资料，依赖、图片、字体及后续条款变更以各自原文为准。

项目核对记录与介绍依据

模板资料

来源平台: GitHub
资料与维护参考分: 资料较完整 · 85 / 100
技术栈: Hugo
网站类型: 作品集 · 博客

这个分数如何计算

本站按许可资料（最高30分）、演示链接（12分）、预览图（10分）、Star数（15分）、记录的维护时间（15分）、描述完整度（8分）、功能记录（5分）和分类资料（5分）计算。它不是代码、安全或性能测试，也不是 Google 评分；有链接不代表已实测可用。

这个项目需要核对什么

记录的仓库更新时间: 2026-09-12
截图检查日期: 2026-10-12

已收录演示链接。请用你的内容与屏幕尺寸检查；有演示不代表表单、认证或支付已经可用。

目录记录的主要技术栈是 Hugo。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料，不代表代码审计或部署实测。

查看具体选型方法 →

介绍的制作与核对状态

介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。

审核声明: [email protected] · 2026-10-13

查看当时使用的来源资料

SHA-256: bd7b8a0d129d16e1e2db0d6433e40d6f917569ebbcf82055dbc8df5564539d5c

2026-10-12T23:28:41.342Z

来源文件 / 仓库

# tifrueh HUGO Theme Module

This is the HUGO theme module I wrote for my personal website.

## Custom Site Parameters

| Parameter            | Default Value | Description                                                                          |
| ---                  | ---           | ---                                                                                  |
| `author.name`        | NONE          | The author's name (site-wide default, override on page-basis).                       |
| `author.email`       | NONE          | The author's email. (site-wide default, override on page-basis).                     |
| `editor.name`        | NONE          | The site editor's name. Used in the RSS feed metadata.                               |
| `editor.email`       | NONE          | The site editor's email. Used in the RSS feed metadata.                              |
| `webmaster.name`     | NONE          | The site webmaster's name. Used in the RSS feed metadata.                            |
| `webmaster.email`    | NONE          | The site webmaster's email. Used in the RSS feed metadata.                           |
| `copyright.baseYear` | NONE          | The base year for the copyright notices (site-wide default, override on page-basis). |
| `copyright.entity`   | NONE          | The entity to use in copyright notices (site-wide default, override on page-basis).  |
| `copyright.license`  | NONE          | The license to use in copyright notices (site-wide default, override on page-basis). |
| `urls.github`        | NONE          | The URL for the GitHub link in the menubar.                                          |
| `urls.mastodon`      | NONE          | The URL for the Mastodon link in the menubar.                                        |

## Custom Page Parameters

| Parameter    | Default Value | Description                                                                                                                             |
| ---          | ---           | ---                                                                                                                                     |
| `book-style` | `false`       | Format text in a more book-like manner.                                                                                                 |
| `drop-cap`   | `false`       | Add a drop cap to the first paragraph.                                                                                                  |
| `math`       | `false`       | Force the loading of MathJax to display math on the page. (Note that MathJax *should* load automatically if there is math on the page.) |

## Necessary Pages

The following three top-level pages should always exist, as they are
hard-referenced from multiple places:

| Link                  | Description                                                                    |
| ---                   | ---                                                                            |
| `/subscribe/`         | A page containing instructions on how to subscribe to updates on the site.     |
| `/contact/`           | A page containing contact information.                                         |
| `/legal-information/` | A page containing legal information like the copyright and the privacy policy. |

## Note on the `blog` Section

The `blog` section doesn't *technically* have to exist when using this template,
but the general assumption is that it does. It is where the RSS and Atom
templates pull the posts from.

Also note that the `book-style`, `drop-cap` parameters are automatically enabled
for all pages in this section and cannot be disabled.

Furthermore, the following additional parameters are available for pages in this
section:

| Parameter           | Default Value | Description                                                                  |
| ---                 | ---           | ---                                                                          |
| `table-of-contents` | `false`       | Show a table of contents at the beginning of a page.                         |

## Configuration Merge

The configuration settings potentially relevant for merging in `hugo.toml` are
within:

* `[markup.highlight]`
* `[outputFormats.rss]`

反馈内容错误