跳至主要內容

插件配置

大约 2 分钟

hostname

  • 类型: string
  • 必填: 是

部署网站的域名。

atom

  • 类型: boolean
  • 默认值: false

是否启用 Atom 格式输出。

json

  • 类型: boolean
  • 默认值: false

是否启用 JSON 格式输出。

rss

  • 类型: boolean
  • 默认值: false

是否启用 RSS 格式输出。

image

  • 类型: string

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

icon

  • 类型: string

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

count

  • 类型: number
  • 默认值: 100

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

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

preservedElements

  • 类型: (RegExp | string)[] | (tagName: string) => boolean
  • 默认值: []

应在 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 格式输出路径,相对于输出路径。

atomXslTemplate

  • 类型: string
  • 默认值: "vuepress-plugin-feed2/templates/atom.xsl"

Atom xsl 模板文件路径

atomXslFilename

  • 类型: string
  • 默认值: "atom.xsl"

Atom xsl 输出路径,相对于输出路径。

jsonOutputFilename

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

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

rssOutputFilename

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

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

rssXslTemplate

  • 类型: string
  • 默认值: "vuepress-plugin-feed2/templates/rss.xsl"

RSS xsl 模板文件路径。

rssXslFilename

  • 类型: string
  • 默认值: "rss.xsl"

RSS xsl 输出路径,相对于输出路径。

getter

Feed 生成控制器

提示

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

详见 Feed 生成器.

locales

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

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

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