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
Switch to house-style Has * properties; add audio and duration; single annotation for page-valued links (via update-page on MediaWiki MCP Server) |
No edit summary |
||
| (3 intermediate revisions by one other user not shown) | |||
| Line 3: | Line 3: | ||
Template for documenting podcast episodes. Sets the semantic properties that | Template for documenting podcast episodes. Sets the semantic properties that | ||
[[Template:Firehose]] queries, so an episode recorded here shows up in every | [[Template:Firehose]] queries, so an episode recorded here shows up in every | ||
firehose that matches it — the show's page, | 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 10: | Line 11: | ||
|podcast=Bluegrass Jam Along | |podcast=Bluegrass Jam Along | ||
|title=Episode Title | |title=Episode Title | ||
| | |topic=Bronwyn Keith-Hynes | ||
| | |topic2=Tony Rice | ||
|date=2025-01-15 | |date=2025-01-15 | ||
|url=https://example.com/episode | |url=https://example.com/episode | ||
|audio=https://example.com/episode.mp3 | |audio=https://example.com/episode.mp3 | ||
|duration=3720 | |duration=3720 | ||
|image=https://example.com/episode-art.jpg | |||
|description=Brief description of the episode | |description=Brief description of the episode | ||
}} | }} | ||
| Line 23: | Line 25: | ||
* '''podcast''' - Name of the podcast. Must match the podcast's page title. | * '''podcast''' - Name of the podcast. Must match the podcast's page title. | ||
* '''title''' - Episode 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) | * '''date''' - Publication date (YYYY-MM-DD) | ||
* '''url''' - The publisher's page for the episode | * '''url''' - The publisher's page for the episode | ||
* '''audio''' - Direct audio file, from the feed's RSS enclosure | * '''audio''' - Direct audio file, from the feed's RSS enclosure | ||
* '''duration''' - Running time '''in seconds'''. Feeds publish this inconsistently; normalise before storing. | * '''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 === | === Notes === | ||
Topics are stored with [[Property:Has topic|Has topic]] rather than | |||
<code><nowiki>[[Has | [[Property:Has guest|Has guest]]. An episode title yields proper nouns without | ||
annotation. There is no need to write the link separately. | 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 40: | 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|}}}| | ||
{{!}}- | {{!}}- | ||
| Line 50: | Line 68: | ||
{{!}} [[Has air date::{{{date}}}]] | {{!}} [[Has air date::{{{date}}}]] | ||
}} | }} | ||
{{#if:{{{guest|}}}| | {{#if:{{{topic|{{{guest|}}}}}}| | ||
{{!}}- | {{!}}- | ||
! | ! About | ||
{{!}} [[Has | {{!}} [[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|}}}| | {{#if:{{{duration|}}}| | ||
{{!}}- | {{!}}- | ||
! Length | ! Length | ||
{{!}} {{#expr: | {{!}} {{#expr: {{{duration}}} / 60 round 0}} min[[Has duration::{{{duration}}}| ]] | ||
}} | }} | ||
{{#if:{{{url|}}}| | {{#if:{{{url|}}}| | ||
| Line 72: | Line 90: | ||
|} | |} | ||
{{#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.