3 步装好 kirifuji 主题快速搭建紫色极简 Zola 博客站【免费下载链接】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 静态站点生成器的紫色极简博客主题纯白底、深紫标题、一排文字导航、大量留白。这篇写给想要干净易读个人博客的 Zola 用户讲清 Zola 主题 kirifuji 的完整安装流程、导航菜单配置以及不碰源码的定制方法10 分钟内就能让站点跑起来。先看效果kirifuji 适合谁装好之后长这样页面顶部左侧是站名右侧排着 log、fun、contact 几个纯文字链接中间只有正文底部居中一行版权信息和 Powered by Zola and Kirifuji。没有卡片、没有侧栏屏幕完全让给文字。这种版式适合以长文、技术笔记为主希望读者视线只落在内容上的人站点结构简单、不需要标签、卡片、侧栏这类复杂组件的用户想快速发布个人主页后续愿意自己动手微调模板的人。如果你想要的是多组件、重装饰的页面建议先翻一遍官方主题画廊挑功能更全的主题。3 步装好 kirifuji 主题第 1 步把主题放进 themes/ 目录Zola 约定所有主题都放在站点根目录的themes/下。先在kirifuji 主题页上找到主题仓库地址然后克隆进站点git clone kirifuji 仓库地址 themes/kirifuji 注意目标目录名就叫kirifuji它会被直接当作配置里的主题名使用。想持续跟进上游更新可以改用子模块git submodule add kirifuji 仓库地址 themes/kirifuji两者区别一句话clone 是一次性快照升级要手动拉submodule 像带版本指针的订阅记录在站点仓库里别人克隆你的站点后执行git submodule update --init就能还原主题。第 2 步在 config.toml 声明 theme 变量打开站点根目录的config.toml找不到zola.toml时 Zola 会自动回退读这个文件在文件顶层加上theme kirifuji⚠️ 两个容易踩的点theme变量必须位于 TOML 文件顶层放进[extra]、[markdown]这类小节里不会被解析取值必须和目录名kirifuji完全一致。版本方面主题元数据声明minimum_version 0.4.0近两年装的 Zola 都满足。第 3 步构建验证zola build构建成功且首页外观正常主题就算装好了。也可以用zola serve起本地服务边看边改文件一变页面自动刷新。导航菜单和页脚[extra] 区段怎么配装完后最常改的两处是顶部导航和页脚署名。kirifuji 暴露了两个配置项都写在config.toml的[extra]区段里[extra] # 取消注释可隐藏页脚 Powered by Zola and Kirifuji # hideThemeName true navigationMenu [ { name log, path /log }, { name contact, path /contact } ]键名类型控制什么未设置时的表现hideThemeName布尔页脚 Powered by Zola and Kirifuji 一行文字显不显示显示navigationMenu对象数组每项一个{ name, path }决定顶部导航的文字与跳转目标不显示导航[extra]是 Zola 留给主题的自由数据区写在这里的每个键都能在模板里以config.extra.键名读到。所以看到主题文档提到某个配置键往这个区段里补一条就行。菜单增删就是往数组里加删对象path填站内路径或完整 URL 都可以。✅ 一句话kirifuji 的个性化基本在[extra]里就能全部完成不用碰代码。进阶不改主题源码覆盖模板与静态文件 官方建议别直接改themes/kirifuji/里的文件。改动虽然生效但下次主题升级会被冲掉而且 live reload 对主题目录不生效。正确做法是利用 Zola 的覆盖机制详见主题定制文档整文件替换在站点templates/下建一个与主题同路径同名的模板比如建templates/index.html就会顶掉主题首页只覆写某个 block主题模板若定义了 block在站点模板里用{% extends kirifuji/templates/xxx.html %}之后重写你要改的 block 即可替换静态文件站点static/下的同名文件CSS、字体等优先于主题里的文件。规则统一站点与主题同名时站点优先主题文件永远不会盖掉站点文件。所以定制时不用纠结——先把主题对应文件复制进站点再随便改。上手清单与下一步去哪 部署前对照这几条检查主题目录是themes/kirifuji/theme kirifuji写在config.toml顶层[extra].navigationMenu里的 path 都指向真实存在的页面Zola 版本不低于 0.4.0页脚署名文字按偏好显示或隐藏。许可方面kirifuji 本身采用 0BSD 许可个人与商用都很宽松内置 Alan Sans 字体遵循 OFL-1.1SIL Open Font License。想留署名说明的话可参考主题页的许可描述。接下来建议做三件事用zola serve本地跑起来手机和桌面视口各检查一遍排版想改导航或页脚时先看主题里的templates/base.html导航与页脚就定义在那里再决定整体替换还是只覆写 block通读主题总览、主题安装与使用、配置参考把这套覆盖机制吃透换任何主题都是同一套打法。【免费下载链接】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），仅供参考 3 步装好 kirifuji 主题：快速搭建紫色极简 Zola 博客站
3 步装好 kirifuji 主题快速搭建紫色极简 Zola 博客站【免费下载链接】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 静态站点生成器的紫色极简博客主题纯白底、深紫标题、一排文字导航、大量留白。这篇写给想要干净易读个人博客的 Zola 用户讲清 Zola 主题 kirifuji 的完整安装流程、导航菜单配置以及不碰源码的定制方法10 分钟内就能让站点跑起来。先看效果kirifuji 适合谁装好之后长这样页面顶部左侧是站名右侧排着 log、fun、contact 几个纯文字链接中间只有正文底部居中一行版权信息和 Powered by Zola and Kirifuji。没有卡片、没有侧栏屏幕完全让给文字。这种版式适合以长文、技术笔记为主希望读者视线只落在内容上的人站点结构简单、不需要标签、卡片、侧栏这类复杂组件的用户想快速发布个人主页后续愿意自己动手微调模板的人。如果你想要的是多组件、重装饰的页面建议先翻一遍官方主题画廊挑功能更全的主题。3 步装好 kirifuji 主题第 1 步把主题放进 themes/ 目录Zola 约定所有主题都放在站点根目录的themes/下。先在kirifuji 主题页上找到主题仓库地址然后克隆进站点git clone kirifuji 仓库地址 themes/kirifuji 注意目标目录名就叫kirifuji它会被直接当作配置里的主题名使用。想持续跟进上游更新可以改用子模块git submodule add kirifuji 仓库地址 themes/kirifuji两者区别一句话clone 是一次性快照升级要手动拉submodule 像带版本指针的订阅记录在站点仓库里别人克隆你的站点后执行git submodule update --init就能还原主题。第 2 步在 config.toml 声明 theme 变量打开站点根目录的config.toml找不到zola.toml时 Zola 会自动回退读这个文件在文件顶层加上theme kirifuji⚠️ 两个容易踩的点theme变量必须位于 TOML 文件顶层放进[extra]、[markdown]这类小节里不会被解析取值必须和目录名kirifuji完全一致。版本方面主题元数据声明minimum_version 0.4.0近两年装的 Zola 都满足。第 3 步构建验证zola build构建成功且首页外观正常主题就算装好了。也可以用zola serve起本地服务边看边改文件一变页面自动刷新。导航菜单和页脚[extra] 区段怎么配装完后最常改的两处是顶部导航和页脚署名。kirifuji 暴露了两个配置项都写在config.toml的[extra]区段里[extra] # 取消注释可隐藏页脚 Powered by Zola and Kirifuji # hideThemeName true navigationMenu [ { name log, path /log }, { name contact, path /contact } ]键名类型控制什么未设置时的表现hideThemeName布尔页脚 Powered by Zola and Kirifuji 一行文字显不显示显示navigationMenu对象数组每项一个{ name, path }决定顶部导航的文字与跳转目标不显示导航[extra]是 Zola 留给主题的自由数据区写在这里的每个键都能在模板里以config.extra.键名读到。所以看到主题文档提到某个配置键往这个区段里补一条就行。菜单增删就是往数组里加删对象path填站内路径或完整 URL 都可以。✅ 一句话kirifuji 的个性化基本在[extra]里就能全部完成不用碰代码。进阶不改主题源码覆盖模板与静态文件 官方建议别直接改themes/kirifuji/里的文件。改动虽然生效但下次主题升级会被冲掉而且 live reload 对主题目录不生效。正确做法是利用 Zola 的覆盖机制详见主题定制文档整文件替换在站点templates/下建一个与主题同路径同名的模板比如建templates/index.html就会顶掉主题首页只覆写某个 block主题模板若定义了 block在站点模板里用{% extends kirifuji/templates/xxx.html %}之后重写你要改的 block 即可替换静态文件站点static/下的同名文件CSS、字体等优先于主题里的文件。规则统一站点与主题同名时站点优先主题文件永远不会盖掉站点文件。所以定制时不用纠结——先把主题对应文件复制进站点再随便改。上手清单与下一步去哪 部署前对照这几条检查主题目录是themes/kirifuji/theme kirifuji写在config.toml顶层[extra].navigationMenu里的 path 都指向真实存在的页面Zola 版本不低于 0.4.0页脚署名文字按偏好显示或隐藏。许可方面kirifuji 本身采用 0BSD 许可个人与商用都很宽松内置 Alan Sans 字体遵循 OFL-1.1SIL Open Font License。想留署名说明的话可参考主题页的许可描述。接下来建议做三件事用zola serve本地跑起来手机和桌面视口各检查一遍排版想改导航或页脚时先看主题里的templates/base.html导航与页脚就定义在那里再决定整体替换还是只覆写 block通读主题总览、主题安装与使用、配置参考把这套覆盖机制吃透换任何主题都是同一套打法。【免费下载链接】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），仅供参考