zola/docs/content/documentation/templates/taxonomies.md

69 lines
1.4 KiB
Markdown
Raw Normal View History

2018-07-16 08:54:05 +00:00
+++
title = "Taxonomies"
weight = 40
+++
2018-10-18 21:09:32 +00:00
Zola will look up the following files in the `templates` directory:
2018-07-16 08:54:05 +00:00
- `$TAXONOMY_NAME/single.html`
- `$TAXONOMY_NAME/list.html`
First, a `TaxonomyTerm` has the following fields:
```ts
name: String;
slug: String;
permalink: String;
pages: Array<Page>;
```
and a `TaxonomyConfig`:
```ts
name: String,
slug: String,
paginate_by: Number?;
paginate_path: String?;
rss: Bool;
```
### Taxonomy list (`list.html`)
This template is never paginated and therefore get the following variables in all cases.
2018-07-16 08:54:05 +00:00
```ts
// The site config
config: Config;
// The data of the taxonomy, from the config
taxonomy: TaxonomyConfig;
// The current full permalink for that page
current_url: String;
// The current path for that page
current_path: String;
// All terms for that taxonomy
terms: Array<TaxonomyTerm>;
// The lang of the current page
lang: String;
2018-07-16 08:54:05 +00:00
```
### Single term (`single.html`)
2018-07-16 08:54:05 +00:00
```ts
// The site config
config: Config;
// The data of the taxonomy, from the config
taxonomy: TaxonomyConfig;
// The current full permalink for that page
current_url: String;
// The current path for that page
current_path: String;
// The current term being rendered
term: TaxonomyTerm;
// The lang of the current page
lang: String;
2018-07-16 08:54:05 +00:00
```
A paginated taxonomy term will also get a `paginator` variable, see the [pagination page](@/documentation/templates/pagination.md)
for more details on that.