{"id":16581713,"url":"https://github.com/kaushalmodi/hugo-atom-feed","last_synced_at":"2025-03-21T12:32:55.176Z","repository":{"id":77541941,"uuid":"136865662","full_name":"kaushalmodi/hugo-atom-feed","owner":"kaushalmodi","description":"Hugo theme component for ATOM feed custom Output Format","archived":false,"fork":false,"pushed_at":"2024-02-16T20:58:39.000Z","size":60,"stargazers_count":43,"open_issues_count":6,"forks_count":14,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-17T21:09:38.863Z","etag":null,"topics":["atom-feed","custom-output-format","hugo","hugo-theme-component"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kaushalmodi.png","metadata":{"files":{"readme":"README.org","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-06-11T02:40:04.000Z","updated_at":"2025-02-27T07:22:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"b15e4644-fb87-4283-bf3e-1d6475c35b91","html_url":"https://github.com/kaushalmodi/hugo-atom-feed","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaushalmodi%2Fhugo-atom-feed","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaushalmodi%2Fhugo-atom-feed/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaushalmodi%2Fhugo-atom-feed/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaushalmodi%2Fhugo-atom-feed/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kaushalmodi","download_url":"https://codeload.github.com/kaushalmodi/hugo-atom-feed/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244141537,"owners_count":20404834,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["atom-feed","custom-output-format","hugo","hugo-theme-component"],"created_at":"2024-10-11T22:29:43.873Z","updated_at":"2025-03-21T12:32:54.548Z","avatar_url":"https://github.com/kaushalmodi.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"*This is not a standalone theme. This is a Hugo theme component.*\n\nThis component enables ATOM feeds for your site.\n\n* Requirements\nYou need to install the latest version of Go from\nhttps://go.dev/doc/install because this theme component requires [[https://gohugo.io/hugo-modules/use-modules/][~hugo\nmod ..~ commands]] to work.\n\nThis update on switch to using Hugo Modules was last tested with Hugo\nv0.92.0.\n* Installing\n1. Add this component as a new module to your site's TOML config file:\n   #+begin_src conf-toml\n   [module]\n     [[module.imports]]\n       path = \"github.com/kaushalmodi/hugo-atom-feed\"\n   #+end_src\n2. Add \"ATOM\" to all the Page Kinds for which you want to create ATOM\n   feeds:\n   #+begin_src conf-toml\n   [outputs]\n     # \u003cdomain\u003e/atom.xml\n     home = [\"HTML\", \"RSS\", \"ATOM\"]     # default = [\"HTML\", \"RSS\"]\n     # \u003cdomain\u003e/posts/atom.xml\n     section = [\"HTML\", \"RSS\", \"ATOM\"]  # default = [\"HTML\", \"RSS\"]\n     # \u003cdomain\u003e/tags/mytag/atom.xml, \u003cdomain\u003e/categories/mycat/atom.xml\n     taxonomy = [\"HTML\", \"RSS\", \"ATOM\"] # default = [\"HTML\", \"RSS\"]\n   #+end_src\n* Selectively excluding pages from the feed\nFor the pages that you would like to exclude from the feed, set the\n~disable_feed~ parameter in its front-matter to ~true~.\n\n#+begin_src conf-toml\ndisable_feed = true\n#+end_src\n\n* Pay attention to web server MIME type\nTo fully comply with web standards, make sure your web server will\nsend the correct [[https://developer.mozilla.org/docs/Web/HTTP/Headers/Content-Type][/Content-Type/ HTTP response header]] for the feed file\nname ~atom.xml~. The correct response header looks like this:\n\n#+begin_example\nContent-Type: application/atom+xml; charset=UTF-8\n#+end_example\n\nNote that even though the feed file extension is ~.xml~, the [[https://developer.mozilla.org/docs/Web/HTTP/Basics_of_HTTP/MIME_types][MIME type]]\nhere is slightly adjusted from ~application/xml~ to\n~application/atom+xml~.\n\nWhile this might not be important for many feed readers, it could\nstill be a source of error.  So it is a good idea to play safe.  How\nyou could achieve this depends on the type of web server software you\nare running your website on.\n** Specifying the correct ~Content-Type~ for Netlify\nYou can specify the /Content-Type/ of ~atom.*~ and ~*.atom~ files to\nbe ~application/atom+xml; charset=UTF-8~ using the below in your site's\n~netlify.toml~:\n#+begin_src conf-toml\n[[headers]]\n  for = \"atom.*\"\n  [headers.values]\n    Content-Type = \"application/atom+xml; charset=UTF-8\"\n[[headers]]\n  for = \"*.atom\"\n  [headers.values]\n    Content-Type = \"application/atom+xml; charset=UTF-8\"\n#+end_src\n*** References\n- [[https://www.netlify.com/docs/headers-and-basic-auth/]]\n- [[https://www.netlify.com/blog/2017/10/17/introducing-structured-redirects-and-headers/]]\n** Note about Google Chrome\nNote that Google Chrome currently still [[https://bugs.chromium.org/p/chromium/issues/detail?id=84][features a bug]] for such MIME\ntypes so that automatic XML rendering is not performed.  You may\ndecide what is more important for you: watching the rendered source in\nyour browser once in a while, or maximum feed reader compatibility 😉.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkaushalmodi%2Fhugo-atom-feed","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkaushalmodi%2Fhugo-atom-feed","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkaushalmodi%2Fhugo-atom-feed/lists"}