46c00c7729
Migrate all 17 docs/content/ files from --- YAML to +++ TOML frontmatter delimiters and key = value syntax. Update 8 embedded frontmatter examples in 7 documentation pages to match (configuration, content-organization, getting-started, security, sections, sitemap, feeds, templates). Update configuration.md frontmatter reference table: add draft and aliases fields, correct date type from string to date.
1.3 KiB
1.3 KiB
+++ title = "Atom Feeds" description = "Build-time feed generation for blog posts" weight = 6 +++
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.
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.