Taxonomies

This theme allows you to customize how taxonomies are displayed and how they sort pages

taxonomy_preview_count config.toml

You can additionally customize how many items are displayed in taxonomy_list.html

    [extra.poly]
    taxonomy_preview_count=8 # default is 3

Configuration taxonomies.yaml

This theme supports customizing taxonomies by loading additional config. You can create your taxonomies.yaml in your project root or any other file supported by Zola's load_data. Note, zola serve won't update on changes in this file unless you put it in a static folder or trigger update by making changes elsewhere in a watched file.

    taxonomy_kind: # name of your taxonomy
      title: Your title # custom title
      description: Description # optional description
      content: | # optional content for taxonomy_list.html
        ### Some title

        Content supports markdown
      sort_by: path # default sort_by for pages when showing this taxonomy see available page variable here https://www.getzola.org/documentation/templates/pages-sections/
      reverse: false # whether to apply | reverse filter to sorted pages
      terms: # order of terms, specify only top ones or all
        - Term name # select term by name for ordering
        - title: Another term # select term by name for ordering and customization
          description: Term description # optional description
          content: | # optional content for taxonomy_single.html
             ### Some title

             Content supports markdown
          sort_by: "extra.my_property" # override default sort for specific term
          reverse: true # override sort_by reverse
    another_taxonomy: # and so on...
      title: Custom title 2 

taxonomy_config_path config.toml

You may use any other file as long as it has the same structure as the one above

    [extra.poly]
    taxonomy_config_path="path/to/your-file.yaml" # or leave out `./taxonomies.yaml` is the default