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给 Zola 站点换上 kirifuji 主题后你得到的是一个白底、大留白的博客页面站点名和顶部导航log、fun、contact、misc.用深紫色正文里的超链接是蓝色页脚居中显示版权行和 Powered by Zola and Kirifuji 署名。装好主题后只需在config.toml里改两个键就能把导航菜单改成你自己的栏目、把页脚署名关掉。这篇 Zola 主题指南按三件事展开把站点跑起来、把菜单和页脚改成自己的样子、不动主题源码做定制。三步把站点跑起来版本与目录要求kirifuji 元数据里声明minimum_version 0.4.0见 主题文档即需要 Zola 0.4.0 以上版本0.4.0 是很早期的版本现在装 Zola 基本都满足。Zola 约定主题一律放在站点根目录的themes/下目录不存在就先建好。两种安装途径的取舍途径做法适合谁git clonegit clone 主题仓库地址 themes/kirifuji装一次就够用升级时手动拉取git submodulegit submodule add 主题仓库地址 themes/kirifuji希望主题版本被站点仓库追踪他人克隆后可还原、可跟上游升级一句话clone 是一次性快照submodule 给主题装了一个版本指针。仓库地址直接抄 主题文档 里的两者是同一条命令。克隆时最后那段路径决定主题目录名这个目录名必须和后面配置里的theme值一字不差。git clone https://codeberg.org/yukari/kirifuji-zola themes/kirifuji如果站点本身还没git init先初始化再改用 submodule 方式。改菜单和页脚只动 config.toml 两个键把下面片段贴进zola.toml没有就用config.tomlZola 找不到zola.toml时会回退加载它theme kirifuji [extra] # 取消注释可隐藏页脚的 Powered by Zola and Kirifuji # hideThemeName true navigationMenu [ { name log, path /log}, { name fun, path /fun}, { name contact, path /contact}, { name misc., path /misc} ]注意theme kirifuji必须写在 TOML 最外层不能塞进[extra]、[markdown]这类小节内部。原因是 Zola 只从配置顶层读theme变量位置放错时构建直接报错报的往往是找不到模板排查起来容易跑偏。两个键的作用如下都在 主题文档 里有定义键类型作用默认值navigationMenu对象数组定义顶部导航菜单每项含name显示文字和path链接站内路径或完整 URL 都行未设置则不显示菜单hideThemeName布尔值隐藏页脚的 Powered by Zola and Kirifuji 署名false即默认显示改哪个栏目就动navigationMenu里对应的{ name, path }增删项即可。不动主题源码的定制方法直接改themes/kirifuji/里的文件能用但主题一升级改动就容易被冲掉而且 live reload 不追踪themes目录下的文件改完不会热更新。Zola 的主题机制允许你在站点侧覆盖同名文件优先级是站点文件压过主题文件见 主题定制文档四条路径整份替换在站点templates/下放与主题同路径同名的模板比如新建templates/index.html就接管首页局部覆写用 Tera 的 block 继承只重写想改的块主题其余部分原样保留静态资源覆盖static/下的同名文件覆盖主题里的同名文件比如换掉字体文件[extra]覆写像上面navigationMenu这样主题暴露的变量在站点配置里重新赋值。block 继承的写法{% extends kirifuji/templates/index.html %} {% block some_block %} {{ page.summary }} {% endblock %}extends后面跟的是theme_name/templates/下的完整相对路径如果主题模板没把主题名硬编码进路径也可以直接写extends index.html。跟上更新与授权注意事项clone 和 submodule 两种装法都保留了 git 历史后续跟上游同步的区别只在操作方式clone 进themes/kirifuji手动拉取submodule 则在站点仓库里更新版本指针协作者重新克隆后执行git submodule update --init即可还原同一版本。授权方面主题本体是 0BSD内置的 Alan Sans 字体是 OFL-1.1见 主题文档 的 License 一节两者对个人博客和商用站点都友好按惯例在页脚或 README 里注明来源即可。改完[extra]后运行zola build看输出或用zola serve边改边看刷新页面就能确认新菜单和页脚生效。【免费下载链接】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），仅供参考