Blog and Taxonomies

Blog collections are auto-detected by directory name. Place content in blog/, posts/, articles/, or news/ and Sarde applies date-sorted, feed-enabled defaults with no configuration required.

Blog collection setup

Create a blog/ directory inside content/:

content/blog/
  _index.md
  2026-03-15-hello-world.md
  2026-04-01-new-release.md

Sarde auto-detects this as a blog collection with date-sorted posts (newest first), pagination at 10 posts per page, and RSS/Atom feeds enabled.

Any of these directory names trigger blog-type detection: blog, posts, articles, news. See Content & Collections for the full auto-detection table.

List layouts

Blog list pages (the index at /blog/) render with one of three layouts. Set the layout with the template field in _index.md frontmatter:

---
title: Blog
template: "blog/list-grid"
---

Without a template override, blog list pages use blog/list.

Single post layouts

Individual blog posts render with one of three layouts. Set the layout with the template field in the post's frontmatter:

---
title: Hello World
template: "blog/single-cover"
image: cover.jpg
---

Without a template override, blog posts use blog/single.

Pagination

Blog list pages paginate automatically. Override the default of 10 per page in sarde.yaml:

collections:
  blog:
    paginate: 20

Set paginate: 0 to disable pagination and show all posts on a single page.

Taxonomies

Taxonomies group content by shared terms. Sarde ships with tags enabled by default. Each taxonomy generates a listing page at /<taxonomy>/ and a term page for each value at /<taxonomy>/<term>/.

Default configuration

The default sarde.yaml includes:

taxonomies:
  tags: "tag"

The value ("tag") is the singular form used in URL slugs. Adding tags to a post:

---
title: Photosynthesis Lab
tags: [biology, lab-work, plants]
---

Result: The post appears on /tags/biology/, /tags/lab-work/, and /tags/plants/. Each term page lists all posts with that tag.

Custom taxonomies

Add additional taxonomies in sarde.yaml:

taxonomies:
  tags: "tag"
  categories: "category"
  authors: "author"

Assign terms in frontmatter using the taxonomy name as the key:

---
title: Photosynthesis Lab
tags: [biology, plants]
categories: [science]
authors: [dr-chen]
---

Taxonomy options

Each taxonomy supports per-taxonomy configuration:

taxonomies:
  tags:
    singular: "tag"
    paginate_by: 20
    undefined_tags: "warn"
    render: true

Term metadata

Define term metadata (display name, description, icon, color) in a YAML file at data/<taxonomy-name>.yml:

biology:
  label: "Biology"
  icon: "leaf"
  color: "green"
lab-work:
  label: "Lab Work"
  icon: "flask-conical"

Term metadata controls how tags appear in the sidebar tag cloud and on tag chips throughout the site.

Slug collisions

Terms are keyed by slug, so two terms that slugify to the same string become one. Sarde warns rather than failing, in both cases the build can hit:

taxonomy "tags": terms "Lab Work" and "lab work" collide on slug "lab-work"

Two different term names reduced to the same slug. Their pages merge under whichever name was seen first, which makes the winner depend on content order. Pick one spelling.

taxonomy "tags": permalink "biology" of "Life Sciences" collides with an existing
slug — merged 4 page(s) into the existing entry (check data/tags.yml)

A custom permalink in data/<taxonomy>.yml points a term at a slug another term already occupies. The pages merge into the existing entry and the term keeps its old name. Change the permalink in the data file.

Feeds

Blog collections generate RSS and Atom feeds automatically:

• RSS 2.0 at /<collection>/feed.xml
• Atom 1.0 at /<collection>/atom.xml

Disable feeds per collection:

collections:
  blog:
    feed: false

See Configuration for all taxonomy settings, and Frontmatter for per-page taxonomy fields.