README

The Podcast component theme for Cecil provide templates to publish an audio show on the web:

1. a RSS output for the episodes section (with a style sheet)
2. a HTML audio player with resume feature and Media Session API support

Installation

composer require cecil/theme-podcast

Or download the latest archive and uncompress its content in themes/podcast.

Usage

Add podcast in the theme section of your config.yml:

theme:
  - podcast

Add podcast configuration details in your config.yml:

podcast:
  owner:
    name: Cecil
    email: contact@cecil.app
  image: cover.png
  author: Cecil  # optional
  categories:    # https://podcasters.apple.com/support/1691-apple-podcasts-categories
    - Technology
  type: episodic # optional, "episodic" (default) or "serial"
  explicit: no   # optional
  block: no      # optional
  newfeedurl: "" # optional, the URL of the new feed in case of hosting changement

Add a Markdown file in episodes section with data (in the front matter) and description:

1.md:

---
title: "Episode X"
date: YYYY-MM-DD
episode:
  file: episode-X.mp3
  season: 0    # optional
  number: X    # optional
  type: full   # optional, "full", "trailer" or "bonus"
  explicit: no # optional
  block: no    # optional
---
Description and notes of the episode.

Add the HTML player to your episode's template:

{% include 'partials/audioplayer.html.twig' %}