←

为 Astro 个人博客添加 RSS 订阅

记录 RSS 订阅端点的组成、本地查看方式,以及正式域名确定后需要更新的位置。

  • Astro
  • RSS

这篇文章记录当前个人 Astro 博客添加 RSS 订阅的一次配置过程。

RSS 是什么

RSS 是一种让读者订阅网站更新的 XML 格式。订阅工具读取 RSS 地址后,可以按时间获取网站提供的新文章标题、摘要、发布日期和链接,而不需要逐页访问网站。

这次博客的 RSS 地址设为 /rss.xml。页面的 <head> 已加入 RSS 自动发现链接,普通访客的导航暂时不展示 RSS 入口。

这次添加了什么

项目安装了 @astrojs/rss,并新增了 src/pages/rss.xml.ts 端点。

端点会从 Astro Content Collections 读取博客文章,只保留 draft: false 的内容,再按发布日期从新到旧排序。每个 RSS 条目包含:

  • 文章标题;
  • 文章摘要;
  • 发布日期;
  • 对应文章的绝对链接。

构建完成后,静态文件会生成在 dist/rss.xml。当前已发布文章已经出现在这个文件中;草稿文章不会被写入 RSS。

如何在本地查看

启动本地开发服务器后,可以直接打开:

http://localhost:4321/rss.xml

浏览器会显示 XML 内容。也可以在构建后打开项目中的 dist/rss.xml,检查生成的订阅内容。

正式域名如何影响 RSS

RSS 文章链接使用 Astro 的 site 配置生成。本站目前将 https://www.allaido.com 设为正式地址。

若将来更换域名,需要同步更新 astro.config.mjs 和 src/config/site.ts,再重新运行构建。这样 RSS 中的频道链接、文章链接和 GUID 会使用新域名。

草稿状态

本文的 frontmatter 设置为 draft: false,所以目前会出现在公开页面和 RSS 中。需要暂时隐藏时,可把它改为 true 并重新构建。

读到这里,谢谢你。继续浏览建站