Hugo作品集博客

tirra — Hugo 作品集模板

作者 himloul

tirra 是一个采用 MIT 许可的 Hugo 主题，面向写作与数字花园场景，把 content/ 下的 Markdown 文件与文件夹直接发布为页面。

打开源站下载源码 ZIP

看看你的网站会是什么样

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

2 个预览视图

桌面端首页1 / 2

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

桌面端截图首屏预览

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

全部页面与视图 2

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

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

值得关注的模板亮点

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

content/ 下的 Markdown 文件与文件夹直接发布为页面，文件夹页面带面包屑导航

阅读辅助包括窄栏排版、目录、阅读时间、进度条与返回顶部

写作支持服务端 KaTeX、mermaid 代码块与 `> [!type]` callout

内置深色模式、Ctrl+K 全文搜索、标题锚点、JSON-LD 与 Open Graph 元信息

通过 service worker 与 manifest 提供离线阅读和可安装应用能力

模板详细介绍

tirra 是一个 Hugo 主题，作者将其定位为面向写作的数字花园（digital garden）。站点内容以 Markdown 文件组织：notes、文件夹与 posts 都会发布为页面，content/ 下的文件夹会变成带面包屑导航的页面，因此 Obsidian 仓库可以按原样放入。主题名 tirra（ⵜⵉⵔⵔⴰ）在 Tamazight 语中意为“写作”。

阅读体验方面，主题提供窄栏排版、目录（TOC）、阅读时间、进度条与返回顶部。写作方面支持纯 Markdown，并在服务端渲染 KaTeX 公式、mermaid 代码块以及 `> [!type]` 形式的 callout。站点基础功能包括深色模式（跟随系统并记住手动切换）、全文搜索（Ctrl+K）、通过 service worker 与 manifest 实现的离线阅读与可安装应用、标题锚点，以及 JSON-LD 和 Open Graph 元信息。

使用上有明确限制：需要 Hugo ≥ 0.146.0；安装时需以 git submodule 方式加入 themes/tirra，并在配置中设置 theme = "tirra" 以及 [markup] 下的 _merge = "deep"，否则主题的 markup 默认值不会生效。起步方式是复制 exampleSite/，修改 baseURL 与 title，删除演示文章；调色板、字体、宽度与搜索参数位于 hugo.toml 的 [params.theme] 下，调色板与 callout 颜色默认来自 assets/css/main.css，只需覆盖想改的键。

Hugo作品集博客

适合你的项目吗？

适用场景

把 Obsidian 仓库按原样放入 content/ 作为数字花园发布
用 Markdown 写笔记、文章并需要目录、阅读时间等阅读辅助
在文章中插入数学公式、mermaid 图表与提示框
需要深色模式、全文搜索与离线阅读的静态站点

适合人群

使用 Hugo 并希望以 Markdown 文件夹组织内容的写作者
已有 Obsidian 笔记库、想直接发布为网站的人
需要 KaTeX、mermaid 与 callout 等写作增强功能的站点

上手与定制指南

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

1
需要 Hugo ≥ 0.146.0
2
以 git submodule 方式安装：git submodule add https://github.com/himloul/tirra.git themes/tirra
3
配置中设置 theme = "tirra"，并在 [markup] 下设置 _merge = "deep"，否则主题的 markup 默认值不会生效
4
复制 exampleSite/ 作为起点，修改 baseURL 与 title 并删除演示文章
5
调色板、字体、宽度与搜索参数在 hugo.toml 的 [params.theme] 下调整；调色板与 callout 颜色默认来自 assets/css/main.css

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

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

使用时需要遵守

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

额外费用与待核对事项

使用该主题需要 Hugo 0.146.0 或更高版本，低于此版本的 Hugo 无法正常构建站点。
必须在配置的 [markup] 下设置 _merge = "deep"，否则主题自带的 markup 默认值不会生效。
官方安装方式为以 git submodule 形式将主题加入 themes/tirra 目录，并需在配置中设置 theme = "tirra"。
起步需复制 exampleSite/ 作为基础，修改 baseURL 与 title，并删除其中的演示文章。
演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
域名、托管、数据库、支付或 AI 等外部服务可能另外收费。

查看原文依据

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

Requires Hugo ≥ 0.146.0
README 原文

`_merge = "deep"` is required for the theme's markup defaults to apply.
README 原文

git submodule add https://github.com/himloul/tirra.git themes/tirra
README 原文

Copy `exampleSite/` - a working demo of everything — edit `baseURL` and `title`, delete the demo posts.
README 原文

https://github.com/himloul/tirra/blob/main/LICENSE https://github.com/himloul/tirra/blob/main/README.md

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

项目核对记录与介绍依据

模板资料

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

这个分数如何计算

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

这个项目需要核对什么

记录的仓库更新时间: 2026-08-26
截图检查日期: 2026-10-01

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

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

查看具体选型方法 →

介绍的制作与核对状态

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

已完成服务器许可规则与 AI 来源核对；未经过人工编辑审核。

查看当时使用的来源资料

SHA-256: 1175f5750b659356aeb238816c5a0a917195bc62121b3343922be9c5dd2a0a93

2026-10-01T01:20:15.347Z

来源文件 / 仓库

# tirra



A Hugo theme for a digital garden. Your whole site is a folder of Markdown files:
notes, folders, and posts publish as pages. Nothing else to build.

*tirra* (ⵜⵉⵔⵔⴰ) means "writing" in Tamazight.

Demo: https://tirra-hugo.pages.dev/ · Requires Hugo ≥ 0.146.0

## Screenshots

<p align="center">
  <img src="https://raw.githubusercontent.com/himloul/tirra/main/images/sc.png" alt="Home, desktop" width="72%">
  <img src="https://raw.githubusercontent.com/himloul/tirra/main/images/sc-grid.png" alt="Articles, Grid" width="24%">
</p>

## What you get

- **Reading:** narrow column, TOC, reading time, progress bar, back-to-top
- **Writing:** plain Markdown with server-side KaTeX, `mermaid` fences, and `> [!type]` callouts
- **Navigation:** folders under `content/` become pages with breadcrumbs — an Obsidian vault drops in as-is
- **Web basics:** dark mode (system + remembered toggle), full-text search (`Ctrl+K`), offline reading + installable app (service worker + manifest), heading anchors, JSON-LD and Open Graph meta

## Install

```sh
git submodule add https://github.com/himloul/tirra.git themes/tirra
```

```toml
theme = "tirra"

[markup]
  _merge = "deep"
```

`_merge = "deep"` is required for the theme's markup defaults to apply.

## Start

Copy `exampleSite/` - a working demo of everything — edit `baseURL` and `title`, delete the demo posts. Palettes, fonts, width, and search tuning live under `[params.theme]` in `hugo.toml`. Palette and callout colors default to `assets/css/main.css`; set only the keys you want to override.

## License

MIT. See `LICENSE`.

反馈内容错误