eleventy-plugin-podcaster 0.9.3 → 0.9.4

package/docs/episode-information.md

@@ -36,6 +36,7 @@ Here's a detailed description of the data you need to provide here.
 | `title` | The title of the episode; this will also be the title of the post on the website. | yes |
 | `date` | The release date of the episode; this will also be the date of the post on the website | yes |
 | `tags` | Every episode post must have the tag `podcastEpisode` included in the `tags` array. Other tags are also permitted. | yes |
+| `guid` | A unique ID for the post. Normally this will be the post's URL, in which case there is no need to provide it here. It's should really only be necessary to provide it if you're importing the podcast from some other system that has assigned a guid to each post.  | no |
 | `episode.filename` | The filename of the episode's audio file. | yes |
 | `episode.seasonNumber` | The  season number. (Most podcasts don't group their episodes into seasons.) | no |
 | `episode.episodeNumber` | The episode number. Needn't be unique, but the combination of `seasonNumber` and `episodeNumber` must be unique. | yes |

package/docs/podcast-information.md

@@ -42,6 +42,7 @@ However, `eleventy-plugin-podcast` is quite customisable. He's another `podcast.
   "episodeUrlBase": "https://example.fte-cdn.com/",
   "feedEpisodeContentTemplate": "feed-episode-content.njk",
   "feedEpisodeDescriptionTemplate": "feed-episode-description.njk"
+  "feedEpisodeSummaryTemplate": "feed-episode-summary.njk"
 }
 ```
 
@@ -67,8 +68,28 @@ And here's a detailed description of all of this information.
 | `copyright` | The copyright owner of the podcast. If omitted, the value supplied for `author` is used instead. | no |
 | `startingYear` | The year your podcast started. Used to express the copyright date as a range (_"© 2014–2024 Flight Through Entirety"_). If this is omitted, the copyright date will just be the current year. | no |
 | `episodeUrlBase` | If you store your podcast episodes on a CDN, or if you use a podcast analytics service, this is where you specify the base URL for them. If you don't specify this, it defaults to `https://{{ podcast.siteUrl }}/episodes/` | no |
-| `feedEpisodeContentTemplate` | The name of an include template that will be used to create the show notes of each episode, as displayed in your listeners' podcast players. The content of this template should be HTML. You only need to include this if you want the show notes in podcast players to be different from the show notes on the website. | no |
-| `feedEpisodeDescriptionTemplate` | The name of an include template that will be used to create the description of each episode. The content of this template should be plain text. If it's omitted, the description will just be an abbreviated text version of the `content` of the episode's post. | no |
 
 [categories]: https://podcasters.apple.com/support/1691-apple-podcasts-categories
 [lang]: https://www.rssboard.org/rss-language-codes
+
+## Feed episode templates
+
+For each episode of the podcast, the feed can contain three textual descriptions — `content`, `description` and `summary`. `content` is HTML and will contain the show notes of an episode. `description` and `summary` are short plain text descriptions of the episode.
+
+By default, **Podcaster** will set the `content` of the feed to the `content` of an episode's post, and will set `summary` and `description` to an abbreviated version of the content (roughly the first 500 characters of the `content`). And this will be perfectly fine for most podcast feeds.
+
+However, if you want to, you can override any or all of these three textual descriptions by providing special templates in the includes directory and adding their names to the `podcast` object.
+
+| field | value | required? |
+| ----- | ----- | --------- |
+| `feedEpisodeContentTemplate` | The name of an include template that will be used to create the show notes of each episode, as displayed in your listeners' podcast players. The content of this template should be HTML. You only need to include this if you want the show notes in podcast players to be different from the show notes on the website. | no |
+| `feedEpisodeDescriptionTemplate` | The name of an include template that will be used to create the description of each episode. The content of this template should be plain text. If it's omitted, the description will just be an abbreviated text version of the `content` of the episode's post. | no |
+| `feedEpisodeSummaryTemplate` | The name of an include template that will be used to create the summary of each episode. The content of this template should be plain text. If it's omitted, the description will just be an abbreviated text version of the `content` of the episode's post. | no |
+
+These templates must be Nunjucks templates, and the post for the episode must be referred to by the variable `post`. Here's a sample content template from one of my podcast websites.
+
+```njk
+<p class="diary-date">{{ post.data.diaryDate | readableDate }}</p>
+<p class="topic">{{ post.data.topic }}</p>
+{{ post.content | safe }}
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eleventy-plugin-podcaster",
-  "version": "0.9.3",
+  "version": "0.9.4",
   "description": "An Eleventy plugin that allows you to create a podcast and its accompanying website",
   "main": "eleventy.config.js",
   "exports": {

package/src/podcastFeed.njk

@@ -52,6 +52,14 @@ eleventyAllowMissingExtension: true
       <itunes:season>{{ post.data.episode.seasonNumber }}</itunes:season>
       {%- endif %}
       <itunes:episode>{{ post.data.episode.episodeNumber }}</itunes:episode>
+      {% if podcast.feedEpisodeSummaryTemplate %}
+      {%- set episodeSummary -%}
+      {% include podcast.feedEpisodeSummaryTemplate %}
+      {%- endset -%}
+      {% else %}
+      {%- set episodeSummary = post.content | striptags(true) | truncate(500) -%}
+      {%- endif %}
+      <itunes:summary>{{ episodeSummary }}</itunes:summary>
       {% if podcast.feedEpisodeDescriptionTemplate %}
       {%- set episodeDescription -%}
       {% include podcast.feedEpisodeDescriptionTemplate %}
@@ -59,7 +67,6 @@ eleventyAllowMissingExtension: true
       {% else %}
       {%- set episodeDescription = post.content | striptags(true) | truncate(800) -%}
       {%- endif %}
-      <itunes:summary>{{ episodeDescription }}</itunes:summary>
       <description>{{ episodeDescription }}</description>
       {% if podcast.feedEpisodeContentTemplate %}
       {%- set episodeContent -%}
@@ -68,19 +75,13 @@ eleventyAllowMissingExtension: true
       {% else %}
       {%- set episodeContent = post.content -%}
       {% endif %}
-      {%- if post.data.page -%}
       <content:encoded>
         <![CDATA[{{ episodeContent | renderTransforms(post.data.page, siteUrl) | safe | trim }}]]>
       </content:encoded>
-      {%- else -%}
-      <content:encoded>
-        <![CDATA[{{ post.content | renderTransforms(post.data.page, siteUrl) | safe | trim }}]]>
-      </content:encoded>
-      {% endif %}
       <enclosure url="{{ post.data.episode.url }}" length="{{ post.data.episode.size }}" type="audio/mp3"></enclosure>
       <itunes:duration>{{ post.data.episode.duration | readableDuration }}</itunes:duration>
       {%- if post.data.guid != undefined %}
-      <guid isPermalink="false">{{ post.data.episode.guid }}</guid>
+      <guid isPermalink="false">{{ post.data.guid }}</guid>
       {% else %}
       <guid isPermalink="true">{{ post.url | htmlBaseUrl(siteUrl) }}</guid>
       {% endif -%}