A small Hugo subtheme providing an RFC 4287 Atom feed template.
Note
This layout was developed primarily for the Scientific Python Hugo theme and is currently tested only in that context. It may work with other Hugo themes, but compatibility with them is not guaranteed.
Add the repository as a Git submodule under themes/, then include it in
the site’s theme configuration.
The template uses:
params.author.nameparams.author.email(optional)params.description(optional)params.atom.sections(optional)services.rss.limit- the configured language locale
When no author name is configured, the site title is used.
Each entry lists its terms from every taxonomy (tags, categories, and any
custom taxonomy) as <category> elements.
The home feed (/atom.xml) only lists pages from the site's main sections,
so that subscribers to a blog do not receive every page on the site. Hugo
derives the main sections from the section with the most pages, and a site
can pin them with the top-level mainSections setting.
params.atom.sections overrides that list for the home feed:
params:
atom:
sections: ["posts", "news"]Use ["*"] to include every regular page on the site. Section feeds such as
/posts/atom.xml always list the pages of their own section and ignore this
setting.
pixi run test