Template:PodcastEpisode: Difference between revisions

From PickiPedia: A knowledge base of bluegrass, old time psychedelic jams, and other public domain music
Jump to navigationJump to search
Magent (talk | contribs)
Create PodcastEpisode template for semantic tagging of podcast guests (via create-page on MediaWiki MCP Server)
 
No edit summary
 
(4 intermediate revisions by one other user not shown)
Line 1: Line 1:
<noinclude>
<noinclude>
== Podcast Episode ==
== Podcast Episode ==
Template for documenting podcast episodes. Sets semantic properties for guests and episode metadata.
Template for documenting podcast episodes. Sets the semantic properties that
[[Template:Firehose]] queries, so an episode recorded here shows up in every
firehose that matches it — the show's page, the front page, and the page of
every person, band or place the episode is about.


=== Usage ===
=== Usage ===
Line 8: Line 11:
|podcast=Bluegrass Jam Along
|podcast=Bluegrass Jam Along
|title=Episode Title
|title=Episode Title
|guest=Guest Name
|topic=Bronwyn Keith-Hynes
|guest2=Second Guest
|topic2=Tony Rice
|guest3=Third Guest
|date=2025-01-15
|date=2025-01-15
|url=https://example.com/episode
|url=https://example.com/episode
|audio=https://example.com/episode.mp3
|duration=3720
|image=https://example.com/episode-art.jpg
|description=Brief description of the episode
|description=Brief description of the episode
}}
}}
Line 18: Line 23:


=== Parameters ===
=== Parameters ===
* '''podcast''' - Name of the podcast (links to podcast page)
* '''podcast''' - Name of the podcast. Must match the podcast's page title.
* '''title''' - Episode title
* '''title''' - Episode title
* '''guest''' through '''guest5''' - Guest name(s), linked to wiki pages
* '''topic''' through '''topic5''' - What the episode is about: a person, a band, a festival, a tune. Give the subject's wiki page title where one exists; a name with no page becomes a redlink, which is the invitation to write it.
* '''guest''' through '''guest5''' - Accepted as aliases for the topic parameters.
* '''date''' - Publication date (YYYY-MM-DD)
* '''date''' - Publication date (YYYY-MM-DD)
* '''url''' - Direct link to the episode
* '''url''' - The publisher's page for the episode
* '''audio''' - Direct audio file, from the feed's RSS enclosure
* '''duration''' - Running time '''in seconds'''. Feeds publish this inconsistently; normalise before storing.
* '''image''' - Artwork, as a URL ending in .jpg, .png or .gif: the episode's own picture if the feed has one, otherwise the show's cover. A URL that does not end that way shows as a link instead of a picture.
* '''description''' - Episode description or summary
* '''description''' - Episode description or summary
=== Notes ===
Topics are stored with [[Property:Has topic|Has topic]] rather than
[[Property:Has guest|Has guest]]. An episode title yields proper nouns without
saying what kind of thing each one is, or whether the named party appeared or
was only discussed — and asserting that somebody was a guest when the episode
merely discussed them puts a false claim on their page. Recording a topic is
true in both cases.
Topics and the podcast are stored with page-valued properties, so
<code><nowiki>[[Has topic::Name]]</nowiki></code> both renders the link and
records the annotation. There is no need to write the link separately.
The artwork is shown from the publisher's host rather than uploaded, and is
sized by the <code>pp-episode-art</code> rule in [[MediaWiki:Common.css]].


