1.6 KiB
title | linkTitle | description | categories | keywords |
---|---|---|---|---|
Configure taxonomies | Taxonomies | Configure taxonomies. |
The default configuration defines two taxonomies, categories
and tags
.
{{< code-toggle config=taxonomies />}}
When creating a taxonomy:
- Use the singular form for the key (e.g.,
category
). - Use the plural form for the value (e.g.,
categories
).
Then use the value as the key in front matter:
{{< code-toggle file=content/example.md fm=true >}}
title: Example categories:
- vegetarian
- gluten-free tags:
- appetizer
- main course {{< /code-toggle >}}
If you do not expect to assign more than one term from a given taxonomy to a content page, you may use the singular form for both key and value:
{{< code-toggle file=hugo >}} taxonomies: author: author {{< /code-toggle >}}
Then in front matter:
{{< code-toggle file=content/example.md fm=true >}}
title: Example author:
- Robert Smith {{< /code-toggle >}}
The example above illustrates that even with a single term, the value is still provided as an array.
You must explicitly define the default taxonomies to maintain them when adding a new one:
{{< code-toggle file=hugo >}} taxonomies: author: author category: categories tag: tags {{< /code-toggle >}}
To disable the taxonomy system, use the disableKinds
setting in the root of your site configuration to disable the taxonomy
and term
page kinds.
{{< code-toggle file=hugo >}} disableKinds = ['categories','tags'] {{< /code-toggle >}}
See the taxonomies section for more information.