Special Pages

Nivis can link to five site sections: posts, about, archives, categories, and friend links. Their navigation switches are independent, but enabled routes must have the content or data expected by their templates.

Navigation Switches

All sections are enabled by default:

[extra.sections]
posts = true
about = true
archive = true
links = true

Set only the entries that need to differ from the defaults. For example:

[extra.sections]
links = false

Hiding a section removes theme navigation but does not delete its content.

Posts Page

Create content/posts/_index.md:

+++
title = "Posts"
sort_by = "date"
template = "section.html"
page_template = "page.html"
paginate_by = 5

[extra]
pinned_posts = []
+++

Posts are ordinary Markdown pages below content/posts/. To pin pages above the first result page, list their paths relative to content/:

[extra]
pinned_posts = [
    "posts/getting-started.md",
    "posts/featured-post.md",
]

About Page

Create content/about/index.md:

+++
title = "About Me"
template = "about.html"
+++

Introduce yourself here.

The page body supports ordinary Markdown.

Archive Page

Create content/archive/index.md:

+++
title = "Archives"
template = "archive.html"
+++

The archive template reads content/posts/_index.md and groups dated posts by year in reverse chronological order.

Categories Page

Zola generates the taxonomy index and term pages, so no content/tags/_index.md file is required. The default declaration is:

taxonomies = [{ name = "tags", paginate_by = 5 }]

Nivis can show these values as multiple tags or one category per post. To hide taxonomy UI and stop generating taxonomy pages, use:

taxonomies = [{ name = "tags", render = false }]

[extra]
taxonomy_mode = "none"

See Configuration for all three modes and their front matter rules.

Friend Links Page

Create content/links/index.md:

+++
title = "Links"
template = "links.html"

[extra]
show_content = true
+++

Optional introductory text.

Set show_content = false or omit it to render only the link groups.

Then create data/links.toml:

[[groups]]
name = "Friends"
desc = "Personal sites I follow."

[[groups.items]]
name = "Someone"
url = "https://example.com/"
description = "A short description."
avatar = "https://example.com/avatar.jpg"

[[groups]]
name = "Projects"
desc = "Projects worth visiting."

[[groups.items]]
name = "Zola"
url = "https://www.getzola.org/"
description = "The static site generator used by Nivis."
avatar = "https://avatars.githubusercontent.com/u/43047029"

Each group needs name, desc, and items. Each item needs name, url, description, and avatar. Link cards open in a new tab with rel="noopener noreferrer".

After adding or removing a special page, run zola build --force so missing routes or data files are caught before deployment.