JSON Feed 与 Podcast Feed 构建实践

{
  "version": "https://jsonfeed.org/version/1.1",
  "title": "Feed 标题",
  "home_page_url": "https://example.com/",
  "feed_url": "https://example.com/feed.json",
  "description": "Feed 描述",
  "author": {
    "name": "作者姓名",
    "url": "https://example.com/author",
    "avatar": "https://example.com/avatar.jpg"
  },
  "items": [
    {
      "id": "唯一标识符",
      "url": "内容页面 URL",
      "title": "内容标题",
      "content_text": "纯文本内容",
      "content_html": "HTML 内容",
      "summary": "内容摘要",
      "date_published": "2025-01-01T00:00:00Z",
      "tags": ["标签 1", "标签 2"]
    }
  ]
}

{{- $.Scratch.Add "pagesIndex" slice -}}
{{- range $index, $page := .Site.Pages -}}
  {{- if in (slice "blog" "notice" "book" "trans" "podcast" "ai") $page.Section -}}
    {{- if and (not .Draft) (not .Params.private) | and (ne .Params.searchable false) -}}
      {{- if gt (len $page.Content) 0 -}}
        {{- /* Generate page description. */ -}}
        {{- $desc := "" -}}
        {{- if .Params.description -}}
          {{- $desc = .Params.description -}}
        {{- else -}}
          {{- $desc = .Summary -}}
        {{- end -}}
        {{- /* Add page data including the date, type, tags and categories fields */ -}}
        {{- $pageData := (dict
          "title" $page.Title
          "relpermalink" $page.RelPermalink
            "summary" (
            (
              $desc
              | plainify
            )
            )
            "content" (
            (
              $page.Content
              | replaceRE "(?is)<!--.*?-->" ""
              | replaceRE "(?is)<script[^>]*>.*?</script>" ""
              | replaceRE "(?is)<details[^>]*>.*?</details>" ""
              | replaceRE "(?is)<div[^>]*class=\"highlight\"[^>]*>.*?</div>" ""
              | replaceRE "(?is)<style[^>]*>.*?</style>" ""
              | replaceRE "(?is)<pre[^>]*>.*?</pre>" ""
              | replaceRE "(?is)<figure[^>]*>.*?</figure>" ""
              | replaceRE "(?is)<nav[^>]*>.*?</nav>" ""
              | replaceRE "(?is)<aside[^>]*>.*?</aside>" ""
              | replaceRE "(?is)<footer[^>]*>.*?</footer>" ""
              | plainify
              | htmlEscape
              | truncate 200
            )
            )
          "date" $page.Date
          "section" $page.Section
          "tags" .Params.tags
          "categories" .Params.categories
        ) -}}
        {{- $.Scratch.Add "pagesIndex" $pageData -}}
      {{- end -}}
    {{- end -}}
  {{- end -}}
{{- end -}}
{{- $.Scratch.Get "pagesIndex" | jsonify -}}

<rss xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd" version="2.0">
  <channel>
    <!-- 频道级别元数据 -->
    <title>播客标题</title>
    <description>播客描述</description>
    <link>https://example.com/podcast</link>
    <language>zh-cn</language>
    <copyright>版权信息</copyright>

    <!-- iTunes 特定标签 -->
    <itunes:author>主持人姓名</itunes:author>
    <itunes:image href="封面图片URL"/>
    <itunes:category text="分类名称"/>
    <itunes:explicit>no</itunes:explicit>
    <itunes:owner>
      <itunes:name>所有者姓名</itunes:name>
      <itunes:email>联系邮箱</itunes:email>
    </itunes:owner>
  </channel>
</rss>

