blog.ndumas.com/content/posts/adding-content-to-taxonomy-.../index.md

---
draft: false
title: "Using Taxonomy Terms in Hugo: Adding Content"
aliases: ["Using Taxonomy Terms in Hugo: Adding Content"]
series: ["blogging-with-quartz"]
series_order: 5
date: "2023-04-09"
author: "Nick Dumas"
cover: ""
keywords: ["", ""]
summary: ""
showFullContent: false
tags:
- hugo
- quartz
- webdev
---

## What am I Doing?
As I've been writing, I've collected posts about specific projects into series through Hugo's [taxonomies](https://gohugo.io/content-management/taxonomies/). The example I've been working on is my [Blogging with Quartz](/series/blogging-with-quartz/) series.

## Why does it work?
Taxonomies are great, you can even assign multiple taxonomies to a single page when that's relevant ( making a movie database or something, I suppose ?).

## Why doesn't it work?
The base implementation in Quartz is pretty bare though. The term listing lists the name and the members of the taxonomy, which is great but only goes so far. I'd love to be able to write an overview of each series and have the option of embedding media.
## What are the options?
Hugo's Taxonomies feature is prepared for this, but Quartz's templates were not.

There were two tricky things about this.

### Where does it go?
I chased a few weeks worth of red herrings here, so I'll cut to the chase.

Taxonomies contain terms. Taxonomies are content. This means my task was pretty simple:

```
content/
    notes/
    series/
        blogging-with-quartz/
            _index.md
```
Creating an `<taxonomyType>/<taxonomyItem>/_index.md` is the first step. Here's what I've got so far in `content/series/blogging-with-quartz/_index.md`:
```
+++
title = "Blogging with Quartz: a trigonal crystal in a round hole"
+++

this is where i talk about building my blog with quartz
```

