Nivis is a clean, responsive Zola theme for personal blogs.
AIGC disclosure: Parts of this documentation were drafted with AIGC assistance and subsequently checked against the theme source and a local Zola build.
Nivis is inspired by and derived from Float and anatole.
Nivis requires Zola 0.23.4 or later.
Add the theme as a Git submodule:
git submodule add -b master --depth=1 https://github.com/Resorie/zola-theme-nivis.git themes/nivis
git submodule update --init --recursiveEnable it in the site's config.toml:
theme = "nivis"
compile_sass = true
taxonomies = [{ name = "tags", paginate_by = 5 }]
[markdown.highlighting]
style = "class"
light_theme = "one-light"
dark_theme = "one-dark-pro"
[extra]
home_layout = "focus"
taxonomy_mode = "tags"
social_links = []For a new, otherwise empty site, copy the example content and link data:
cp -R themes/nivis/content/. content/
cp -R themes/nivis/data/. data/Read the example site's Getting Started guide for the complete configuration, required content structure, local preview, and update instructions.
| Key | Values | Default |
|---|---|---|
extra.home_layout | focus, horizontal | focus |
extra.taxonomy_mode | tags, category, none | tags |
extra.math_display | mathjax or omitted | Omitted |
extra.motto_mode | hide, single, multi | hide |
Nivis continues to use Zola's tags taxonomy internally in all three taxonomy modes. Category mode accepts at most one value per post, while none hides taxonomy UI. To stop Zola from generating taxonomy pages as well, use taxonomies = [{ name = "tags", render = false }].
Post lists use description as their summary. Articles may add a subtitle and a longer article-page abstract:
description = "A short summary for post lists."
[extra]
subtitle = "An optional subtitle"
abstract = "A longer abstract shown on the article page."The optional copyright line is enabled by providing a holder:
[extra.footer]
copyright_holder = "Your name"
copyright_since = 2025Nivis provides image and collapse components for Markdown content. Their parameters and rendered examples are documented on the example site after completing the Getting Started guide.