Index

+++ title = "tanuki" description = "A whimsical, Nintendo-inspired Zola theme with Catppuccin colors, Geist typography, and Lucide icons. Supports documentation (with versioning), e-books, blog/landing pages, and product landing pages. Named after the playful Japanese raccoon dog (タヌキ)." template = "theme.html" date = 2026-02-19T07:35:31+01:00

[taxonomies] theme-tags = []

[extra] created = 2026-02-19T07:35:31+01:00 updated = 2026-02-19T07:35:31+01:00 repository = "https://github.com/raskell-io/tanuki" homepage = "https://github.com/raskell-io/tanuki" minimum_version = "0.19.0" license = "MIT" demo = "https://tanuki.raskell.io"

[extra.author] name = "Raffael Schneider" homepage = "https://raskell.io" +++

Tanuki

<em>Beautiful, accessible, and thoughtfully designed.</em>

Features

• Three Modes — Documentation (with versioning), Book, and Blog layouts
• Catppuccin Colors — Soothing Mocha (dark) and Latte (light) palettes
• Geist Typography — Clean, readable variable fonts
• Lucide Icons — Crisp, consistent iconography
• Resizable Sidebar — Drag to resize, persists across sessions
• Full-text Search — Elasticlunr-powered instant search
• Dark/Light Toggle — Three-way toggle with system preference detection
• Print Support — Print all pages as a single document (docs/book modes)
• Keyboard Navigation — Arrow keys for prev/next, / for search
• SEO & Accessibility — JSON-LD structured data, ARIA landmarks, semantic HTML

Installation

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

Or as a git submodule:

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

Quick Start

Documentation Mode

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"

# Optional: version picker
[extra.versions]
current = "2.0.0"
list = [
    { version = "2.0.0", url = "/", label = "latest" },
    { version = "1.0.0", url = "/v1/" },
]

Book Mode

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"

Blog Mode

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/"

Keyboard Shortcuts

Browser Support

Modern browsers (Chrome 88+, Firefox 78+, Safari 14+, Edge 88+)

Credits

• Catppuccin — Color palette
• Geist — Typography
• Lucide — Icons
• Zola — Static site generator

License

MIT