3 步装好 Zola 主题 kirifuji：从克隆仓库到自定义导航菜单

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/zolakirifuji 是一款面向 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也可以写完整 URLhideThemeName在主题样例中是被注释掉的想隐藏署名需取消注释并设为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.1SIL 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），仅供参考