pull/541/head
Dave Jones 2023-06-07 14:42:32 -05:00
rodzic 7987bbc40c
commit 1bcd05faf2
1 zmienionych plików z 16 dodań i 12 usunięć

Wyświetl plik

@ -883,12 +883,16 @@ and what it is capable of.
<br><br><br><br><!-- Tag block -->
## Medium
`<podcast:medium>`<br><br>
The `medium` tag tells the an application what the content contained within the feed IS, as opposed to what the content is ABOUT in the case of a category. This allows a podcast app to
modify it's behavior or UI to give a better experience to the user for this content. For example, if a podcast has `<podcast:medium>music</podcast:medium>` an app may choose to
reset playback speed to 1x and adjust it's EQ settings to be better for music vs. spoken word.
The `medium` tag tells an application what the content contained within the feed IS, as opposed to what the
content is ABOUT in the case of a category. This allows a podcast app to modify it's behavior or UI to give a
better experience to the user for this content. For example, if a podcast has
`<podcast:medium>music</podcast:medium>` an app may choose to reset playback speed to 1x and adjust it's EQ settings
to be better for music vs. spoken word.
Accepted medium names are curated within a list maintained by the community as new mediums are discovered over time. Newly proposed mediums should require some level of
justification to be added to this list. One may argue and/or prove use of a new medium even for only one application, should it prove different enough from existing mediums to have meaning.
Accepted medium names are curated within a list maintained by the community as new mediums are discovered over time.
Newly proposed mediums should require some level of justification to be added to this list. One may argue and/or
prove use of a new medium even for only one application, should it prove different enough from existing mediums to
have meaning.
### Parent
&nbsp; `<channel>`
@ -911,19 +915,19 @@ The node value is a string denoting one of the following possible values:
- `blog` - Describes a feed of informally written articles. Similar to `newsletter` but more informal as in a
traditional blog platform style.
### Lists
In addition to the above mediums, each medium also has a counterpart "list" variant, where the original medium name is
suffixed by the letter "L" to indicate that it is a "List" of that type of content. For example, `podcast` would become
`podcastL`, `music` would become `musicL`, `audiobook` would become `audiobookL`, etc.
### List Mediums
In addition to the above mediums, each medium also has a counterpart "list" variant, where the original medium name
is suffixed by the letter "L" to indicate that it is a "List" of that type of content. For example, `podcast` would
become `podcastL`, `music` would become `musicL`, `audiobook` would become `audiobookL`, etc.
There is also a dedicated list medium for mixed content:
- `mixed` - This list medium type describes a feed of `<podcast:remoteItem>`'s that point to different remote medium
types. For instance, a single list feed might point to music, podcast and audiobook items in other feeds. An
example would be a personal consumption history feed.
These "list" medium feeds are expected to have no regular `<item>`, nor `<podcast:liveItem>`, nor any future similar new
item type. Rather, "List" mediums are intended to exclusively contain one or more `<podcast:remoteItem>`'s, allowing
one to reference a feed by its `<podcast:guid>` and the guid of an item.
A "list" medium feed should not be expected to have regular `<item>`'s,`<podcast:liveItem>`'s, or any future
similar new item type. Rather, a "List" feed is intended to exclusively contain one or more `<podcast:remoteItem>`'s,
allowing one to reference a feed by its `<podcast:guid>` and the guid of an item.
### Examples
Example use for a standard "podcast" feed: