tanuki

一个异想天开、灵感来自任天堂的 Zola 主题，采用 Catppuccin 配色、Geist 排版和 Lucide 图标。支持文档（带版本控制）、电子书、博客/落地页和产品落地页。以顽皮的日本狸猫（タヌキ）命名。

作者: Raffael Schneider

此主题需要 Zola 版本 0.19.0 及以上

许可证: MIT

主页: https://github.com/raskell-io/tanuki

在线演示: https://tanuki.raskell.io

最后更新: 2026-02-19T07:35:31+01:00

特性

• 三种模式 — 文档（带版本控制）、书籍和博客布局
• Catppuccin 配色 — 舒缓的 Mocha（暗色）和 Latte（亮色）调色板
• Geist 排版 — 干净、可读的可变字体
• Lucide 图标 — 清晰、一致的图标
• 可调整大小的侧边栏 — 拖动调整大小，跨会话持久化
• 全文搜索 — 基于 Elasticlunr 的即时搜索
• 深色/浅色切换 — 三向切换，带系统偏好检测
• 打印支持 — 将所有页面打印为单个文档（文档/书籍模式）
• 键盘导航 — 箭头键上一页/下一页，/ 搜索
• SEO 和无障碍 — JSON-LD 结构化数据，ARIA 地标，语义化 HTML

安装

cd your-zola-site
git clone https://github.com/raskell-io/tanuki themes/tanuki

或者作为 git 子模块：

git submodule add https://github.com/raskell-io/tanuki themes/tanuki

快速开始

文档模式

base_url = "https://docs.example.com"
title = "My Project Docs"
theme = "tanuki"
build_search_index = true

[markdown]
highlight_code = true
highlight_theme = "css"

[extra]
mode = "docs"
github = "https://github.com/you/project"

# 可选：版本选择器
[extra.versions]
current = "2.0.0"
list = [
    { version = "2.0.0", url = "/", label = "latest" },
    { version = "1.0.0", url = "/v1/" },
]

书籍模式

base_url = "https://book.example.com"
title = "The Complete Guide"
theme = "tanuki"
build_search_index = true

[markdown]
highlight_code = true
highlight_theme = "css"

[extra]
mode = "book"
github = "https://github.com/you/book"

博客模式

base_url = "https://blog.example.com"
title = "My Blog"
theme = "tanuki"
generate_feeds = true

taxonomies = [
    { name = "tags", feed = true },
]

[markdown]
highlight_code = true
highlight_theme = "css"

[extra]
mode = "blog"

[extra.hero]
title = "Welcome to my blog"
subtitle = "Thoughts on code and craft"

[[extra.nav]]
name = "Blog"
url = "/blog/"

[[extra.nav]]
name = "About"
url = "/about/"

键盘快捷键

浏览器支持

现代浏览器（Chrome 88+, Firefox 78+, Safari 14+, Edge 88+）

致谢

• Catppuccin — 调色板
• Geist — 排版
• Lucide — 图标
• Zola — 静态站点生成器

许可证

MIT

Made with care by raskell.io