Hugo启动器

kavu — Hugo 启动器模板

作者 stultus

Kavu 是一个面向数字花园与个人知识库的 Hugo 主题，采用等宽字体与终端风格，支持笔记成熟度、反向链接和交互式网络图。

打开源站下载源码 ZIP

看看你的网站会是什么样

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

3 个预览视图

桌面端首页1 / 3

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

桌面端截图首屏预览

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

全部页面与视图 3

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

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

值得关注的模板亮点

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

等宽字体与终端风格设计，使用 JetBrains Mono、IBM Plex Mono、Fira Code，并提供 Nord 风格配色与完整深色模式

通过 frontmatter 的 status 字段区分 seeding、growing、evergreen 三档笔记成熟度

笔记页自动生成带摘要的反向链接，并支持随机笔记导航

交互式力导向网络图，支持搜索、悬停高亮邻居、标签避让、缩放、适应视图、全屏与键盘快捷键

标签体系包含标签云、可按 Recent / A-Z / Status 排序的标签页与基于共现的相关标签

支持 Wikilink 风格 [[bracket]] 内部链接渲染与马拉雅拉姆字体（Manjari）

模板详细介绍

Kavu 是一个 Hugo 主题，定位为数字花园与个人知识库的呈现层。它源自 paulmartins/hugo-digital-garden-theme，之后经过大幅重写，形成新的设计系统、首页、笔记页、标签系统、网络图和 CSS 架构。主题名取自喀拉拉邦的神圣树林（കാവ്）。

内容组织上，主题通过 frontmatter 的 status 字段区分笔记成熟度：seeding（草稿或粗略想法）、growing（有初步展开、部分链接的草稿）、evergreen（打磨完成、链接充分、理解稳定）。笔记页提供内联元信息栏（成熟度、日期、阅读时长）、摘要副标题、标签胶囊、带摘要的自动反向链接以及随机笔记导航。首页提供花园统计、最近更新与连接最多的入口、按主题浏览的可折叠卡片、可筛选排序的完整笔记索引、随机笔记按钮，以及可搜索、悬停高亮、支持全屏的交互式网络图。

标签系统包含带笔记数量的标签云、可按 Recent / A-Z / Status 排序的标签页，以及基于共现的相关标签发现。网络图是全部笔记及其连接力导向图，悬停可高亮节点与邻居并显示标签，带标签避让，支持搜索、缩放、适应视图和全屏，并有 / 搜索、F 适应、Shift+F 全屏、+/- 缩放等键盘快捷键。

设计上使用等宽字体（JetBrains Mono、IBM Plex Mono、Fira Code）、受 Nord 启发的 CSS 变量配色、完整深色模式、响应式布局、Wikilink 风格 [[bracket]] 内部链接渲染，并支持马拉雅拉姆字体（Manjari）。

使用限制方面：内部链接需使用绝对路径（如 /notes/note-slug/），以保证主题的链接解析器正常工作；主题默认在页脚渲染一行“Built with Kavu by stultus”署名，可通过 hugo.toml 中的 params.hideThemeCredit 关闭。仓库采用 MIT 许可，免费范围为该版本代码，演示图片、字体、图标等第三方素材需按各自许可核对。

Hugo启动器

适合你的项目吗？

适用场景

搭建以笔记相互链接为核心的个人数字花园
整理并发布带有成熟度标记的个人知识库
用网络图直观浏览笔记之间的连接关系
按主题、标签或状态浏览与筛选笔记索引

适合人群

使用 Hugo 构建站点的用户
以笔记和双向链接组织内容的写作者
希望以终端风格呈现数字花园的开发者
需要标签体系与笔记成熟度标记的知识管理场景

上手与定制指南

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

1
以 git submodule 方式将主题添加到 themes/kavu，并在 hugo.toml 中设置 theme = "kavu" 与 themesdir = "./themes"
2
笔记 frontmatter 需包含 title、date、lastmod、draft、tags、summary、status（seeding | growing | evergreen）与 type（note | essay | moc | source）
3
内部链接使用绝对路径（如 /notes/note-slug/），以确保主题的链接解析器正常工作
4
主题默认在页脚显示“Built with Kavu by stultus”，可在 hugo.toml 的 [params] 中设置 hideThemeCredit = true 关闭

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

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

使用时需要遵守

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

额外费用与待核对事项

内部链接必须使用绝对路径（如 /notes/note-slug/），否则主题的链接解析器无法正常工作。
主题默认在页脚渲染“Built with Kavu by stultus”署名；可通过 hugo.toml 中 params.hideThemeCredit = true 关闭，保留署名是被鼓励但非强制的。
演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
域名、托管、数据库、支付或 AI 等外部服务可能另外收费。

查看原文依据

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

Use absolute paths for internal links to ensure the theme's link resolver works correctly
README 原文

Kavu renders a small "Built with Kavu by stultus" line in the footer by default. If you'd rather not include it, set in your `hugo.toml`:
README 原文

https://github.com/stultus/kavu/blob/main/LICENSE https://github.com/stultus/kavu/blob/main/README.md

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

