跳转到内容
Astro Astro

添加 RSS 订阅源

准备好…

  • 安装 Astro 的包，用于为你的网站创建一个 RSS 订阅源
  • 创建一个可以通过 RSS 订阅源阅读的订阅源

安装 Astro 的 RSS 包

Astro 提供了一个可自定义包，用于快速为你的网站添加一个 RSS 订阅源。

这个官方包会生成一个非 HTML 文档，其中包含有关你的所有博客文章的信息，可以被 Feedly、The Old Reader 等 订阅源阅读器（Feed Reader） 读取。每次重新构建你的网站时，该文档都会更新。

个人用户可以通过订阅源阅读器订阅你的订阅源，在你的网站上发布新博客文章时会收到通知，这使它成为一个受欢迎的博客功能。

  1. 退出 Astro 开发服务器，并在终端中运行以下命令以安装 Astro 的 RSS 包。

    Terminal window
    npm install @astrojs/rss

  2. 重新启动开发服务器，以继续预览你的 Astro 项目。

    Terminal window
    npm run dev

创建一个 .xml 订阅源文档

  1. 在 src/pages/ 目录下创建一个名为 rss.xml.js 的新文件。

  2. 将以下代码复制到这个新文档中。自定义 title 和 description 属性，如果需要，可以在 customData 中指定不同的语言：

    src/pages/rss.xml.js
    import rss, { pagesGlobToRssItems } from '@astrojs/rss';
    

    export async function GET(context) {
      return rss({
        title: 'Astro Learner | Blog',
        description: 'My journey learning Astro',
        site: context.site,
        items: await pagesGlobToRssItems(import.meta.glob('./**/*.md')),
        customData: `<language>en-us</language>`,
      });
    }

  3. 在 Astro 的配置文件中设置 site 属性为你的网站自己的唯一 Netlify URL。

    astro.config.mjs
    import { defineConfig } from "astro/config";
    

    export default defineConfig({
      site: "https://example.com"
    });

  4. 这个 rss.xml 文档只有在构建你的网站时才会创建，因此在开发过程中无法在浏览器中查看该页面。退出开发服务器，并运行以下命令，首先在本地编译你的网站，然后查看编译的预览：

    Terminal window
    npm run build
    

    npm run preview

  5. 访问 http://localhost:4321/rss.xml，验证你是否可以在页面上看到（未格式化的）文本，每个 .md 文件都有一个 item。每个 item 应包含博客文章的信息，例如 title、url 和 description。

  6. 当你想以开发模式查看你的网站时，请确保退出预览并重新启动开发服务器。

任务清单

相关资源