summaryrefslogtreecommitdiff
path: root/website/src
diff options
context:
space:
mode:
authorJoe Carstairs <me@joeac.net>2026-04-16 20:04:07 +0100
committerJoe Carstairs <me@joeac.net>2026-04-16 20:04:07 +0100
commit6363a0aeb3d8a5ac8c7393fb3cba24b05c0703e4 (patch)
tree5fbc06bc72d52134ce520a2daf460ec15ae33363 /website/src
parent357b17443112204ceb6a096a79fdd001ec0fbfe5 (diff)
subscribe to this blog!
Diffstat (limited to 'website/src')
-rw-r--r--website/src/components/BlogFeed.astro2
-rw-r--r--website/src/content/blog/2026-04-16.md20
-rw-r--r--website/src/pages/blog/index.astro6
-rw-r--r--website/src/pages/blog/subscribe.astro90
4 files changed, 117 insertions, 1 deletions
diff --git a/website/src/components/BlogFeed.astro b/website/src/components/BlogFeed.astro
index 663a826..af61dca 100644
--- a/website/src/components/BlogFeed.astro
+++ b/website/src/components/BlogFeed.astro
@@ -66,6 +66,8 @@ const canonicalBlogUrl = new URL('blog', Astro.site)
</p>
</aside>
+ <slot />
+
{ hideSubheadings
? <ul>
{ posts.sort(sortByPubDateDescending).map(post => (
diff --git a/website/src/content/blog/2026-04-16.md b/website/src/content/blog/2026-04-16.md
new file mode 100644
index 0000000..0e1fd11
--- /dev/null
+++ b/website/src/content/blog/2026-04-16.md
@@ -0,0 +1,20 @@
+---
+title: Subscribing to this blog
+description:
+ I've added a page to this Website describing how you can subscribe to this
+ blog.
+pubDate: 2026-04-16
+---
+
+Hi all! Since I started this blog, I've been publishing an RSS file to go
+alongside it. If you don't know, an RSS file is a really old and really simple
+and really fantastic way to subscribe to updates on any Website that publishes
+one. You can use it to subscribe to my Website. You don't have to remember to
+look at it every once in a while. RSS is all over the Web, by the way, and you
+can use it for way cooler stuff than my blog. If that's news to you, have a
+look!
+
+=> <a href="/blog/subscribe">How to subscribe to this blog</a><br> =>
+<a href="/blog/rss.xml">My RSS file</a><br> =>
+<a href="https://doctorow.medium.com/you-should-be-using-an-rss-reader-76aed31151f9">Cory
+Doctorow explaining why RSS is ridiculously good</a>
diff --git a/website/src/pages/blog/index.astro b/website/src/pages/blog/index.astro
index 61a1a46..df758ed 100644
--- a/website/src/pages/blog/index.astro
+++ b/website/src/pages/blog/index.astro
@@ -13,7 +13,11 @@ import Navbar from '../../components/Navbar.astro';
<body>
<Navbar />
<main>
- <BlogFeed headingLevel={1} />
+ <BlogFeed headingLevel={1}>
+ <section>
+ <p><a href="/blog/subscribe">How to subscribe to this blog</a></p>
+ </section>
+ </BlogFeed>
</main>
</body>
</html>
diff --git a/website/src/pages/blog/subscribe.astro b/website/src/pages/blog/subscribe.astro
new file mode 100644
index 0000000..f90cda1
--- /dev/null
+++ b/website/src/pages/blog/subscribe.astro
@@ -0,0 +1,90 @@
+---
+import Page from "../../layouts/Page.astro";
+
+---
+
+<Page
+ title="How to subscribe to joeac's blog"
+ description="How to subscribe to joeac's blog"
+>
+ <section>
+ <h1>How to subscribe to my blog</h1>
+
+ <p>
+ The short version: use my <a href="/blog/rss.xml">RSS file</a> or my
+ <a href="gemini://joeac.net/logs/longlog.gmi">gemlog</a>.
+ </p>
+
+ <p>
+ If neither of those things means anything to you, no worries. You could
+ just look at my website every once in a while, but that gets old. A better
+ way is to use my RSS file. Here's how.
+ </p>
+
+ <p>
+ An RSS file, if you don't know, is a file containing a list of posts in a
+ format that's so stupid even computers can understand it. Mine is at
+ <a href="https://joeac.net/blog/rss.xml">https://joeac.net/blog/rss.xml</a>.
+ Since computers can understand it, you can get software to read it
+ automatically and tell you when I've made a new blog post. That's much less
+ hassle than having to check manually yourself!
+ </p>
+
+ <p>
+ I'm not the only person serving RSS files, of course. You might not have
+ heard of them, but they're actually all over the Web. In the early days of
+ the Web, everyone was using them, so they've ended up built in to a whole
+ load of foundational Web technology, and hence ubiquitous, even if most
+ Web users have forgotten they exist. Once you've subscribed to my blog,
+ you can subscribe to basically any blog, podcast, or YouTube channel, and
+ a lot of other Websites for news, organisations, whatever. Point a
+ well-designed RSS aggregator or RSS reader at most Websites, and it'll
+ automatically find an associated RSS feed.
+ </p>
+
+ <p>
+ If you're not persuaded, try reading
+ <a href="https://doctorow.medium.com/you-should-be-using-an-rss-reader-76aed31151f9">
+ Cory Doctorow explaining why RSS is ridiculously good
+ </a>. He's terrifyingly persuasive. Also, read his novels!
+ </p>
+
+ <p>
+ If you just want to give it a go quickly, probably the quickest way is to
+ use someone else's RSS aggregator that they'll let you use as a service.
+ <a href="https://feedly.com/news-reader">Feedly</a> and
+ <a href="https://www.inoreader.com">Inoreader</a> have free tiers.
+ </p>
+
+ <p>
+ If you want to have a little more control, you can self-host an RSS
+ reader, like <a href="https://tt-rss.org">Tiny Tiny RSS</a>,
+ <a href="https://miniflux.app">Miniflux</a>, or
+ <a href="https://freshrss.org">FreshRSS</a>. But why would you do that?
+ Self-hosting is complicated. Why not just use a normal, local app? Here are
+ some options for that you might want to investigate. All these are active
+ free and open-source software projects at the time of writing.
+ </p>
+
+ <ul>
+ <li><a href="https://hyliu.me/fluent-reader">Fluent Reader</a> (Linux, Windows, Mac, also mobile I think?)</li>
+ <li><a href="https://www.rssowl.org">RSSOwl</a> (Linux, Windows, Mac)</li>
+ <li><a href="https://capyreader.com">Capy Reader</a> (Android)</li>
+ <li><a href="https://apps.kde.org/en-gb/akregator">Akregator</a> (Linux, Windows (unstable))</li>
+ <li><a href="https://gfeeds.gabmus.org">GFeeds</a> (Linux)</li>
+ <li><a href="https://lzone.de/liferea">Liferea</a> (Linux)</li>
+ </ul>
+
+ <p>
+ For the terminally geeky, there is also
+ <a href="https://newsboat.org">Newsboat</a>. I used it for ages, it works
+ fabulously, but it's all in the terminal, so you have to be OK with that.
+ </p>
+
+ <p>
+ You can also just enter 'RSS feed reader' into your favourite search
+ engine, software distribution, or app store and see what comes up. Try
+ adding 'FOSS' into the query to prioritise free, open-source software.
+ </p>
+ </section>
+</Page>