Atom Feeds

Build-time feed generation for blog posts

sukr generates an Atom 1.0 feed for blog posts at build time.

Output

After building, you'll find feed.xml in your output directory:

public/
├── index.html
├── feed.xml  ← Atom feed
└── blog/
    └── ...

Feed Contents

The feed includes:

  • Site title and author from site.toml
  • Self-referencing links (required by Atom spec)
  • Entry for each content item in blog/ section
  • Post title, URL, date, and description

Auto-generation

Feed generation happens automatically when any content exists in a section with section_type = "blog". No configuration required.

Posts are sorted by date (newest first), matching the blog section ordering.

Disabling Feeds

To suppress feed generation entirely, add to site.toml:

[feed]
enabled = false

Feeds are enabled by default.

Linking to the Feed

Add a link in your base.html template:

<link
  rel="alternate"
  type="application/atom+xml"
  title="{{ config.title }} Feed"
  href="{{ prefix }}/feed.xml"
/>

Date Format

Post dates in frontmatter should use YYYY-MM-DD format:

+++
title = "My Post"
date = 2024-01-15
+++

The feed converts this to RFC 3339 format required by Atom.

Validation

Test your feed with the W3C Feed Validator.