zola/docs/content/documentation/content/taxonomies.md
2018-10-18 23:11:36 +02:00

1 KiB

+++ title = "Taxonomies" weight = 90 +++

Zola has built-in support for taxonomies.

The first step is to define the taxonomies in your config.toml.

A taxonomy has 4 variables:

  • name: a required string that will be used in the URLs, usually the plural version (i.e. tags, categories etc)
  • paginate_by: if this is set to a number, each term page will be paginated by this much.
  • paginate_path: if set, will be the path used by paginated page and the page number will be appended after it. For example the default would be page/1
  • rss: if set to true, a RSS feed will be generated for each individual term.

Once this is done, you can then set taxonomies in your content and Zola will pick them up:

+++
...
[taxonomies]
tags = ["rust", "web"]
categories = ["programming"]
+++

The taxonomy pages will only be created if at least one non-draft page is found and are available at the following paths:

$BASE_URL/$NAME/
$BASE_URL/$NAME/$SLUG