This is not a standalone theme. This is a Hugo theme component.

This component enables ATOM feeds for your site.

• Requirements You need to install the latest version of Go from https://go.dev/doc/install because this theme component requires [[https://gohugo.io/hugo-modules/use-modules/][~hugo mod ..~ commands]] to work.

This update on switch to using Hugo Modules was last tested with Hugo v0.92.0.

• Installing
  1. Add this component as a new module to your site's TOML config file:

     +begin_src conf-toml

     [module] [[module.imports]] path = "github.com/kaushalmodi/hugo-atom-feed"

     +end_src

  2. Add "ATOM" to all the Page Kinds for which you want to create ATOM feeds:

     +begin_src conf-toml

     [outputs]

     /atom.xml

     home = ["HTML", "RSS", "ATOM"] # default = ["HTML", "RSS"]

     /posts/atom.xml

     section = ["HTML", "RSS", "ATOM"] # default = ["HTML", "RSS"]

     /tags/mytag/atom.xml, /categories/mycat/atom.xml

     taxonomy = ["HTML", "RSS", "ATOM"] # default = ["HTML", "RSS"]

     +end_src

• Selectively excluding pages from the feed For the pages that you would like to exclude from the feed, set the ~disable_feed~ parameter in its front-matter to ~true~.

+begin_src conf-toml

disable_feed = true

+end_src

• Pay attention to web server MIME type To fully comply with web standards, make sure your web server will send the correct [[https://developer.mozilla.org/docs/Web/HTTP/Headers/Content-Type][/Content-Type/ HTTP response header]] for the feed file name ~atom.xml~. The correct response header looks like this:

+begin_example

Content-Type: application/atom+xml; charset=UTF-8

+end_example

Note that even though the feed file extension is ~.xml~, the [[https://developer.mozilla.org/docs/Web/HTTP/Basics_of_HTTP/MIME_types][MIME type]] here is slightly adjusted from ~application/xml~ to ~application/atom+xml~.

While this might not be important for many feed readers, it could still be a source of error. So it is a good idea to play safe. How you could achieve this depends on the type of web server software you are running your website on. * Specifying the correct ~Content-Type~ for Netlify You can specify the /Content-Type/ of ~atom.~ and ~*.atom~ files to be ~application/atom+xml; charset=UTF-8~ using the below in your site's ~netlify.toml~:

+begin_src conf-toml

[[headers]] for = "atom." [headers.values] Content-Type = "application/atom+xml; charset=UTF-8" [[headers]] for = ".atom" [headers.values] Content-Type = "application/atom+xml; charset=UTF-8"

+end_src

*** References

• [[https://www.netlify.com/docs/headers-and-basic-auth/]]
• [[https://www.netlify.com/blog/2017/10/17/introducing-structured-redirects-and-headers/]] ** Note about Google Chrome Note that Google Chrome currently still [[https://bugs.chromium.org/p/chromium/issues/detail?id=84][features a bug]] for such MIME types so that automatic XML rendering is not performed. You may decide what is more important for you: watching the rendered source in your browser once in a while, or maximum feed reader compatibility 😉.