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 和 JSON 是为了提供更多 Feed 软件的适配而提供的。
如果可以，请尽可能使用 RSS。
请按照需要生成的格式，在主题选项中设置 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 流。
关于默认情况下读取的内容，详见 配置 → 项目控制。
自定义页面
你可以通过配置 frontmatter 中的 feed 选项，对特定文章的 feed 项目生成的内容进行控制。
详细的选项及其默认值详见 配置 → 项目设置。
自定义 Feed 生成
你可以通过配置插件选项中的 getter，完全控制 Feed 项目的生成逻辑。
详细的选项及其默认值详见 配置 → Feed 获取器。
多语言配置
插件会针对每个语言生成单独的 Feed。
你可以通过插件选项中的 locales 分别对不同语言提供不同的默认设置。