Hugo JSON Feed

中文 | English

Hugo 主题组件，用于自定义 JSON feed 输出格式。

该组件为您的站点启用 JSON feeds。

演示

• 主页 Feed
• 分类 Feed
• 标签 Feed

安装组件

安装方法与安装主题相同。有几种安装方式，选择一种，例如通过 Hugo Modules 安装：

[module]
  [[module.imports]]
    path = "github.com/hugo-fixit/FixIt"
+ [[module.imports]]
+   path = "github.com/hugo-fixit/hugo-json-feed"

配置

将 "jsonfeed" 添加到您希望创建 JSON feeds 的所有页面类型中：

[outputs]
  # <baseURL>/feed.json
  home = ["html", "rss", "jsonfeed"]
  # <baseURL>/posts/feed.json 等
  section = ["html", "rss", "jsonfeed"]
  # <baseURL>/tags/foo/feed.json 等
  term = ["html", "rss", "jsonfeed"]

如果您的站点使用多个主题组件，则需要合并所有主题组件的 outputs 配置。例如，如果您的站点同时使用 FixIt 和 hugo-json-feed 主题组件，则需要合并两个主题组件的 outputs 配置：

[outputs]
  _merge = "shallow"
  home = ["html", "rss", "jsonfeed", "archives", "offline", "readme", "baidu_urls", "search"]
  page = ["html", "markdown"]
  section = ["html", "rss", "jsonfeed"]
  taxonomy = ["html"]
  term = ["html", "rss", "jsonfeed"]

参数

您可以在站点配置文件中设置以下参数：

[params]
  # 全局 JSON feed 配置
  [params.feed]
    # feed 中包含的文章数量。如果设置为 -1，则包含所有文章。
    limit = 10
    # 是否在 feed 中显示全文。
    fullText = true

  # 分类页面配置（分类中的所有页面）
  [params.section]
    # 分类页面的 JSON feed 配置
    [params.section.feed]
      # feed 中包含的文章数量。如果设置为 -1，则包含所有文章。
      limit = -1
      # 是否在 feed 中显示全文。
      fullText = false

  # 标签列表（分类或标签）页面配置
  [params.list]
    # 标签列表的 JSON feed 配置
    [params.list.feed]
      # feed 中包含的文章数量。如果设置为 -1，则包含所有文章。
      limit = -1
      # 是否在 feed 中显示全文。
      fullText = false

Front matter

您可以在内容文件的 front matter 中设置以下参数：

---
title: "Hello World"
date: 2024-08-24T16:06:33+08:00
hiddenFromFeed: true
feed:
  # feed.limit 仅在分类或标签页面（_index.md）中有效。
  limit: 10
  fullText: true
---