愆伏

互联网杂谈

播客系统使用说明

系统概述

这是一个目录 + meta.json 驱动的播客管理工作流：你手动维护页面和音频，Node.js 脚本仅生成 RSS（podcast.xml）。

文件结构

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
source/
├── podcast/
│   ├── meta.json                      # 频道信息（全局）
│   ├── index.md                       # 播客列表页面（手动维护，可选）
│   └── episodes/                      # 播客集数文件夹
│       └── <slug>/
│           ├── index.html             # 播客详情页面（手动维护）
│           ├── audio.mp3              # 音频文件（或自定义文件名）
│           └── meta.json              # 本集元信息（脚本读取）
├── podcast.xml                        # RSS 文件（脚本生成）
└── assets/images/
    └── podcast-cover.jpg              # 播客封面图片（需要手动添加）

tools/
└── generate-podcast-content.js        # 生成脚本（手动运行，仅生成 RSS）

使用方法

1. 添加新播客集数

在 source/podcast/episodes/<slug>/ 下创建新文件夹： - 放置 index.html（播客详情页面） - 放置音频文件（默认 audio.mp3，也可自定义文件名） - 新建 meta.json（本集元信息）

meta.json 示例： 

1
2
3
4
5
6
7
8
9
10
{
  "title": "记忆里的台湾味道",
  "subtitle": "那些藏在记忆中的美食与背后的故事",
  "description": "用于 RSS 的简介文本……",
  "date": "2025-09-05",
  "duration": "00:03:39",
  "keywords": "关键字1,关键字2",
  "audio": "audio.mp3",
  "explicit": false
}

2. 生成 RSS

运行生成脚本：

1
npm run podcast

3. 重新生成站点

1
hexo clean && hexo generate

自动化功能

✅ 已实现

  • 目录 + meta.json 驱动: 每集目录内 meta.json 为唯一元数据源
  • RSS 生成: 符合 Apple Podcasts 标准（手动运行脚本）
  • 时间自动更新: RSS 中的 lastBuildDate 自动更新
  • 正确的日期格式: 支持中国时区 (+08:00)

📋 播客信息

  • 标题: 愆伏播客
  • 作者: tortorse
  • 网站: https://www.tortorse.com
  • RSS地址: https://www.tortorse.com/podcast.xml
  • 当前集数: 2集

🎯 发布到播客平台

Apple Podcasts

  1. 访问 Apple Podcasts Connect
  2. 使用RSS URL: https://www.tortorse.com/podcast.xml

Spotify

  1. 访问 Spotify for Podcasters
  2. 使用RSS URL: https://www.tortorse.com/podcast.xml

其他平台

  • Google Podcasts
  • 小宇宙
  • 喜马拉雅

注意事项

⚠️ 需要手动准备

  1. 播客封面图片: source/assets/images/podcast-cover.jpg
    • 尺寸: 1400x1400 或 3000x3000 像素
    • 格式: JPG 或 PNG
    • 大小: < 500KB
  2. 音频文件: 每集的音频（默认文件名 audio.mp3，可在 meta.json 中通过 audio 字段自定义）
    • 格式: MP3
    • 质量: 建议 128kbps 或更高
  3. 播客详情页面: 每集的 index.html
    • 包含播客播放器
    • 包含返回导航链接

🔧 配置文件

  • _config.yml: 确保 skip_render 包含 podcast.xml 与 podcast/episodes/**

维护工作流

  1. 添加新集数:
    • 创建集数文件夹与 index.html、音频文件、meta.json
    • 运行生成脚本
    • 重新生成站点
  2. 修改频道信息:
    • 编辑 source/podcast/meta.json
    • 运行生成脚本
  3. 更新现有集数:
    • 修改对应集数目录下的 meta.json
    • 运行生成脚本

该工作流将“页面/音频”的创作与“RSS 输出”的生成解耦：页面完全手工可控，RSS 由脚本一次性生成，减少重复维护与出错机会。

0%