add attributes to podcast:guest|host - #8

pull/15/head
Dave Jones 2020-10-10 22:15:00 -05:00
rodzic 9cb39d9894
commit 0cfe620caf
2 zmienionych plików z 12 dodań i 10 usunięć

Wyświetl plik

@ -12,11 +12,11 @@ There is significant overlap amongst the many existing podcast namespaces. Each
system and audience the metadata they need in the way they want it delivered. system and audience the metadata they need in the way they want it delivered.
## Goal #2 - Avoid Attributes ## Goal #2 - Avoid Attributes and sub-elements
Attributes in xml elements should be used only where absolutely needed. The preference is to create a new element type, rather than reuse the same element with Attributes in xml elements should be used only where absolutely needed. The preference is to create a new element type, rather than reuse the same element with
different attributes. For example, instead of using **\<podcast:image type="Large">**, we would use **\<podcast:imageLarge>**. This makes the corresponding different attributes. For example, instead of using **\<podcast:image type="Large">**, we would use **\<podcast:imageLarge>**. This makes the corresponding
aggregator code easier and more linear. aggregator code easier and more linear. Sub-elements should be avoided if at all possible.
## Goal #3 - Use RSS Native Elements ## Goal #3 - Use RSS Native Elements
@ -63,8 +63,10 @@ this larger namespace.
to itself as a confirmation to aggregators that they now have the most current url. to itself as a confirmation to aggregators that they now have the most current url.
- **\<podcast:id platform="[service slug]">**[the id string]**\</podcast:id>** (optional|multiple) - This is a channel-level element. See "ID's" in this document for an explanation. - **\<podcast:id platform="[service slug]">**[the id string]**\</podcast:id>** (optional|multiple) - This is a channel-level element. See "ID's" in this document for an explanation.
- **\<podcast:host>**[A person's name]**\</podcast:host>** - This is an item-level element. It gives the name of a person hosting this episode if appropriate. Multiple of these can be specified. - **\<podcast:host href="[url of bio/wiki/blog/etc.]" img="[link to image/headshot]">**[name of person]**\</podcast:host>** (optional|multiple) - This is an item-level element. It identifies a host
- **\<podcast:guest>**[A person's name]**\</podcast:guest>** - This is an item-level element. It gives the name of a person who is a guest on an episode. Multiple of these can be specified. of a podcast episode. All other attributes are optional but recommended for disambiguation and good meta-data for apps.
- **\<podcast:guest href="[url of bio/wiki/blog/etc.]" img="[link to image/headshot]">**[name of person]**\</podcast:guest>** (optional|multiple) - This is an item-level element. It identifies a guest
in a podcast episode. All other attributes are optional but recommended for disambiguation and good meta-data for apps.
- **\<podcast:contentRating>**[rating letter]**\</podcast:contentRating>** - This is a channel, or item-level element specifying a generally accepted rating letter of G, PG, PG-13, R or X. - **\<podcast:contentRating>**[rating letter]**\</podcast:contentRating>** - This is a channel, or item-level element specifying a generally accepted rating letter of G, PG, PG-13, R or X.
- **\<podcast:transcript language="[language code]" type="[mime type]">**[url to a file or website]**\</podcast:transcript>** - This is an item-level element. Links to an external file containing a transcript. The - **\<podcast:transcript language="[language code]" type="[mime type]">**[url to a file or website]**\</podcast:transcript>** - This is an item-level element. Links to an external file containing a transcript. The

Wyświetl plik

@ -55,8 +55,8 @@
<podcast:imageSmall>https://podcastindex.org/ep0003/artSm.jpg</podcast:imageSmall> <podcast:imageSmall>https://podcastindex.org/ep0003/artSm.jpg</podcast:imageSmall>
<itunes:explicit>no</itunes:explicit> <itunes:explicit>no</itunes:explicit>
<podcast:transcript>https://podcastindex.org/ep0003/transcript.txt</podcast:transcript> <podcast:transcript>https://podcastindex.org/ep0003/transcript.txt</podcast:transcript>
<podcast:host>Adam Curry</podcast:host> <podcast:host href="http://example.com/adamcurry" img="http://example.com/images/adamcurry.jpg">Adam Curry</podcast:host>
<podcast:guest>Dave Jones</podcast:guest> <podcast:guest href="http://example.com/davejones" img="http://example.com/images/davejones.jpg">Dave Jones</podcast:guest>
<enclosure url="https://mp3s.nashownotes.com/PC20-03-2020-09-18-Final.mp3" length="62407829" type="audio/mpeg"/> <enclosure url="https://mp3s.nashownotes.com/PC20-03-2020-09-18-Final.mp3" length="62407829" type="audio/mpeg"/>
<podcast:alternateEnclosure type="audio/x-m4a" length="1540076" bitrate="80" title="Audio - low bitrate">https://podcastindex.org/ep0003/audio/podnews201009.m4a</podcast:alternateEnclosure> <podcast:alternateEnclosure type="audio/x-m4a" length="1540076" bitrate="80" title="Audio - low bitrate">https://podcastindex.org/ep0003/audio/podnews201009.m4a</podcast:alternateEnclosure>
<podcast:alternateEnclosure type="audio/mpeg" length="2534548" bitrate="160" title="Audio - high bitrate">https://podcastindex.org/ep0003/audio/podnews201009.mp3</podcast:alternateEnclosure> <podcast:alternateEnclosure type="audio/mpeg" length="2534548" bitrate="160" title="Audio - high bitrate">https://podcastindex.org/ep0003/audio/podnews201009.mp3</podcast:alternateEnclosure>
@ -75,8 +75,8 @@
<podcast:imageSmall>https://podcastindex.org/ep0002/artSm.jpg</podcast:imageSmall> <podcast:imageSmall>https://podcastindex.org/ep0002/artSm.jpg</podcast:imageSmall>
<itunes:explicit>no</itunes:explicit> <itunes:explicit>no</itunes:explicit>
<podcast:transcript>https://podcastindex.org/ep0002/transcript.txt</podcast:transcript> <podcast:transcript>https://podcastindex.org/ep0002/transcript.txt</podcast:transcript>
<podcast:host>Adam Curry</podcast:host> <podcast:host href="http://example.com/adamcurry" img="http://example.com/images/adamcurry.jpg">Adam Curry</podcast:host>
<podcast:guest>Dave Jones</podcast:guest> <podcast:guest href="http://example.com/davejones" img="http://example.com/images/davejones.jpg">Dave Jones</podcast:guest>
<enclosure url="https://mp3s.nashownotes.com/PC20-02-2020-09-11-Final.mp3" length="59902895" type="audio/mpeg"/> <enclosure url="https://mp3s.nashownotes.com/PC20-02-2020-09-11-Final.mp3" length="59902895" type="audio/mpeg"/>
<podcast:alternateEnclosure type="audio/x-m4a" length="1540076" bitrate="80" title="Audio - low bitrate">https://podcastindex.org/ep0002/audio/podnews201009.m4a</podcast:alternateEnclosure> <podcast:alternateEnclosure type="audio/x-m4a" length="1540076" bitrate="80" title="Audio - low bitrate">https://podcastindex.org/ep0002/audio/podnews201009.m4a</podcast:alternateEnclosure>
<podcast:alternateEnclosure type="audio/mpeg" length="2534548" bitrate="160" title="Audio - high bitrate">https://podcastindex.org/ep0002/audio/podnews201009.mp3</podcast:alternateEnclosure> <podcast:alternateEnclosure type="audio/mpeg" length="2534548" bitrate="160" title="Audio - high bitrate">https://podcastindex.org/ep0002/audio/podnews201009.mp3</podcast:alternateEnclosure>
@ -96,8 +96,8 @@
<podcast:imageSmall>https://podcastindex.org/ep0001/artSm.jpg</podcast:imageSmall> <podcast:imageSmall>https://podcastindex.org/ep0001/artSm.jpg</podcast:imageSmall>
<itunes:explicit>no</itunes:explicit> <itunes:explicit>no</itunes:explicit>
<podcast:transcript>https://podcastindex.org/ep0001/transcript.txt</podcast:transcript> <podcast:transcript>https://podcastindex.org/ep0001/transcript.txt</podcast:transcript>
<podcast:host>Adam Curry</podcast:host> <podcast:host href="http://example.com/adamcurry" img="http://example.com/images/adamcurry.jpg">Adam Curry</podcast:host>
<podcast:guest>Dave Jones</podcast:guest> <podcast:guest href="http://example.com/davejones" img="http://example.com/images/davejones.jpg">Dave Jones</podcast:guest>
<enclosure url="https://mp3s.nashownotes.com/PC20-01-2020-08-28-Final.mp3" length="61222288" type="audio/mpeg"/> <enclosure url="https://mp3s.nashownotes.com/PC20-01-2020-08-28-Final.mp3" length="61222288" type="audio/mpeg"/>
<podcast:alternateEnclosure type="audio/x-m4a" length="1540076" bitrate="80" title="Audio - low bitrate">https://podcastindex.org/ep0001/audio/podnews201009.m4a</podcast:alternateEnclosure> <podcast:alternateEnclosure type="audio/x-m4a" length="1540076" bitrate="80" title="Audio - low bitrate">https://podcastindex.org/ep0001/audio/podnews201009.m4a</podcast:alternateEnclosure>
<podcast:alternateEnclosure type="audio/mpeg" length="2534548" bitrate="160" title="Audio - high bitrate">https://podcastindex.org/ep0001/audio/podnews201009.mp3</podcast:alternateEnclosure> <podcast:alternateEnclosure type="audio/mpeg" length="2534548" bitrate="160" title="Audio - high bitrate">https://podcastindex.org/ep0001/audio/podnews201009.mp3</podcast:alternateEnclosure>