kopia lustrzana https://github.com/Podcastindex-org/podcast-namespace
publisher feeds initial draft
Dave Jones
rodzic
807eb94863
commit
3225ccaa35
|
|
@ -0,0 +1,96 @@
|
||||||
|
## Publisher medium details
|
||||||
|
|
||||||
|
Below, you will find implementation details about using the `publisher` value in the `<podcast:medium>` tag to
|
||||||
|
create "publisher feeds".
|
||||||
|
|
||||||
|
<br>
|
||||||
|
|
||||||
|
### Overview
|
||||||
|
|
||||||
|
The idea of a "publisher" is that a single entity (person, organization, record label, etc) might be the responsible
|
||||||
|
party which produces multiple podcast feeds. In such a case it would be useful to be able to see all of a
|
||||||
|
publisher's podcasts collected in a single place. For instance, a news organization might produce 12 different
|
||||||
|
podcast feeds. Or, a music artist might produce 3 albums of music using the `<podcast:medium>` tag of `music`. In
|
||||||
|
those cases, having a high level feed that references these other feeds would make it easier for podcast apps to
|
||||||
|
associate those feeds with a particular publishing entity.
|
||||||
|
|
||||||
|
Likewise, it is helpful if the produced feeds link back to the "publisher feed" so that podcast apps can walk back
|
||||||
|
up the chain from a podcast feed to it's publisher in order to find other relevant content from that publishing
|
||||||
|
entity. For instance, a listener may subscribe to a music album by an artist and want to find their other
|
||||||
|
albums and singles.
|
||||||
|
|
||||||
|
When a publisher feed links to it's "child" feeds, and those "child" feeds link back to their "parent" publisher
|
||||||
|
feeds, this provides a two-way validation that a feed is indeed a valid part of a publishing entities portfolio of
|
||||||
|
content. If a feed links to a publisher feed without the publisher feed referencing it, that association should be
|
||||||
|
discarded.
|
||||||
|
|
||||||
|
<br>
|
||||||
|
|
||||||
|
### Publisher Feed Requirements
|
||||||
|
|
||||||
|
A publisher feed must have the following parts:
|
||||||
|
|
||||||
|
1. A `<podcast:medium>` tag with a value of `publisher`.
|
||||||
|
2. A valid `<podcast:guid>`.
|
||||||
|
3. One or more `<podcast:remoteItem>` tags that link to podcast feeds.
|
||||||
|
|
||||||
|
#### Example
|
||||||
|
|
||||||
|
The following example shows a publisher feed that links to all of the feeds published by the "AgileSet Media" entity.
|
||||||
|
This feed also makes use of the `<podcast:person>` tag to define a responsible person at the publishing entity.
|
||||||
|
|
||||||
|
```xml
|
||||||
|
<rss xmlns:podcast="https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md" version="2.0">
|
||||||
|
<channel>
|
||||||
|
<title>AgileSet Media</title>
|
||||||
|
<link>https://agilesetmedia.com</link>
|
||||||
|
<description>AgileSet Media is an unincorporated, unregistered, and unpapered entity of AgileSet LLC for producing and publishing stuff by Mike Neumann. It is based in Texas, USA.</description>
|
||||||
|
<image>
|
||||||
|
<url>https://agilesetmedia.com/assets/static/AgileSet-logo-square-sm-144.png</url>
|
||||||
|
<title>AgileSet Media</title>
|
||||||
|
<link>https://agilesetmedia.com</link>
|
||||||
|
<width>144</width>
|
||||||
|
<height>144</height>
|
||||||
|
</image>
|
||||||
|
<podcast:person href="https://mikeneumann.net" group="Creative Direction" role="Director" img="https://itsamood.org/assets/static/MikeNeumann_202310.jpg">Mike Neumann</podcast:person>
|
||||||
|
<podcast:guid>003af0a0-6a45-55bf-b765-68e3d349551a</podcast:guid>
|
||||||
|
<podcast:medium>publisher</podcast:medium>
|
||||||
|
<podcast:remoteItem medium="podcast" feedGuid="469b403f-db2d-574c-9db9-96dbb3f6561c" feedUrl="https://itsamood.org/itsamoodrss.xml"/>
|
||||||
|
<podcast:remoteItem medium="podcast" feedGuid="72816866-317e-5e48-8895-8193d58e5b57" feedUrl="https://mikesmixtape.com/mikesmixtaperss.xml"/>
|
||||||
|
<podcast:remoteItem medium="podcast" feedGuid="7a2d292c-8656-5fcf-88d2-31b10e54d7c7" feedUrl="https://mikeneumann.show/themnshowrss.xml"/>
|
||||||
|
</channel>
|
||||||
|
</rss>
|
||||||
|
```
|
||||||
|
|
||||||
|
<br>
|
||||||
|
|
||||||
|
### Linking to Publisher Feeds
|
||||||
|
|
||||||
|
While not strictly required, adding a reference to the publisher feed from the "child" feeds is a good idea, as it
|
||||||
|
makes discovery of your other content much easier. Podcast apps can see this linkage and "walk back up the chain"
|
||||||
|
to your publisher feed and then recommend your other podcast content to a listener.
|
||||||
|
|
||||||
|
#### Example
|
||||||
|
|
||||||
|
The following example snippet shows a podcast feed produced by "AgileSet Media" that links to the publisher feed
|
||||||
|
example above.
|
||||||
|
|
||||||
|
```xml
|
||||||
|
<rss xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:podcast="https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md" version="2.0">
|
||||||
|
<channel>
|
||||||
|
<title><![CDATA[It's A Mood]]></title>
|
||||||
|
<description>A value4value happenstance music show.</description>
|
||||||
|
<link>https://itsamood.org</link>
|
||||||
|
<generator>Sovereign Feeds</generator>
|
||||||
|
<podcast:person href="https://mikeneumann.net" group="cast" role="host" img="https://itsamood.org/assets/static/MikeNeumann_202310.jpg">Mike Neumann</podcast:person>
|
||||||
|
<podcast:guid>469b403f-db2d-574c-9db9-96dbb3f6561c</podcast:guid>
|
||||||
|
<podcast:medium>podcast</podcast:medium>
|
||||||
|
<podcast:remoteItem medium="publisher" feedGuid="003af0a0-6a45-55bf-b765-68e3d349551a" feedUrl="https://agilesetmedia.com/assets/static/feeds/publisher.xml"/>
|
||||||
|
<item>
|
||||||
|
<title><![CDATA[Runnin']]></title>
|
||||||
|
<pubDate>Wed, 03 Apr 2024 02:06:28 +0000</pubDate>
|
||||||
|
...
|
||||||
|
</item>
|
||||||
|
</channel>
|
||||||
|
</rss>
|
||||||
|
```
|
||||||
Ładowanie…
Reference in New Issue