mirror
/
podcast-namespace
kopia lustrzana https://github.com/Podcastindex-org/podcast-namespace
1
0
Forkuj 0
Kod Zgłoszenia Packages Projekty Wydania Wiki Aktywność

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ęć
Pokaż statystyki Ściągnij plik aktualizacji Ściągnij plik porównania Expand all files Collapse all files

10
README.md
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.
## 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
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
@ -63,8 +63,10 @@ this larger namespace.
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: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: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.
- **\<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
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: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

12
example.xml
Wyświetl plik

@ -55,8 +55,8 @@
<podcast:imageSmall>https://podcastindex.org/ep0003/artSm.jpg</podcast:imageSmall>
<itunes:explicit>no</itunes:explicit>
<podcast:transcript>https://podcastindex.org/ep0003/transcript.txt</podcast:transcript>
<podcast:host>Adam Curry</podcast:host>
<podcast:guest>Dave Jones</podcast:guest>
<podcast:host href="http://example.com/adamcurry" img="http://example.com/images/adamcurry.jpg">Adam Curry</podcast:host>
<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"/>
<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>
@ -75,8 +75,8 @@
<podcast:imageSmall>https://podcastindex.org/ep0002/artSm.jpg</podcast:imageSmall>
<itunes:explicit>no</itunes:explicit>
<podcast:transcript>https://podcastindex.org/ep0002/transcript.txt</podcast:transcript>
<podcast:host>Adam Curry</podcast:host>
<podcast:guest>Dave Jones</podcast:guest>
<podcast:host href="http://example.com/adamcurry" img="http://example.com/images/adamcurry.jpg">Adam Curry</podcast:host>
<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"/>
<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>
@ -96,8 +96,8 @@
<podcast:imageSmall>https://podcastindex.org/ep0001/artSm.jpg</podcast:imageSmall>
<itunes:explicit>no</itunes:explicit>
<podcast:transcript>https://podcastindex.org/ep0001/transcript.txt</podcast:transcript>
<podcast:host>Adam Curry</podcast:host>
<podcast:guest>Dave Jones</podcast:guest>
<podcast:host href="http://example.com/adamcurry" img="http://example.com/images/adamcurry.jpg">Adam Curry</podcast:host>
<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"/>
<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>