Jekyll 主题 contrast 的 Hugo 移植版本,沿用极简排版风格
contrast-hugo — Hugo 启动器模板
作者 niklasbuschmann
contrast-hugo 是 Jekyll 主题 contrast 的 Hugo 移植版本,以极简排版呈现内容,通过配置文件设置主题、菜单与摘要显示。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
全部页面与视图 3
截图用于了解视觉与布局,交互效果请以实际项目为准。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
通过 themes/ 目录克隆加 hugo.yaml 中 theme 字段启用
菜单分为 main 与 social 两组,支持按 weight 排序
社交菜单项可用 identifier 指定图标,示例含 envelope、github、rss
params.excerpts 可切换列表是否显示摘要
仓库采用 Unlicense,代码可自由复制、修改与分发
模板详细介绍
contrast-hugo 是 niklasbuschmann 将 Jekyll 主题 contrast 适配到 Hugo 的版本,仓库自述为“Minimalistic Hugo theme”。它本身不提供页面构建器或组件库,而是通过 Hugo 的主题机制工作:把仓库克隆到项目的 themes/ 目录,再在 hugo.yaml 中声明 theme: "contrast-hugo" 即可启用。
配置层面,README 给出的示例集中在 params.excerpts 与 menu 两部分:excerpts 控制是否显示摘要,menu 分为 main 与 social 两组,每项包含 name、url、weight,社交项还可带 identifier 以对应图标(示例使用 envelope、github、rss)。主题的演示站与截图覆盖首页、内页和移动端视图,可用于了解实际排版效果。
资料未说明主题包含哪些具体内容类型、短代码或构建流程,也未给出 Hugo 版本要求;使用前需自行确认与当前 Hugo 版本的兼容性。仓库采用 Unlicense,代码可自由复制、修改与分发,但演示图片、字体、图标等第三方素材需单独核对许可。
适合你的项目吗?
适用场景
- 为个人博客或文字站点搭建轻量 Hugo 主题
- 把原有 Jekyll contrast 站点迁移到 Hugo
- 需要以配置文件定义顶部导航与社交链接的静态站点
- 作为学习 Hugo 主题结构与菜单配置的参考项目
适合人群
- 使用 Hugo 构建静态站点的开发者
- 偏好极简排版、以文字内容为主的博客作者
- 需要自由许可、可自行修改主题代码的用户
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
在项目根目录执行 cd themes/ 后 git clone https://github.com/niklasbuschmann/contrast-hugo.git
- 2
在 hugo.yaml 顶部添加 theme: "contrast-hugo"
- 3
按需在 params 中设置 excerpts,并在 menu 下配置 main 与 social 菜单项
- 4
资料未给出 Hugo 版本要求,使用前请确认与本地 Hugo 版本的兼容性
- 5
演示图片、字体、图标等第三方素材需单独核对许可,不随代码的 Unlicense 一并授权
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明本次收录的是公开仓库中采用 Unlicense 许可的免费版本;免费范围为该版本代码,不代表外部服务或第三方素材免费。
使用时需要遵守
- 允许免费复制、修改、发布、使用、编译、销售和分发该版本代码,包括商业用途。
- 作者通过公有领域贡献声明放弃相关版权;该声明的法律效果取决于适用司法辖区。
- 代码按现状提供;担保与责任限制以原许可证及适用法律为准。
额外费用与待核对事项
- 演示图片、字体、图标及其他第三方素材需按各自许可核对,不能仅凭代码的 Unlicense 许可判断。
- 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
查看原文依据
https://github.com/niklasbuschmann/contrast-hugo/blob/master/LICENSE.txthttps://github.com/niklasbuschmann/contrast-hugo/blob/master/README.mdfor any purpose, commercial or non-commercial, and by any means
许可证原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-10-03。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- Hugo Themes
- 资料与维护参考分
- 资料一般 · 73 / 100
- 技术栈
- Hugo
- 网站类型
- 启动器
这个分数如何计算
本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2025-08-16
- 截图检查日期
- 2026-10-03
已收录演示链接。请用你的内容与屏幕尺寸检查;有演示不代表表单、认证或支付已经可用。
目录记录的主要技术栈是 Hugo。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
审核声明: [email protected] · 2026-10-04
查看当时使用的来源资料
SHA-256: 1b8a731b658b4c44c51a03113aef5aa796575336f3becce9ba30ae6259c570e9
2026-10-03T18:48:59.448Z
来源文件 / 仓库Adaption of the of [contrast](https://github.com/niklasbuschmann/contrast) Jekyll theme.
## Installation
To install Contrast as your default theme, first install this repository in the `themes/` directory:
$ cd themes/
$ git clone https://github.com/niklasbuschmann/contrast-hugo.git
Second, specify `contrast-hugo` as your default theme in the `hugo.yaml` file. Just add the line
theme: "contrast-hugo"
at the top of the file.
An example `hugo.yaml` could look like this:
```yaml
theme: "contrast-hugo"
params:
excerpts: false
menu:
main:
- {name: "Home", url: "/", weight: 1}
- {name: "About", url: "/about/", weight: 2}
social:
- {name: "Mail", url: "mailto:", identifier: "envelope", weight: 3}
- {name: "Github", url: "https://github.com/", identifier: "github", weight: 4}
- {name: "Subscribe", url: "/index.xml", identifier: "rss", weight: 5}
```
看看同类模板
对比同技术栈与用途的模板,找到更适合的视觉与内容结构。

hugo-xmin
eXtremely Minimal Hugo theme: about 140 lines of code in total, including HTML and CSS (with no dependencies)
Hugo · 启动器

hugo-theme-gallery
Gallery Theme for Hugo
Hugo · 启动器

reveal-hugo
📽️ Create rich HTML-based presentations with Hugo and Reveal.js
Hugo · 启动器

anatole
Anatole is a minimalistic two-column theme for Hugo.
Hugo · 启动器

hugo-theme-diary
Moments piled up. A Hugo theme ported from SumiMakito/hexo-theme-Journal.
Hugo · 启动器

risotto
A minimalist, responsive hugo theme inspired by terminal ricing aesthetics.
Hugo · 启动器