项目核对记录与介绍依据

模板资料

来源平台: Hugo Themes
资料与维护参考分: 资料较完整 · 83 / 100
技术栈: Hugo
网站类型: 启动器

这个分数如何计算

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

这个项目需要核对什么

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

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

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

查看具体选型方法 →

介绍的制作与核对状态

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

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

查看当时使用的来源资料

SHA-256: 0ed151c51fb4ae655b8c95d7d3d224bcf4a392287d7220d14baf339f78ea53b8

2026-10-04T02:47:22.092Z

来源文件 / 仓库

<p align="center">
  <img src="https://raw.githubusercontent.com/stultus/kavu/main/images/kavu-cover.png" alt="Kavu — A digital garden for Hugo" width="320" />
</p>

# Kavu

> Named after the കാവ് (kavu), the sacred groves of Kerala: small, protected, deliberately overgrown.

A monospace, terminal-inspired Hugo theme for digital gardens and personal knowledge bases. Designed around the principles of interconnected note-taking, with support for note maturity stages, network graph visualization, and dense cross-linking.

**Live site**: [stultus.in/notes](https://stultus.in/notes/)

## Preview

Homepage — dark and light:

| Dark | Light |
| :---: | :---: |
| ![Homepage, dark](https://raw.githubusercontent.com/stultus/kavu/main/images/screenshot-home-dark.png) | ![Homepage, light](https://raw.githubusercontent.com/stultus/kavu/main/images/screenshot-home-light.png) |

Network graph — force-directed view of all notes coloured by maturity:

| Dark | Light |
| :---: | :---: |
| ![Network graph, dark](https://raw.githubusercontent.com/stultus/kavu/main/images/screenshot-graph-dark.png) | ![Network graph, light](https://raw.githubusercontent.com/stultus/kavu/main/images/screenshot-graph-light.png) |

Browse-by-topic and the full note index:

| Dark | Light |
| :---: | :---: |
| ![Topics and index, dark](https://raw.githubusercontent.com/stultus/kavu/main/images/screenshot-topics-dark.png) | ![Topics and index, light](https://raw.githubusercontent.com/stultus/kavu/main/images/screenshot-topics-light.png) |


## Features

**Homepage**
- Live garden statistics (total notes, evergreen/growing/seedling counts)
- Recently Tended and Most Connected entry points
- Collapsible topic cards for browsing by theme
- Filterable and sortable full note index
- Random note discovery button
- Interactive network graph with search, hover highlighting, and fullscreen mode

**Note Pages**
- Inline metadata bar: maturity status, dates, reading time
- Summary subtitle and tag pills
- Automatic backlinks with summaries
- Random note navigation

**Tag System**
- Tag cloud with note counts
- Sortable tag pages (Recent / A-Z / Status)
- Related tags discovery based on co-occurrence

**Network Graph**
- Force-directed graph of all notes and their connections
- Hover to highlight a node and its neighbors with labels
- Label collision avoidance
- Search, zoom, fit-to-view, and fullscreen controls
- Keyboard shortcuts: `/` search, `F` fit, `Shift+F` fullscreen, `+`/`-` zoom

**Design**
- Monospace typography (JetBrains Mono, IBM Plex Mono, Fira Code)
- Nord-inspired color palette with CSS variables
- Full dark mode support
- Responsive layout
- Wikilink-style `[[bracket]]` rendering for internal links
- Malayalam font support (Manjari)

## Note Maturity

Notes use a `status` frontmatter field to indicate maturity:

| Status | Meaning |
|--------|---------|
| `seeding` | Stub or rough idea |
| `growing` | Developed draft, partially linked |
| `evergreen` | Polished, well-linked, stable understanding |

## Getting Started

```bash
# Add as a submodule
git submodule add [email protected]:stultus/kavu.git themes/kavu
```

Set in `hugo.toml`:
```toml
theme = "kavu"
themesdir = "./themes"
```

### Frontmatter

```yaml
---
title: "Your Note Title"
date: 2025-01-01
lastmod: 2025-01-15
draft: false
tags: ["topic-a", "topic-b"]
summary: "One-line description of the note."
status: "seeding"  # seeding | growing | evergreen
type: "note"       # note | essay | moc | source
---
```

### Internal Links

Use absolute paths for internal links to ensure the theme's link resolver works correctly:

```markdown
[Note Title](/notes/note-slug/)
```

## Theme credit

Kavu renders a small "Built with Kavu by stultus" line in the footer by default. If you'd rather not include it, set in your `hugo.toml`:

```toml
[params]
  hideThemeCredit = true
```

Keeping it on is appreciated — it helps other people find the theme.

## Origin

Kavu was originally forked from [paulmartins/hugo-digital-garden-theme](https://github.com/paulmartins/hugo-digital-garden-theme), which was inspired by [Maggie Appleton's website](https://maggieappleton.com/). It has since been substantially rewritten with a new design system, homepage, note pages, tag system, network graph, and CSS architecture.

## License

MIT

反馈内容错误