Skip to content

◷ 发表于: 2025-03-18

◷ 更新于: 2025-08-01

🅆 字数: 0

配置 vitepress-plugin-rss

基于 pagefind 实现的离线全文搜索

下载依赖

sh
$ npm i vitepress-plugin-rss
sh
$ pnpm add vitepress-plugin-rss
sh
$ yarn add vitepress-plugin-rss

引入插件

文件路径 .vitepress/config.mts

.vitepress/config.mts
typescript
import { defineConfig } from 'vitepress'
import { RssPlugin } from 'vitepress-plugin-rss'

export default defineConfig({
  vite: {
    plugins: [
        RssPlugin({
            title: 'WIKI',
            baseUrl: 'https://rxht.github.io',
            copyright: `版权所有 © 2024-${new Date().getFullYear()} 荣轩浩[rxht]`
        })
    ]
  }
})

UI 更新

在网站的 socialLinks 会自动新增一个 RSS 图标,如下图

rss

编译时控制台输出

sh
🎉 RSS generated feed.rss
rss filepath: xxxxxxx\wiki\.vitepress\dist\feed.rss
rss url: https://rxht.github.io/wiki/feed.rss

提示

如果不想让指定文章出现在 RSS 文件中,可以在文章顶部添加 publish: false

md
---
publish: false
---

提示

如果 RSS 文件出现乱码,以 Nginx 为例,可以添加如下配置

json
location ~ \.rss$ {
  charset utf-8;
}

修复完成后请求 RSS 文件会有如下返回结果

rss

更详细配置可查看

基于 CC BY-NC-SA 4.0 许可发布