以 CSS 为主实现 Material Design 3 视觉,并提供颜色、对比度、形状、排版等定制项
hugo-PolyRhythmic — Hugo 启动器模板
作者 wonyoung-jang
Hugo PolyRhythmic 是一个以 CSS 为主的 Material Design 3 Hugo 主题,作者明确标注仍处于开发阶段,适合想尝试 Material 3 视觉与 Hugo 内容功能的站点。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
全部页面与视图 3
截图用于了解视觉与布局,交互效果请以实际项目为准。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
包含搜索(Fuse.js)、响应式粘性目录、明暗主题切换、代码复制、返回顶部等阅读辅助功能
提供联系表单模板、归档、多作者、分类与 section、站点地图模板、社交分享等站点结构能力
支持 Logseq 图谱以单页应用形式呈现,并可用 Hugo 资源管线处理指纹、打包与压缩
README 明确标注主题仍处于开发阶段,使用时需自行评估风险
模板详细介绍
这是一个 Hugo 主题,用(大部分为)CSS 的方式实现 Material Design 3 视觉规范,仓库位于 wonyoung-jang/hugo-PolyRhythmic,采用 MIT 许可,可通过 Hugo Themes 页面与在线演示查看效果。README 明确提示主题“仍处于大量开发中,请谨慎使用”,因此更适合作为实验或自用站点基础,而不是直接当作稳定成品。
功能层面,主题提供活动菜单位置指示、归档、返回顶部、代码复制按钮、联系表单模板、页面封面图、自定义标签导航、调试模式、GitHub 仓库按钮、首页导航按钮、键盘快捷键与访问键、明暗主题切换、多作者支持、“Now”页面表格、页面导航卡片、随机页面按钮、响应式粘性目录、基于 Fuse.js 的搜索、SEO 优化、站点地图模板、社交分享按钮、分类与 section 组织,以及颜色、对比度、形状、排版等主题定制项。它还支持把 Logseq 图谱作为单页应用呈现,并借助 Hugo 资源管线完成指纹、打包与压缩。
与 Material 3 原规范相比,主题增加了可调正文宽度、字号与行高,可控制品牌、普通与等宽字体,可调整第三色方向,加入等宽字体,状态层不使用脚本,可在暗色模式下压暗图片,并提供形状比例控制。安装方式包括克隆仓库到 themes 目录、下载解压,或使用 Hugo Modules;配置中需声明 theme 为 PolyRhythmic。README 给出的最低 Hugo 版本为 v0.132.2。
适合你的项目吗?
适用场景
- 搭建以 Material Design 3 为视觉基调的个人博客或文档型站点
- 需要搜索、粘性目录、明暗切换等阅读体验的 Hugo 内容站
- 希望把 Logseq 图谱以单页应用形式嵌入站点的用户
- 需要联系表单、归档、多作者与分类组织的站点
- 想通过主题配置调整字体、颜色、形状与正文宽度的定制需求
适合人群
- 熟悉 Hugo 并愿意自行处理开发中主题问题的用户
- 偏好 Material Design 3 视觉风格的个人站点作者
- 需要搜索、目录、明暗切换等阅读功能的博客或文档站点
- 希望以 MIT 许可代码为基础进行修改和分发的开发者
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
README 标注最低 Hugo 版本为 v0.132.2,安装前请确认本地 Hugo 版本
- 2
可通过 git clone 到 themes 目录、下载解压,或使用 Hugo Modules 三种方式安装
- 3
在 config.yaml 中设置 theme: ["PolyRhythmic"] 后即可启用
- 4
主题仍处于大量开发中,README 建议谨慎使用,建议先在测试站点验证
- 5
演示图片、字体、图标等第三方素材需按各自许可单独核对
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明本次收录的是公开仓库中采用 MIT 许可的免费版本;免费范围为该版本代码,不代表外部服务或第三方素材免费。
使用时需要遵守
- 允许免费使用、修改、商用和分发该版本代码。
- 分发代码副本或实质性部分时,保留原作者版权声明和完整 MIT 许可声明。
- 代码按现状提供;担保与责任限制以原许可证及适用法律为准。
额外费用与待核对事项
- README 明确说明该主题仍处于大量开发阶段,建议谨慎使用;这意味着功能可能不稳定、接口可能变动,不适合直接用于对稳定性有要求的正式生产站点。
- 使用该主题需先自行安装 Hugo 静态站点生成器,并满足 README 标注的最低版本 v0.132.2,否则可能无法正常构建。
- 若选择 Hugo Modules 方式安装,需要额外安装 Go 工具链;不使用该方式则无此要求。
- 搜索功能依赖第三方库 Fuse.js,其自身许可与主题 MIT 许可相互独立,分发或商用前需单独核对该依赖的许可条款。
- 主题使用 Material Symbols 图标等第三方素材,这些素材的许可与主题代码的 MIT 许可相互独立,需按各自许可单独核对后再使用。
- 主题引用 Google Fonts 字体资源,字体的许可与主题代码许可相互独立,使用前应确认具体字体的授权条件。
- README 提供 GitHub Sponsors 与 Ko-Fi 赞助渠道,属于自愿捐赠,并非使用主题的付费前提或功能限制。
- 演示图片、字体、图标及其他第三方素材需按各自许可核对,不能仅凭代码的 MIT 许可判断。
- 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
查看原文依据
Permission is hereby granted, free of charge
许可证原文
This theme is still very much in development. Please use with caution.
README 原文
Install Hugo: [Hugo Docs's - Quick Start]
README 原文
Install [Go](https://go.dev/doc/install)
README 原文
Search functionality with Fuse.js
README 原文
[**Material Symbols**](https://github.com/google/material-design-icons)
README 原文
[**Google Fonts**](https://fonts.google.com/)
README 原文
https://github.com/wonyoung-jang/hugo-PolyRhythmic/blob/main/LICENSEhttps://github.com/wonyoung-jang/hugo-PolyRhythmic/blob/main/README.mdIf you would like to sponsor me, you can through [Github Sponsors]
README 原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-10-03。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- Hugo Themes
- 资料与维护参考分
- 资料较完整 · 87 / 100
- 技术栈
- Hugo
- 网站类型
- 启动器
这个分数如何计算
本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2026-02-21
- 截图检查日期
- 2026-10-03
已收录演示链接。请用你的内容与屏幕尺寸检查;有演示不代表表单、认证或支付已经可用。
目录记录的主要技术栈是 Hugo。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
审核声明: [email protected] · 2026-10-04
查看当时使用的来源资料
SHA-256: 364f75725560db9e84c455637cb8b420a3685d7383e0c04ef8db0a958f4053d1
2026-10-03T17:05:59.952Z
来源文件 / 仓库<h1 align=center>Hugo PolyRhythmic | <a href="https://polyrhythmic.xyz/" rel="nofollow">Live Demo</a></h1>
<h4 align=center>Fast | Responsive | Material Design 3</h4>
<h3 align=center>❗This theme is still very much in development. Please use with caution.</h3>
<h3 align=center>PolyRhythmic is on:
<a href="https://themes.gohugo.io/themes/hugo-polyrhythmic/" rel="nofollow">Hugo Themes</a> |
<a href="https://github.com/wonyoung-jang/hugo-PolyRhythmic" rel="nofollow">GitHub</a> |
<a href="https://www.producthunt.com/posts/polyrhythmic" rel="nofollow">Product Hunt</a>
</h3>
<br>
<!-- **See documentation** here: [**Wiki**](https://github.com/wonyoung-jang/hugo-PolyRhythmic/wiki) -->
<!-- **See exampleSite** source here: [**exampleSite**](https://github.com/wonyoung-jang/hugo-PolyRhythmic-demo) -->
[](https://github.com/gohugoio/hugo/releases/tag/v0.132.2)
[](https://github.com/wonyoung-jang/hugo-PolyRhythmic/blob/main/LICENSE)

<p align="center">
<kbd>
<img
src="https://raw.githubusercontent.com/wonyoung-jang/hugo-PolyRhythmic/main/images/tn.png"
alt="Screenshot"
title="Screenshot"/>
</kbd>
</p>
<p align="center">
<kbd>
<img
src="https://raw.githubusercontent.com/wonyoung-jang/hugo-PolyRhythmic/main/images/screenshot.png"
alt="Screenshot"
title="Screenshot"/>
</kbd>
</p>
## Key Features
- Active menu location indicator
- Archive support
- **Asset management**: pipeline, fingerprint, bundle, and minify Hugo assets
- Back-to-top button
- Backlinks and related page suggestions
- Code copy button
- **Contact template**: quick contact form
- Cover images for individual pages
- Custom tabbed navigation
- Debug mode for development
- GitHub repository buttons for pages
- Home page navigation buttons
- Keyboard shortcuts and access keys
- Light/dark theme toggle
- Logseq graphs as a Single Page Application (SPA)
- Multiple author support
- **"Now" page table**: list of recently updated pages
- Page navigation cards
- Random page button
- Responsive sticky table of contents
- Search functionality with Fuse.js
- SEO optimization
- **Sitemap template**: table with Hugo-specific columns
- Social media share buttons
- Taxonomies and sections organization
- **Theme customization**: control color, contrast, shape, typography, and more
## Key Differences from Material 3
- Adjustable content text width, font size, and line height
- Control over brand, plain, and mono typefaces
- Direction control for tertiary color
- Mono typeface addition
- No use of scripting for state layers
- Option to dim images in dark mode
- Shape scale control
---
## Install
1. Install Hugo: [Hugo Docs's - Quick Start](https://gohugo.io/getting-started/quick-start/)
2. Create a new Hugo site
```bash
# replace YourSite with your website's name
hugo new site YourSite --format yaml
```
3. Add PolyRhythmic to your `YourSite/themes/` directory
- **Option 1: Clone git repository:**
```bash
git clone https://github.com/wonyoung-jang/hugo-PolyRhythmic themes/PolyRhythmic --depth=1
```
- **Option 2: Download and unzip:**
- Download the PolyRhythmic source and extract the zip in your `YourSite/themes/PolyRhythmic` directory
- **Option 3: Use Hugo Modules**
- Install [Go](https://go.dev/doc/install)
- Intialize your own hugo module:
```bash
hugo mod init YOUR_GIT_REPO
```
- Add PolyRhythmic in your `config.yaml` or `module.yaml`
```yaml
# config.yaml
module:
imports:
- path: github.com/wonyoung-jang/hugo-PolyRhythmic
# module.yaml
imports:
- path: github.com/wonyoung-jang/hugo-PolyRhythmic
```
4. In your `config.yaml` add:
```yaml
theme: ["PolyRhythmic"]
```
---
## Support
- Star, share, and use this repository on [GitHub](https://github.com/wonyoung-jang/hugo-PolyRhythmic)
- If you would like to sponsor me, you can through [Github Sponsors](https://github.com/sponsors/wonyoung-jang)
- You may also donate on [Ko-Fi](https://ko-fi.com/wonyoung_jang)
---
## Thanks
- [**Fuse.js**](https://github.com/krisk/fuse)
- [**Material Symbols**](https://github.com/google/material-design-icons)
- [**Material Design 3**](https://m3.material.io/)
- [**Google Fonts**](https://fonts.google.com/)
看看同类模板
对比同技术栈与用途的模板,找到更适合的视觉与内容结构。

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 · 启动器
