3 步装好 Zola 主题 kirifuji：从克隆仓库到自定义导航菜单
【免费下载链接】zolaA fast static site generator in a single binary with everything built-in. https://www.getzola.org项目地址: https://gitcode.com/GitHub_Trending/zo/zola
kirifuji 是一款面向 Zola 静态站点生成器的极简紫色博客主题：白底、充足留白、深紫色标题，顶部一条水平文字导航，布局响应式，观感取自 terriblesoftware.org 与 fhur.me 的设计语言。适合想花最少时间做出干净个人博客的你。装好并构建后，标题、正文与页脚署名都会居中排布，效果如下。
3 步把 kirifuji 克隆并启用 🔧
第 1 步，克隆主题到themes目录。这是官方推荐的标准装法，目录名就是后续配置里的主题名：
git clone https://codeberg.org/yukari/kirifuji-zola themes/kirifuji第 2 步，在config.toml顶层启用主题：
theme = "kirifuji"第 3 步，在[extra]里补上导航菜单，运行zola serve，即可在本地看到导航与版式生效。
如果你希望主题随上游仓库长期同步，可以改用git submodule add <仓库地址> themes/kirifuji（站点需先git init）；普通克隆相当于"一次性快照"，两种装法最终都落在themes/kirifuji。
导航菜单与页脚署名：config.toml 改两处就行
完整官方样例在 docs/content/themes/kirifuji/index.md，核心只有[extra]下的两个键：
| 键 | 类型 | 作用 | 默认值 |
|---|---|---|---|
navigationMenu | 对象数组 | 顶部导航栏条目，每项一个{ name = "显示文字", path = "链接路径" } | 无（不显示导航） |
hideThemeName | 布尔值 | 是否隐藏页脚的 "Powered by Zola and Kirifuji" 署名 | false（不隐藏） |
[extra] navigationMenu = [ { name = "log", path = "/log"}, { name = "contact", path = "/contact"} ]三个容易配错的地方：
- 增删导航项，就是在数组里增删
{ name, path }对象，不用动模板； path可以写站内路径（如/log），也可以写完整 URL；hideThemeName在主题样例中是被注释掉的，想隐藏署名需取消注释并设为true。
不改主题源码，也能覆盖模板和静态文件
Zola 的主题机制允许你"只加不改"：在站点自己的templates/或static/里创建与主题内相同相对路径、同名文件，站点文件就会优先于主题文件生效，比如templates/index.html覆盖主题的首页模板。如果主题模板定义了 block，还能用{% extends %}只重写其中某一个块，其余部分原样保留。主题文件始终可用kirifuji/templates/这类路径被引用，不会被你删掉。
上游更新了怎么跟进
克隆安装的主题自带 git 历史，进入themes/kirifuji执行 pull 拉取即可同步上游；子模块安装则在更新子模块后提交版本指针，别人克隆你的站点便能还原同一版本。有一条硬规矩：不要直接改themes/kirifuji/里的文件——改动虽能生效，但会让升级难以合并，且这些文件不参与 live reload。
装完不生效？对照这份避坑清单 ⚠️
- 构建后没有导航和样式：你把
theme写进了[extra]或[markdown]小节里。Zola 只从顶层读取它，移到文件最上面即可。 - 主题名对不上目录名：
theme的值必须与themes/下的文件夹名完全一致，克隆到themes/kirifuji就写theme = "kirifuji"。 - 功能缺失或行为异常：该主题要求 Zola 0.4.0 及以上版本（
minimum_version = "0.4.0"），确认你的 Zola 版本满足。 - 改了主题文件浏览器不刷新：直接修改 themes/ 下的文件不受监视，改走站点
templates/static覆盖的方案。
许可证合规与延伸阅读
主题本身采用 0BSD 许可，内置 Alan Sans 字体采用 OFL-1.1（SIL Open Font License 1.1），均对商用友好；保留一行署名即可兼顾合规与致谢。
- 安装与使用主题
- 自定义主题（模板覆盖）
- 配置参考
- kirifuji 主题页
【免费下载链接】zolaA fast static site generator in a single binary with everything built-in. https://www.getzola.org项目地址: https://gitcode.com/GitHub_Trending/zo/zola
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
