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 静态站点生成器生态里走简洁有序路线的博客主题用深紫色和大量留白把这种单调换掉垂直居中的正文、一条水平导航栏、两行页脚几分钟装完再配两三行配置就能开始写文章。极简紫色布局kirifuji 的视觉语言Zola kirifuji 主题的设计取自 terriblesoftware.org 与 fhur.me 两个个人站。从上面这张截图能看出它的固定套路标题、导航链接、页脚版权统一走深紫色正文里的超链接换成浅蓝做区分正文字体是内置的 Alan Sans。页面结构上顶部一条水平导航——左边站名、右边依次排菜单项——正文收在中间一列上下留白充足没有侧边栏和卡片装饰窄屏下也会自适应收窄。主题放进 themes 目录克隆还是子模块两个前置条件主题元数据里声明了minimum_version 0.4.0本地 Zola 需要不低于这个版本所有主题统一放在站点根目录的themes/下子文件夹的名字就是主题名。安装有两条路。git clone是一次性快照最直接之后升级主题靠手动拉取git submodule则把主题以版本指针形式记进站点仓库别人克隆你的站点后跑git submodule update --init就能还原后续换版本也只是移动指针。不想用 Git 的话也可以手动下载文件塞进themes/kirifuji/但升级和版本管理都麻烦只适合临时试用。# 一次性克隆最省事 git clone https://gitcode.com/GitHub_Trending/zo/zola themes/kirifuji # 或注册为子模块站点目录需已是 git 仓库 git submodule add https://gitcode.com/GitHub_Trending/zo/zola themes/kirifuji跑完后站点根目录会多出一个themes/kirifuji/里面是主题的templates/、static/和theme.toml。在 config.toml 顶层声明 theme 激活主题文件就位后要告诉 Zola 使用它。配置文件是zola.tomlZola 找不到时会回退加载config.toml站点根目录里哪个就用哪个。在顶层加一行theme kirifuji这里有个容易踩的坑值必须与themes/下的文件夹名完全一致而且这个键要放在 TOML 的顶层主区段不能塞进[extra]、[markdown]之类的小节里——放错位置不会被解析构建时主题会被静默忽略。构建成功后模板从themes/kirifuji/templates/加载静态资源从themes/kirifuji/static/提供站点里存在同名文件时以站点为准。用 [extra] 区段配置导航菜单和页脚署名[extra]是 Zola 交给模板的自由数据区主题通过config.extra.xxx读取它。kirifuji 依据navigationMenu渲染顶部水平导航栏依据hideThemeName决定页脚里 Powered by Zola and Kirifuji 这行署名要不要出现。最小可用配置[extra] # 可选隐藏页脚的 Powered by Zola and Kirifuji 文字 # hideThemeName true navigationMenu [ { name log, path /log }, { name contact, path /contact }, { name misc., path /misc } ]菜单项的path可以是站内相对路径也可以是完整 URL想增减栏目就是在数组里增删一行对象。两个配置键的作用一览配置键类型作用默认值hideThemeName布尔值是否隐藏页脚署名 Powered by Zola and Kirifuji不隐藏navigationMenu对象数组导航项每项含name显示文字与path链接指向无不显示导航栏不动主题源码模板覆盖与 block 覆写Zola 的主题机制有一个明确的优先级站点的templates/与主题存在同路径同名文件时站点文件胜出。定制因此可以完全不打开themes/kirifuji/。整份模板替换做法最简单在站点根目录建一个与主题内同路径同名的文件。想让首页面目全非就在站点写一份新的templates/index.html它直接覆盖主题首页。静态资源同理static/下的同名文件会覆盖主题里的静态文件替换字体、换图标都走这条路。只覆写一个 block只想改页面的一小块时用 Tera 继承更精细在站点的page.html里 extends 主题的对应模板只重定义你在意的 block。{% extends kirifuji/templates/page.html %} {% block title %}{{ page.title }} | {{ config.title }}{% endblock %}这样页面其余部分仍来自主题主题升级新版本也不会弄坏你的改动。反过来直接改themes/kirifuji/里的文件虽然也生效但升级困难且这些文件不参与 live reload官方文档不建议这么做。许可协议0BSD 与 OFL-1.1kirifuji 主题本体采用 0BSD 许可接近公有领域使用、修改和再分发基本没有门槛。内置的 Alan Sans 字体则单独遵循 OFL-1.1SIL Open Font License 1.1两者对博客和个人站点都很宽松。对外发布的站点如果想保持规范在页脚或 README 里留一行许可说明即可。想继续了解模板覆盖的完整优先级规则或动手做一个 kirifuji 的变体可以深入阅读 Customizing a theme 与 Creating a theme。【免费下载链接】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），仅供参考