The other half of this setup is modifying the term template at `layouts/_default/term.html`. I had to add the `{{ .Content}}` line ( that's really all it took ) so it would render out the body content of my `_index.md` as above.

```html
<!DOCTYPE html>
<html lang="{{ .Lang }}">
{{ partial "head.html" . }}

<body>
{{partial "search.html" .}}
<div class="singlePage">
    <!-- Begin actual content -->
    {{partial "header.html" .}}
    <article>
        <h1>{{ i18n "tag" }}: {{ .Title }}</h1>
        {{ .Content }}
        {{with .Params.summary}}
            <p>{{.}}</p>
        {{end}}
        {{partial "page-list.html" .Paginator.Pages}}
        {{ template "_internal/pagination.html" . }}
    </article>
    {{partial "contact.html" .}}
</div>
</body>
</html>
```

### Where does it come from?
There was a really confusing issue I had with the title section of the term page. The title was appearing correctly, even pulling from the `_index.md`, but it was being prefixed with `Tag: `.

It took me some digging to find the cause. I started with grepping for `Tag`, and found it in the `i18n/en.toml`. This told me that a template was calling `i18n`, and there we had it in `layouts/_default/term.html`
```html
<h1>{{ i18n "tag" }}: {{ .Title }}</h1>
```
In practice, I don't think


The final template looks like this.
```html
<!DOCTYPE html>
<html lang="{{ .Lang }}">
{{ partial "head.html" . }}

<body>
{{partial "search.html" .}}
<div class="singlePage">
    <!-- Begin actual content -->
    {{partial "header.html" .}}
    <article>
        <h1>{{ i18n "interactive_graph" }}: {{ .Title }}</h1>
        {{ .Content }}
        {{with .Params.summary}}
            <p>{{.}}</p>
        {{end}}
        {{partial "page-list.html" .Paginator.Pages}}
        {{ template "_internal/pagination.html" . }}
    </article>
    {{partial "contact.html" .}}
</div>
</body>
</html>
```

## Now what?
We've got a nice looking series page now:

{{< figure
    src="series-display-screenshot.png"
    alt="Screenshot of  a website with four links to blog posts connected as a series"
    caption=""
>}}

The next steps are to start filling out my series pages and writing about my projects. This actually clears out the outstanding list of projects I had for the blog, so I don't have any big structural stuff to do.
moving blog posts into the blog repo 5 months ago			`---`
			`draft: false`
			`title: "Using Taxonomy Terms in Hugo: Adding Content"`
			`aliases: ["Using Taxonomy Terms in Hugo: Adding Content"]`
			`series: ["blogging-with-quartz"]`
Series order fix 5 months ago			`series_order: 5`
moving blog posts into the blog repo 5 months ago			`date: "2023-04-09"`
			`author: "Nick Dumas"`
			`cover: ""`
			`keywords: ["", ""]`
A lot more polish, showing summaries 5 months ago			`summary: ""`
moving blog posts into the blog repo 5 months ago			`showFullContent: false`
			`tags:`
Fixing broken cross-links 3 months ago			`- hugo`
			`- quartz`
moving blog posts into the blog repo 5 months ago			`- webdev`
			`---`

			`## What am I Doing?`
Fixing broken cross-links 3 months ago			`As I've been writing, I've collected posts about specific projects into series through Hugo's [taxonomies](https://gohugo.io/content-management/taxonomies/). The example I've been working on is my [Blogging with Quartz](/series/blogging-with-quartz/) series.`
moving blog posts into the blog repo 5 months ago
Fixing broken cross-links 3 months ago			`## Why does it work?`
moving blog posts into the blog repo 5 months ago			`Taxonomies are great, you can even assign multiple taxonomies to a single page when that's relevant ( making a movie database or something, I suppose ?).`

			`## Why doesn't it work?`
			`The base implementation in Quartz is pretty bare though. The term listing lists the name and the members of the taxonomy, which is great but only goes so far. I'd love to be able to write an overview of each series and have the option of embedding media.`
			`## What are the options?`
Fixing broken cross-links 3 months ago			`Hugo's Taxonomies feature is prepared for this, but Quartz's templates were not.`
moving blog posts into the blog repo 5 months ago
			`There were two tricky things about this.`

			`### Where does it go?`
			`I chased a few weeks worth of red herrings here, so I'll cut to the chase.`

Fixing broken cross-links 3 months ago			`Taxonomies contain terms. Taxonomies are content. This means my task was pretty simple:`
moving blog posts into the blog repo 5 months ago
			```
Fixing broken cross-links 3 months ago			`content/`
			`notes/`
moving blog posts into the blog repo 5 months ago			`series/`
			`blogging-with-quartz/`
			`_index.md`
			```
Better solution 5 months ago			Creating an `<taxonomyType>/<taxonomyItem>/_index.md` is the first step. Here's what I've got so far in `content/series/blogging-with-quartz/_index.md`:
			```
moving blog posts into the blog repo 5 months ago			`+++`
			`title = "Blogging with Quartz: a trigonal crystal in a round hole"`
			`+++`

			`this is where i talk about building my blog with quartz`
			```

Better solution 5 months ago			The other half of this setup is modifying the term template at `layouts/_default/term.html`. I had to add the `{{ .Content}}` line ( that's really all it took ) so it would render out the body content of my `_index.md` as above.
moving blog posts into the blog repo 5 months ago
experimenting with styling code snippets 5 months ago			```html
moving blog posts into the blog repo 5 months ago			`<!DOCTYPE html>`
			`<html lang="{{ .Lang }}">`
			`{{ partial "head.html" . }}`

			`<body>`
			`{{partial "search.html" .}}`
			`<div class="singlePage">`
			`<!-- Begin actual content -->`
			`{{partial "header.html" .}}`
			`<article>`
			`<h1>{{ i18n "tag" }}: {{ .Title }}</h1>`
			`{{ .Content }}`
A lot more polish, showing summaries 5 months ago			`{{with .Params.summary}}`
moving blog posts into the blog repo 5 months ago			`<p>{{.}}</p>`
			`{{end}}`
			`{{partial "page-list.html" .Paginator.Pages}}`
			`{{ template "_internal/pagination.html" . }}`
			`</article>`
			`{{partial "contact.html" .}}`
			`</div>`
			`</body>`
			`</html>`
			```

			`### Where does it come from?`
			There was a really confusing issue I had with the title section of the term page. The title was appearing correctly, even pulling from the `_index.md`, but it was being prefixed with `Tag: `.

Better solution 5 months ago			It took me some digging to find the cause. I started with grepping for `Tag`, and found it in the `i18n/en.toml`. This told me that a template was calling `i18n`, and there we had it in `layouts/_default/term.html`
			```html
moving blog posts into the blog repo 5 months ago			`<h1>{{ i18n "tag" }}: {{ .Title }}</h1>`
			```
			`In practice, I don't think`


			`The final template looks like this.`
experimenting with styling code snippets 5 months ago			```html
moving blog posts into the blog repo 5 months ago			`<!DOCTYPE html>`
			`<html lang="{{ .Lang }}">`
			`{{ partial "head.html" . }}`

			`<body>`
			`{{partial "search.html" .}}`
			`<div class="singlePage">`
			`<!-- Begin actual content -->`
			`{{partial "header.html" .}}`
			`<article>`
			`<h1>{{ i18n "interactive_graph" }}: {{ .Title }}</h1>`
			`{{ .Content }}`
A lot more polish, showing summaries 5 months ago			`{{with .Params.summary}}`
moving blog posts into the blog repo 5 months ago			`<p>{{.}}</p>`
			`{{end}}`
			`{{partial "page-list.html" .Paginator.Pages}}`
			`{{ template "_internal/pagination.html" . }}`
			`</article>`
			`{{partial "contact.html" .}}`
			`</div>`
			`</body>`
			`</html>`
			```

Fixing broken cross-links 3 months ago			`## Now what?`
moving blog posts into the blog repo 5 months ago			`We've got a nice looking series page now:`
And we just use hugo shortcodes directly 5 months ago
			`{{< figure`
			`src="series-display-screenshot.png"`
			`alt="Screenshot of a website with four links to blog posts connected as a series"`
			`caption=""`
			`>}}`

Fixing broken cross-links 3 months ago			`The next steps are to start filling out my series pages and writing about my projects. This actually clears out the outstanding list of projects I had for the blog, so I don't have any big structural stuff to do.`