Organizing This Site

Fri, 03 Apr 2026 00:00:00 +0000

A reference for how this Hugo site is organized and what configuration options are available.

Sections

Sections are created automatically from the directory tree under content/. Any directory with an _index.md file becomes a section with its own list page.

content/
├── _index.md ← home page
├── about/
│ ├── _index.md ← /about/ list page
│ ├── whoami.md
│ └── now.md
├── software/
│ ├── _index.md ← /software/ list page
│ ├── ollama.md
│ └── hugo-setup/ ← page bundle (leaf)
│ ├── index.md
│ └── architecture.svg
└── config/
 ├── _index.md ← /config/ list page
 └── this-file.md

No config changes are needed — Hugo derives sections from the filesystem.

Using Tags and Categories

Wed, 01 Apr 2026 00:00:00 +0000

Hugo ships with two default taxonomies: tags and categories.

Assigning terms

Add them to any article’s front matter:

---
title: "My Article"
tags: ['python', 'tools']
categories: ['tutorials']
---

What Hugo generates

For each taxonomy, Hugo creates:

A taxonomy list page: /tags/ — shows all terms.
A term page per value: /tags/python/ — lists all articles with that tag.

Custom taxonomies

Define additional taxonomies in hugo.toml:

[taxonomies]
 tag = "tags"
 category = "categories"
 series = "series"