-
Notifications
You must be signed in to change notification settings - Fork 17
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
c44a053
commit 8b94c29
Showing
1 changed file
with
49 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1 +1,49 @@ | ||
# podcast-generator | ||
# Podcast Feed Generator | ||
|
||
A GitHub action to generate a podcast feed from a YAML file. YAML is much easier to read and write than XML, and this action will convert your YAML file into a valid podcast feed. | ||
## Usage | ||
|
||
### Turn on Github Pages | ||
|
||
In your repository, go to Settings > Pages and select the main branch as the source. This will create a link to your page and give all of the content in the main branch a URL. Note the URL for the next step. | ||
|
||
### Create a YAML file | ||
|
||
Create a YAML file in your repository with the following format: | ||
|
||
```yaml | ||
title: <Podcast Title> | ||
subtitle: <Podcast Subtitle> | ||
author: <Author Name> | ||
description: <Podcast Description> | ||
link: <GitHub Pages URL> | ||
image: <Artwork Location> | ||
language: <Podcast Language e.g. en-us> | ||
category: <Postcast Category e.g. Technology https://podcasters.apple.com/support/1691-apple-podcasts-categories> | ||
format: <format of files e.g. audio/mpeg> | ||
item: | ||
- title: <Podcast Episode Title> | ||
description: <Podcast Episode Description> | ||
published: <Date Published - e.g. Thu, 12 Jan 2023 18:00:00 GMT> | ||
file: <Filename e.g. /audio/TFIT01.mp3> | ||
duration: <duration e.g. 00:00:36> | ||
length: <length e.g. 576,324 (Get Info on your files)> | ||
... Repeat for each episode | ||
``` | ||
|
||
### Sample Workflow | ||
|
||
You're also going to need your own workflow file. Here's a sample: | ||
|
||
```yaml | ||
name: Generate Feed | ||
on: [push] | ||
jobs: | ||
generate-feed: | ||
runs-on: ubuntu-latest | ||
steps: | ||
- name: Checkout Repo | ||
uses: actions/checkout@v3 | ||
- name: Run Feed Generator | ||
uses: planetoftheweb/podcast-feed-generator@main | ||
``` |