Explaining basics of web syndication feeds for websites. Two feeds are available: a RSS summary feed and an Atom full-text feed. Fit your reading preferences and get BurgeonLab blog updates easily.
/subscribe/Web Syndication: RSS and Atom Feeds
Table of Contents
Follow My Blog
I created XML feeds for different post types; subscribe to ones you’re interested in! I plan to publish more diverse content; so expect additional feed options as the site grows.
Thanks for your interest and readership! 😊
Note
Feed readers and XML feeds are often cached aggressively, which means you might see stale or outdated content in your reader (as I often make updates after publishing). For the most current version, it’s best to visit my site directly in your web browser.
If a page contains Mermaid diagrams or JavaScript graphs/charts, there will be an automatic message injected at the top to warn readers, with a link to open the post in the browser for correct rendering. The same goes for more dynamic pages like the /guestbook page.
Types of Feeds
All feeds provide full-text unless otherwise specified. Full-text means you can read the whole post (with full content, images, most code blocks) within your feed reader app.
Summary-only feeds are lightweight and contain short summaries of what a post is about, with a link to read the full post on the website.
| Main (summary-only) : Traditional, long-form blog articles and pages.
|
| Main: Traditional, long-form blog articles and pages.
|
| Weeknotes: Informal, personal (but sometimes technical) weekly reflections.
|
| Photos: Short-form content where photo(s) provide the main context; an Instagram-replacement.
|
| Firehose (summary-only): All these feeds combined—everything is included—make up the Firehose!
|
To learn about web feeds in general and how I use them, read on!
What is Web Syndication
Being able to consume Internet content using a feed reader (aka newsreader or news aggregator client) of your own choosing is a flexible and convenient way of reading digital media. Usually this consists of HTML content from blogs or websites, podcasts are also supported. It is an open standard and allows for people to “keep tabs on” blogs/sites without signing up for another email newsletter or entering centralized services.
How to Add a News Source
To add a source (be it a site you want to follow, a podcast you like to get updates on, etc) into your client so you can get notified when it publishes new content; you first have to locate the source’s feed URL. It can usually be found at the header or footer of a site with an orange logo or terms like “Feed”, “RSS”, “Subscribe”. If it is not obvious, I like to use a free open source tool called RSS Lookup to find the feed of a site.
Tip
To load my feeds automatically in feed readers, you can try typing in
https://burgeonlab.com/subscribeand it technically should display all the feeds I have, but each reader is a bit different so it is not that reliable. Visiting this page on a browser would be the best option.
Once you’ve amassed a collection of sources, you can always export the .OPML file for backup or if you want to change clients. This is the list of all the web feeds you subscribed to.
Readers I Personally Use
I mainly read feeds on my phone (Android) and not on my desktop (macOS), so my subscriptions are all on Feeder. I export the .OPML occasionally to update my desktop client—Fluent Reader. Unfortunately it’s deprecated (last update was October 2023), so I wouldn’t recommend it to someone who wants a macOS RSS reader. My recommendation would be NetNewsWire which supports macOS and iOS.
If you’re into self-hosting, there’s quite a few good RSS readers/news aggregators you can consider the likes of MiniFlux, FreshRSS (which are the main two I keep seeing people recommend). I have MiniFlux on a Docker container on my Raspberry Pi 4B DietPi home server, but I never got round setting it up—which is why I’m still relying on single device reading with Feeder.
Feed Formats
The main format of web feeds are .XML based. Atom and RSS formats are the most well known. Atom is the newer/younger one (released in 2005) compared to its rival, RSS, which was announced in 1999, 26 years ago. Both are widely supported with all clients, with RSS having a slight edge in compatibility with older/simpler readers.
As a consumer/reader of feeds, Atom feeds allows for more complex/richer content to be shown, as well as supporting updated timestamps on posts compared to RSS feeds. Whereas the advantages of subscribing to an RSS feed means compatibility is almost always at 100%, but that’s about it. It may have a simpler structure, but as a consumer, I think Atom feeds wins out.
Hugo Integration
As a web dev’s standpoint, I think both has its pros and cons, which is why I decided to integrate both in my Hugo blog. RSS templates was already supported in my theme/Hugo’s backend, despite having validation issues. I actually wrote about fixing my theme’s RSS template and making my first contributions to a GitHub project as a result! It was a very nice learning process, but I digress.
Hugo does not automatically output Atom feeds, so I managed to add my own custom configs and template to output a second feed with full-text instead of just summaries. I have to iron a few small issues still; like post bundle cover images not showing up properly (default blog cover image works). The main features of the Atom feed has been validated and is working well otherwise.
Conclusion
While feeds provide convenience to the reader, as someone who has put in time and effort designing my blog to look “nice” (in my opinion) and work smoothly, I would of course appreciate it immensely if you visit and read my posts on the site directly! I hope offering a full-text feed won’t reduce my site’s visitor count as I do enjoy seeing which posts get more traffic, which in turn gives me ideas as to what to write next; and also to rank my Top 5 section on the home page.
Thanks for reading and subscribing to my blog,
Naty
Comments
Don't use any of these? Use the contact form.
Send one manually here
See IndieWeb Webmentions to learn more. Put simply, it's like @-mentions but for personal websites. I get notified when you link to this page. (This form uses webmention.io's backend.)