Data
Syntax
PAGE.Data
Returns
page.Data
The Data method on a Page object returns a unique data object for each page kind.
The examples that follow are based on this site configuration:
hugo.
taxonomies:
author: authors
genre: genres
[taxonomies]
author = 'authors'
genre = 'genres'
{
"taxonomies": {
"author": "authors",
"genre": "genres"
}
}
And this content structure:
content/
├── books/
│ ├── and-then-there-were-none.md --> genres: suspense
│ ├── death-on-the-nile.md --> genres: suspense
│ └── jamaica-inn.md --> genres: suspense, romance
│ └── pride-and-prejudice.md --> genres: romance
└── _index.md
In a taxonomy template
Use these methods on the Data object within a taxonomy template.
- Singular
- (
string) Returns the singular name of the taxonomy.
{{ .Data.Singular }} → genre
- Plural
- (
string) Returns the plural name of the taxonomy.
{{ .Data.Plural }} → genres
- Terms
- (
page.Taxonomy) Returns the taxonomy object, consisting of a map of terms and the weighted pages associated with each term.
{{ $taxonomyObject := .Data.Terms }}
Learn more about taxonomy templates.
In a term template
Use these methods on the Data object within a term template.
- Singular
- (
string) Returns the singular name of the taxonomy.
{{ .Data.Singular }} → genre
- Plural
- (
string) Returns the plural name of the taxonomy.
{{ .Data.Plural }} → genres
- Term
- (
string) Returns the name of the term.
{{ .Data.Term }} → suspense
Learn more about term templates.