Feed 支持
vuepress-theme-hope
通过内置 @vuepress/plugin-feed
插件来为你提供 feed 支持。想使用它,你应该手动在你的项目中安装 @vuepress/plugin-feed
。
相关信息
vuepress-theme-hope
将主题选项中的 plugins.feed
选项作为插件选项提供给 @vuepress/plugin-feed
。
使用
@vuepress/plugin-feed
插件可为你生成以下三种格式的 feed 文件:
- Atom 1.0
- JSON 1.1
- RSS 2.0
如果可以,请尽可能使用 RSS。Atom 和 JSON 是为了最好的兼容性而提供的。
请按照需要生成的格式,在主题选项中设置 plugins.feed.atom
, plugins.feed.json
或 plugins.feed.rss
为 true
。
提示
当然,你可以都输出它们,这不是一个三选一。
考虑到现在 Feed 已经很小众,此插件旨在提供最小配置来尽可能自动生成详细的 Feed 文件。当然此插件也预留了充足的设置项,以让你自由定义 Feed 的输出内容。
频道设置
你可以在主题选项中通过设置 plugins.feed.channel
选项来自自定义 Feed 频道的各项信息。
我们推荐进行如下设置:
- 将建立 Feed 的日期转换为 ISOString 写入到
channel.pubDate
中 - 通过
channel.ttl
中设置内容的更新周期(单位: 分钟) - 通过
channel.copyright
设置版权信息,或回退到主题选项中的copyright
- 通过
channel.author
设置频道作者,或回退到主题选项中的author
。
默认频道设置
频道的标题、描述默认为站点的名称与链接。
频道的链接、最后更新时间会由插件自动生成。
频道的版权信息会尝试从页脚的版权信息中读取。
详细的选项及其默认值详见 Feed 频道文档。
生成控制
项目默认生成逻辑
默认情况下,所有文章均会被添加至 feed 流。
你可以通过配置 frontmatter 中的 feed
选项,对特定文章的 feed 项目生成的内容进行控制,详见 Feed frontmatter 文档。
你可以通过配置插件选项中的 getter
,完全控制 Feed 项目的生成逻辑,详见 Feed 获取器文档。
多语言配置
插件会针对每个语言生成单独的 Feed。
你可以通过插件选项中的 locales
分别对不同语言提供不同的默认设置。