愆伏

互联网杂谈

播客系统使用说明

系统概述

这是一个数据驱动的播客管理系统，通过YAML数据文件和Node.js脚本自动生成RSS和播客列表页面。

文件结构

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
source/
├── _data/
│   └── podcast.yml                    # 播客数据文件
├── podcast/
│   ├── index.md                       # 播客列表页面（自动生成）
│   ├── episodes/                      # 播客集数文件夹
│   │   ├── episode-01-*/
│   │   │   ├── index.html            # 播客详情页面
│   │   │   └── audio.mp3             # 音频文件
│   │   └── episode-02-*/
│   │       ├── index.html
│   │       └── audio.mp3
│   └── README.md                      # 本文件
├── podcast.xml                        # RSS文件（自动生成）
└── assets/images/
    └── podcast-cover.jpg              # 播客封面图片（需要手动添加）

scripts/
├── generate-podcast-content.js        # 主要生成脚本
└── generate-podcast-rss.js           # 旧的RSS生成脚本

使用方法

1. 添加新播客集数

编辑 source/_data/podcast.yml 文件：

1
2
3
4
5
6
7
8
9
episodes:
  - number: 3                          # 新集数编号
    title: "新播客标题"
    subtitle: "副标题"
    description: "详细描述..."
    folder: "episode-03-folder-name"   # 文件夹名称
    duration: "00:10:00"               # 时长
    date: "2025-05-29"                 # 发布日期
    keywords: "关键词1,关键词2"

2. 创建播客文件夹

在 source/podcast/episodes/ 下创建新文件夹： - 文件夹名称与YAML中的 folder 字段一致 - 包含 index.html（播客详情页面） - 包含 audio.mp3（音频文件）

3. 生成RSS和列表页面

运行生成脚本：

1
node scripts/generate-podcast-content.js

4. 重新生成站点

1
hexo clean && hexo generate

自动化功能

✅ 已实现

  • 数据驱动: 通过YAML文件管理播客信息
  • 自动生成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
    • 格式: MP3
    • 质量: 建议 128kbps 或更高
  3. 播客详情页面: 每集的 index.html
    • 包含播客播放器
    • 包含返回导航链接

🔧 配置文件

  • _config.yml: 确保skip_render包含 podcast.xml
  • source/_data/podcast.yml: 播客数据配置

维护工作流

  1. 添加新集数:
    • 更新 podcast.yml
    • 创建集数文件夹和文件
    • 运行生成脚本
    • 重新生成站点
  2. 修改播客信息:
    • 编辑 podcast.yml 中的 info 部分
    • 运行生成脚本
  3. 更新现有集数:
    • 修改 podcast.yml 中对应集数信息
    • 运行生成脚本

这个系统确保了播客内容的一致性和可维护性，同时支持标准的播客发布流程。

0%