mirror of
https://github.com/gohugoio/hugo.git
synced 2024-12-27 18:20:55 +00:00
ca7007bf26
- Add backticks and commas where necessary - Remove some trailing whitespace - Add front matter example in TOML - Fix typo in one of the tags in Showcase - Add 多说 (Duoshuo) as an alternative to Disqus - Use internal links (i.e. without gohugo.io) where possible - Use a colon to set off an example - Change "it's" to "its" where appropriate - Use typographical (i.e. curly) apostrophe on the front page where appropriate - Capitalize "Github" as "GitHub"
1.8 KiB
1.8 KiB
| date | linktitle | menu | next | prev | title | weight | ||||
|---|---|---|---|---|---|---|---|---|---|---|
| 2014-05-26 | Usage |
|
/taxonomies/displaying | /taxonomies/overview | Using Taxonomies | 15 |
Defining taxonomies for a site
Taxonomies must be defined in the site configuration before they can be used throughout the site. You need to provide both the plural and singular labels for each taxonomy.
Here is an example configuration in YAML that specifies three taxonomies
(the default two, plus series).
Notice the format is singular key : plural value.
config.yaml
---
Taxonomies:
tag: "tags"
category: "categories"
series: "series"
---
Assigning taxonomy values to content
Once an taxonomy is defined at the site level, any piece of content can be assigned to it regardless of content type or section.
Assigning content to an taxonomy is done in the front matter. Simply create a variable with the plural name of the taxonomy and assign all terms you want to apply to this content.
taxonomy values are case insensitive
Front Matter Example (in TOML)
+++
title = "Hugo: A fast and flexible static site generator"
tags = [ "Development", "Go", "fast", "Blogging" ]
categories = [ "Development" ]
series = [ "Go Web Dev" ]
slug = "hugo"
project_url = "http://github.com/spf13/hugo"
+++
Front Matter Example (in JSON)
{
"title": "Hugo: A fast and flexible static site generator",
"tags": [
"Development",
"Go",
"fast",
"Blogging"
],
"categories" : [
"Development"
],
"series" : [
"Go Web Dev"
],
"slug": "hugo",
"project_url": "http://github.com/spf13/hugo"
}