Feed 插件配置

大约 2 分钟配置插件配置主题配置Feed

介绍 默认启用

vuepress-theme-hope 通过 vuepress-plugin-feed2 插件提供 Feed 生成支持。

vuepress-theme-hope 将主题选项中的 plugins.feed 作为插件选项传递给 vuepress-plugin-feed2 插件。

vuepress-plugin-feed2 插件可为你生成以下三种格式的 feed 文件:

  • Atom 1.0
  • JSON 1.1
  • RSS 2.0

请按照需要生成的格式,在插件选项中设置 atom, jsonrsstrue 来启用插件。

提示

Atom 和 JSON 是为了提供更多 Feed 软件的适配而提供的。

如果可以,请尽可能使用 RSS。

相关信息

有关更多详细信息,请参见 feed2 插件文档

插件选项

atom

  • 类型: boolean
  • 默认值: false

是否启用 Atom 格式输出。

json

  • 类型: boolean
  • 默认值: false

是否启用 JSON 格式输出。

rss

  • 类型: boolean
  • 默认值: false

是否启用 RSS 格式输出。

image

  • 类型: string

一个大的图片,用作 feed 展示。

icon

  • 类型: string

一个小的图标,显示在订阅列表中。

count

  • 类型: number
  • 默认值: 1000

设置 feed 的最大项目数量。在所有页面排序好后,插件会截取前 count 个项目。

如果你的站点文章很多,你应该考虑设置这个选项以减少 feed 文件大小。

removedElements

  • 类型: string[]
  • 默认值: ["ExternalLinkIcon"]

应在 Feed 中删除的自定义元素或组件。

filter

  • 类型: (page: Page)=> boolean

  • 默认值:

    ({ frontmatter, filePathRelative }: Page): boolean =>
      !(
        frontmatter.home ||
        !filePathRelative ||
        frontmatter.article === false ||
        frontmatter.feed === false
      );
    

自定义的过滤函数,用于过滤哪些项目在 feed 中显示。

sort

  • 类型: (pageA: Page, pageB: Page)=> number

自定义排序函数,用于对站点中的页面进行排序。

最终生成的 feed 文件将会按照这个顺序对项目进行显示。

注意

强烈建议设置这个选项,否则 feed 流中,项目的顺序完全由 VuePress 默认输出的 pages 顺序决定。

你可以按照自己的需求对站点内的页面进行排序。

channel

channel 选项用于配置 Feed 频道。

可用选项详见 配置 → 频道设置

atomOutputFilename

  • 类型: string
  • 默认值: atom.xml

Atom 格式输出路径,相对于输出路径。

jsonOutputFilename

  • 类型: string
  • 默认值: feed.json

JSON 格式输出路径,相对于输出路径。

rssOutputFilename

  • 类型: string
  • 默认值: rss.xml

RSS 格式输出路径,相对于输出路径。

getter

Feed 生成控制器

提示

插件已经在默认情况下提供了合理的获取器,如果你需要完全控制 Feed 生成,你可以设置此项。

详见 Feed 生成器.

locales

  • 类型: Record<string, BaseFeedOptions>
  • 必填: 否

你可以将它用于每个语言环境的特定选项。

hostname 外,上述任何选项均受支持。