kopia lustrzana https://github.com/Podcastindex-org/podcast-namespace
list mediums
rodzic
7987bbc40c
commit
1bcd05faf2
28
docs/1.0.md
28
docs/1.0.md
|
@ -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
|
||||
`<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:
|
||||
|
|
Ładowanie…
Reference in New Issue