[[Category:Infobox templates]]
[[Category:Infobox templates]]
Line 30: Line 54:
|-
|-
! colspan="2" style="background: #9b8; font-size: 1.2em; padding: 0.3em;" | {{#if:{{{title|}}}|{{{title}}}|{{PAGENAME}}}}
! colspan="2" style="background: #9b8; font-size: 1.2em; padding: 0.3em;" | {{#if:{{{title|}}}|{{{title}}}|{{PAGENAME}}}}
{{#if:{{{image|}}}|
{{!}}-
{{!}} colspan="2" style="text-align: center; padding: 0.5em;" {{!}} <div class="pp-episode-art pp-episode-art--large">{{{image}}}</div>[[Has image url::{{{image}}}| ]]
}}
{{#if:{{{podcast|}}}|
{{#if:{{{podcast|}}}|
{{!}}-
{{!}}-
! Podcast
! Podcast
{{!}} [[{{{podcast}}}]][[podcast::{{{podcast}}}| ]]
{{!}} [[Has podcast::{{{podcast}}}]]
}}
}}
{{#if:{{{date|}}}|
{{#if:{{{date|}}}|
{{!}}-
{{!}}-
! Date
! Date
{{!}} {{{date}}}[[air_date::{{{date}}}| ]]
{{!}} [[Has air date::{{{date}}}]]
}}
}}
{{#if:{{{guest|}}}|
{{#if:{{{topic|{{{guest|}}}}}}|
{{!}}-
{{!}}-
! Guest(s)
! About
{{!}} [[{{{guest}}}]][[guest::{{{guest}}}| ]]{{#if:{{{guest2|}}}|, [[{{{guest2}}}]][[guest::{{{guest2}}}| ]]}}{{#if:{{{guest3|}}}|, [[{{{guest3}}}]][[guest::{{{guest3}}}| ]]}}{{#if:{{{guest4|}}}|, [[{{{guest4}}}]][[guest::{{{guest4}}}| ]]}}{{#if:{{{guest5|}}}|, [[{{{guest5}}}]][[guest::{{{guest5}}}| ]]}}
{{!}} [[Has topic::{{{topic|{{{guest}}}}}}]]{{#if:{{{topic2|{{{guest2|}}}}}}|, [[Has topic::{{{topic2|{{{guest2}}}}}}]]}}{{#if:{{{topic3|{{{guest3|}}}}}}|, [[Has topic::{{{topic3|{{{guest3}}}}}}]]}}{{#if:{{{topic4|{{{guest4|}}}}}}|, [[Has topic::{{{topic4|{{{guest4}}}}}}]]}}{{#if:{{{topic5|{{{guest5|}}}}}}|, [[Has topic::{{{topic5|{{{guest5}}}}}}]]}}
}}
{{#if:{{{duration|}}}|
{{!}}-
! Length
{{!}} {{#expr: {{{duration}}} / 60 round 0}} min[[Has duration::{{{duration}}}| ]]
}}
}}
{{#if:{{{url|}}}|
{{#if:{{{url|}}}|
{{!}}-
{{!}}-
! Link
! Link
{{!}} [{{{url}}} Listen][[episode_url::{{{url}}}| ]]
{{!}} [{{{url}}} Listen][[Has episode url::{{{url}}}| ]]
}}
{{#if:{{{audio|}}}|
{{!}}-
! Audio
{{!}} [{{{audio}}} Audio file][[Has audio url::{{{audio}}}| ]]
}}
}}
|}
|}
{{#if:{{{description|}}}|
{{#if:{{{description|}}}|
==Episode Description==
{{{description}}}
{{{description}}}



Latest revision as of 22:10, 15 September 2026

Podcast Episode

Template for documenting podcast episodes. Sets the semantic properties that Template:Firehose queries, so an episode recorded here shows up in every firehose that matches it — the show's page, the front page, and the page of every person, band or place the episode is about.

Usage

{{PodcastEpisode
|podcast=Bluegrass Jam Along
|title=Episode Title
|topic=Bronwyn Keith-Hynes
|topic2=Tony Rice
|date=2025-01-15
|url=https://example.com/episode
|audio=https://example.com/episode.mp3
|duration=3720
|image=https://example.com/episode-art.jpg
|description=Brief description of the episode
}}

Parameters

  • podcast - Name of the podcast. Must match the podcast's page title.
  • title - Episode title
  • topic through topic5 - What the episode is about: a person, a band, a festival, a tune. Give the subject's wiki page title where one exists; a name with no page becomes a redlink, which is the invitation to write it.
  • guest through guest5 - Accepted as aliases for the topic parameters.
  • date - Publication date (YYYY-MM-DD)
  • url - The publisher's page for the episode
  • audio - Direct audio file, from the feed's RSS enclosure
  • duration - Running time in seconds. Feeds publish this inconsistently; normalise before storing.
  • image - Artwork, as a URL ending in .jpg, .png or .gif: the episode's own picture if the feed has one, otherwise the show's cover. A URL that does not end that way shows as a link instead of a picture.
  • description - Episode description or summary

Notes

Topics are stored with Has topic rather than Has guest. An episode title yields proper nouns without saying what kind of thing each one is, or whether the named party appeared or was only discussed — and asserting that somebody was a guest when the episode merely discussed them puts a false claim on their page. Recording a topic is true in both cases.

Topics and the podcast are stored with page-valued properties, so [[Has topic::Name]] both renders the link and records the annotation. There is no need to write the link separately.

The artwork is shown from the publisher's host rather than uploaded, and is sized by the pp-episode-art rule in MediaWiki:Common.css.