三步装好 Zola kirifuji 主题，十分钟把网站改造成干净的紫色博客

三步装好 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 博客主题就是现成答案一条克隆命令加一段[extra]配置紫色调的极简博客就能跑起来导航栏和页脚署名也都能改。两种把主题放进站点的办法选 clone 还是 submoduleZola 的约定是所有主题都放在站点根目录的themes/文件夹里文件夹名就是主题名后面的配置全靠它对号入座。把 kirifuji 源码放进themes/kirifuji/有两种主流做法差别只在一处以后更新主题时你愿不愿意多一步操作。一次性快照直接把仓库克隆进目标目录git clone kirifuji 主题仓库地址 themes/kirifuji主题仓库地址写在 Zola 官方主题目录里的 kirifuji 主题页 上。这种方式最省事缺点是下次上游更新时需要你自己手动拉取。持续跟进上游如果希望主题版本指针记录在你的站点仓库里别人克隆你的站点后执行git submodule update --init就能还原出同样的主题且你的站点本身已经是 Git 仓库就用子模块git submodule add kirifuji 主题仓库地址 themes/kirifuji若站点还没初始化 Git先git init再执行上一条。当然手动下载压缩包解压到themes/kirifuji也行只是失去了版本管理升级全靠肉眼比对一般不推荐。三步跑通主题目录名、顶层变量、extra 区段主题文件就位后还差两步声明它已就位。第一步确认目录名。把主题克隆进了themes/kirifuji配置里写的就必须是kirifuji一个字符都不能差。第二步声明theme变量。在站点根目录的config.toml或zola.toml中加上theme kirifuji这里有一个新手最容易踩的坑theme必须写在 TOML 文件的顶层一旦缩进进[extra]、[markdown]之类的区段里就失效了。构建时 Zola 会先去themes/kirifuji/templates/找模板、从themes/kirifuji/static/提供静态资源如果你的站点自己的templates或static里恰好有同名文件则以你的为准。第三步填好[extra]区段具体字段见下一节。三件事齐了之后执行zola serve起本地服务浏览器里就能看到紫色效果了。配置顶部导航与页脚署名[extra]里的两个字段[extra]是 Zola 留给模板的自由数据区写进去的键值对在模板中都能以config.extra.你的键的形式读到。kirifuji 正好用它做了两件事渲染顶部那条水平导航栏以及决定页脚要不要显示署名文字。参数默认值作用hideThemeNamefalse显示署名设为true后隐藏页脚的 Powered by Zola and Kirifuji 文字navigationMenu未设置时不显示导航栏对象数组每项含name显示文字和path链接路径完整示例[extra] # 想隐藏页脚署名时把下面一行取消注释 # hideThemeName true navigationMenu [ { name log, path /log }, { name fun, path /fun }, { name contact, path /contact }, { name misc., path /misc } ]导航项想加几个就加几个path写站内相对路径如/log或完整 URL 都可以菜单顺序就是数组顺序改完保存即可生效不需要碰任何模板文件。不动主题源码也能改三层覆盖机制Zola 的主题机制决定了你的站点文件永远优先于主题文件所以个性化完全可以发生在themes/目录之外从粗到细有三层整模板替换在站点templates/下建一个与主题模板相对路径、文件名完全相同的文件例如templates/index.html会直接顶替主题里的首页模板只覆写某个 block主题模板若用了 Tera 的块继承你可以继承它再重写指定部分{% extends kirifuji/templates/index.html %} {% block some_block %} {% raw %}只改这一小块的内容{% endraw %} {% endblock %}覆盖静态资源static/下同名文件同样会压过主题里的同名文件比如替换一张头图或一段 CSS。另外主题模板在任何地方都能通过kirifuji/templates/文件名这种带主题名的路径引用到不受你是否有同名覆盖影响。有一条红线要记住别直接改themes/kirifuji/里面的文件。改动虽然能生效但以后升级主题时冲突会很难收拾而且 live reloadZola 开发模式下文件变更即时刷新对这些文件不工作。想保留对主题的改动历史正确姿势永远是覆盖不是修改。上线前核对两项版本下限与许可证kirifuji 的元数据标注minimum_version 0.4.0——0.4.0 是它的版本下限如今任何一个主流 Zola 版本都远超这个数基本不用操心。授权方面可以放宽心主题代码采用0BSD许可几乎不设限制主题内置的Alan Sans 字体按OFL-1.1SIL 开放字体许可证 1.1授权。两类许可对商业站点同样友好如果你在意合规声明在页脚或 README 里提一句这两项许可来源即可。下一步建议先zola serve跑起来看真实效果再按内容栏目调整navigationMenu最后才考虑模板覆盖。想深入机制可以从仓库内的 主题安装与使用、定制主题 读起配置全貌见 配置参考等熟悉之后还可以照着 创建主题 自己动手写一个。【免费下载链接】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），仅供参考