<rss xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd"
     xmlns:atom="http://www.w3.org/2005/Atom"
     xmlns:content="http://purl.org/rss/1.0/modules/content/" version="2.0">
  <channel>
    {{/* Get podcast params from site config, section front matter, or defaults */}}
    {{ $podcastParams := .Site.Params.podcast | default dict }}
    {{ $sectionParams := .Params | default dict }}

    {{ $podcastTitle := $sectionParams.podcast_title | default ($podcastParams.title | default .Site.Title) }}
    {{ $podcastLink := $sectionParams.podcast_website_url | default ($podcastParams.website_url | default .Permalink) }}
    {{ $podcastDescription := $sectionParams.podcast_description | default ($podcastParams.description | default .Site.Params.description) }}
    {{ $languageCode := $sectionParams.podcast_language_code | default ($podcastParams.language_code | default .Site.Language.Lang | default .Site.LanguageCode) }}
    {{ $copyrightText := $sectionParams.podcast_copyright_text | default ($podcastParams.copyright_text | default .Site.Copyright) }}
    {{ $podcastAuthor := $sectionParams.podcast_author | default ($podcastParams.author | default .Site.Params.author) }}
    {{ $podcastCoverImage := $sectionParams.podcast_cover_image_url | default $podcastParams.cover_image_url }}
    {{ $podcastExplicit := $sectionParams.podcast_explicit | default ($podcastParams.explicit | default "no") }}
    {{ $podcastType := $sectionParams.podcast_type | default ($podcastParams.type | default "episodic") }}
    {{ $ownerName := $sectionParams.podcast_owner_name | default ($podcastParams.owner_name | default $podcastAuthor) }}
    {{ $ownerEmail := $sectionParams.podcast_owner_email | default ($podcastParams.owner_email | default .Site.Params.email) }}
    {{ $categories := $sectionParams.podcast_categories | default $podcastParams.categories }}

    <title>{{ $podcastTitle }}</title>
    <link>{{ $podcastLink }}</link>
    <description>{{ $podcastDescription }}</description>
    <generator>Hugo -- gohugo.io</generator>
    {{ with $languageCode }}<language>{{ . }}</language>{{ end }}
    {{ with $copyrightText }}<copyright>{{ . }}</copyright>{{ end }}
    {{ if not .Date.IsZero }}<lastBuildDate>{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 GMT" | safeHTML }}</lastBuildDate>{{ else }}<lastBuildDate>{{ now.Format "Mon, 02 Jan 2006 15:04:05 GMT" | safeHTML }}</lastBuildDate>{{ end }}

    <atom:link href="{{ .Site.BaseURL | relURL }}/podcast/index.xml" rel="self" type="application/rss+xml"/>

    {{ with $podcastCoverImage }}<itunes:image href="{{ . | absURL }}"/>{{ end }}
    {{ if $categories }}
      {{ range $categories }}
        <itunes:category text="{{ . }}"/>
      {{ end }}
    {{ else }}
      {{/* Default category if none provided */}}
      <itunes:category text="Society & Culture"/>
    {{ end }}
    <itunes:explicit>{{ $podcastExplicit }}</itunes:explicit>
    {{ with $podcastAuthor }}<itunes:author>{{ . }}</itunes:author>{{ end }}
    <itunes:owner>
      {{ with $ownerName }}<itunes:name>{{ . }}</itunes:name>{{ end }}
      {{ with $ownerEmail }}<itunes:email>{{ . }}</itunes:email>{{ end }}
    </itunes:owner>
    <itunes:type>{{ $podcastType }}</itunes:type>
  </channel>
</rss>

{{ range where $pages "Params.audio_url" "!=" nil }}
<item>
  <title>{{ .Title | plainify }}</title>
  {{ $episodeLink := .Params.episode_link | default .Permalink }}
  <link>{{ $episodeLink }}</link>
  <pubDate>{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 GMT" | safeHTML }}</pubDate>
  {{ $itemGuid := .Params.guid | default .Permalink }}
  {{ $isPermaLink := eq (.Params.guid | default "") "" }}
  <guid isPermaLink="{{ $isPermaLink }}">{{ $itemGuid }}</guid>

  {{ if and .Params.audio_url .Params.audio_length .Params.audio_type }}
  <enclosure url="{{ .Params.audio_url | absURL }}" length="{{ .Params.audio_length }}" type="{{ .Params.audio_type }}"/>
  {{ end }}

  {{ $descriptionContent := .Summary }}
  {{ if .Params.description }}
    {{ $descriptionContent = .Params.description }}
  {{ end }}
  {{ $description := $descriptionContent | default .Summary | default .Content }}
  {{ $description = replaceRE "(?is)<!--.*?-->" "" $description }}
  {{ $description = replaceRE "(?is)<script[^>]*>.*?</script>" "" $description }}
  {{ $description = replaceRE "(?is)<details[^>]*>.*?</details>" "" $description }}
  {{ $description = $description | plainify | truncate 500 | htmlEscape }}
  {{ $description = replaceRE `]]>` "]]&gt;" $description }}
  <description>{{ $description }}</description>

  {{ $encodedContent := .Content }}
  {{ if .Params.content_encoded }}
    {{ $encodedContent = .Params.content_encoded }}
  {{ end }}
  {{ $encodedContent = replaceRE "(?is)<!--.*?-->" "" $encodedContent }}
  {{ $encodedContent = replaceRE "(?is)<script[^>]*>.*?</script>" "" $encodedContent }}
  {{ $encodedContent = replaceRE "(?is)<details[^>]*>.*?</details>" "" $encodedContent }}
  <content:encoded>{{ $encodedContent }}</content:encoded>

  {{ with .Params.itunes_episode_type }}<itunes:episodeType>{{ . }}</itunes:episodeType>{{ end }}
  {{ with .Params.itunes_episode_number }}<itunes:episode>{{ . }}</itunes:episode>{{ end }}
  {{ with .Params.itunes_season }}<itunes:season>{{ . }}</itunes:season>{{ end }}

  {{ with .Params.itunes_keywords }}
    <itunes:keywords>
      {{ range $index, $keyword := split . "," }}
        {{ if $index }},{{ end }}{{ $keyword | trim " \t\n\r" | safeHTML }}
      {{ end }}
    </itunes:keywords>
  {{ end }}

  {{ with .Params.duration }}<itunes:duration>{{ . }}</itunes:duration>{{ end }}
  {{ $episodeImage := .Params.episode_image_url | default $podcastCoverImage }}
  {{ with $episodeImage }}<itunes:image href="{{ . | absURL }}"/>{{ end }}

  {{ $itemAuthor := .Params.itunes_author_item | default $podcastAuthor }}
  {{ with $itemAuthor }}<itunes:author>{{ . }}</itunes:author>{{ end }}

  {{ $itemExplicit := .Params.itunes_explicit_item | default $podcastExplicit }}
  <itunes:explicit>{{ $itemExplicit }}</itunes:explicit>
</item>
{{ end }}

---
title: "北京小客车摇号深度探讨"
date: 2025-05-18 00:12:03+00:00
draft: false
description: "关于摇号政策的深度分析..."
categories:
- Jimmy 的播客
audio_url: https://assets.jimmysong.io/podcasts/audios/ep-001.mp3
audio_type: audio/mpeg
duration: 486
audio_length: '4533959'
episode_image_url: https://assets.jimmysong.io/podcasts/images/ep-001.jpg
---

[outputs]
# 首页输出多种格式
home = ["HTML", "RSS", "JSON"]
# 播客章节专门输出
podcast = ["HTML", "RSS"]
# 博客章节输出标准格式
blog = ["HTML", "RSS", "JSON"]

# 检查 JSON Feed 语法
curl -s "https://example.com/index.json" | jq .

# 验证 RSS 结构
curl -s "https://example.com/podcast/index.xml" | xmllint --format -

# 检查音频文件可访问性
curl -I "https://assets.example.com/audio/ep001.mp3"

<!-- Apple Podcasts 要求的核心标签 -->
<itunes:category text="Technology"/>
<itunes:image href="https://example.com/podcast-cover.jpg"/>
<itunes:explicit>no</itunes:explicit>
<enclosure url="https://example.com/ep001.mp3"
           length="4533959"
           type="audio/mpeg"/>