kopia lustrzana https://github.com/Podcastindex-org/podcast-namespace
formalize license tag
Dave Jones
rodzic
908b161081
commit
b6a61eaedf
86
README.md
86
README.md
|
|
@ -135,92 +135,6 @@ The following tags have been finalized ahead of formal consideration and review
|
|||
|
||||
<br>
|
||||
|
||||
### **\<podcast:trailer>** - <small>[Discussion](https://github.com/Podcastindex-org/podcast-namespace/issues/84)</small>
|
||||
|
||||
<br>
|
||||
|
||||
<b>
|
||||
|
||||
```xml
|
||||
<podcast:trailer
|
||||
url="[uri of audio/video file(string)]"
|
||||
length="[file size in bytes(number)]"
|
||||
type="[mime type(string)]"
|
||||
pubdate="[date of release(RFC 2822)]"
|
||||
season="[season number(number)]"
|
||||
>
|
||||
[Title of Trailer(string)]
|
||||
</podcast:trailer>
|
||||
```
|
||||
|
||||
</b>
|
||||
|
||||
Channel
|
||||
|
||||
(optional | multiple)
|
||||
|
||||
This element is used to define the location of an audio or video file to be used as a trailer for the entire podcast or a specific season. There can be more than one trailer present in the channel of the
|
||||
feed. If there is more than one present, the most recent one (according to it's `pubdate`) should be chosen as the preview by default within podcast apps. If the `season` attribute is present, it must be a number that matches
|
||||
the format of the `<podcast:season>` tag. So, for a podcast that has 3 published seasons, a new `<podcast:trailer season="4">` tag can be put in the channel to later be matched up with a `<podcast:season>4<podcast:season>`
|
||||
tag when it's published within a new `<item>`.
|
||||
|
||||
This element is basically just like an `<enclosure>` with the extra `pubdate` and `season` attributes added.
|
||||
|
||||
- `url` (required) This is a url that points to the audio or video file to be played.
|
||||
- `pubdate` (required) The date the trailer was published.
|
||||
- `length` (recommended) The length of the file in bytes.
|
||||
- `type` (recommended) The mime type of the file.
|
||||
- `season` (optional) If this attribute is present it specifies that this trailer is for a particular season number.
|
||||
|
||||
Example:
|
||||
```xml
|
||||
<podcast:trailer pubdate="Thu, 01 Apr 2021 08:00:00 EST" url="https://example.org/trailers/teaser" length="12345678" type="audio/mp3">Coming April 1st, 2021</podcast:trailer>
|
||||
```
|
||||
|
||||
Example with Season Linkage:
|
||||
```xml
|
||||
<podcast:trailer pubdate="Thu, 01 Apr 2021 08:00:00 EST" url="https://example.org/trailers/season4teaser" length="12345678" type="video/mp4" season="4">Season 4: Race for the Whitehouse</podcast:trailer>
|
||||
|
||||
(later matches with)
|
||||
|
||||
<podcast:season name="Race for the Whitehouse">4</podcast:season>
|
||||
```
|
||||
|
||||
<br>
|
||||
|
||||
### **\<podcast:license>** - <small>[Discussion](https://github.com/Podcastindex-org/podcast-namespace/issues/177)</small>
|
||||
|
||||
<br>
|
||||
|
||||
<b>
|
||||
|
||||
```xml
|
||||
<podcast:license
|
||||
url="[https://urlofdetailledlicense]"
|
||||
>
|
||||
[license slug(string)]
|
||||
</podcast:license>
|
||||
```
|
||||
|
||||
</b>
|
||||
|
||||
Channel or Item
|
||||
|
||||
(optional | single)
|
||||
|
||||
This element defines the license that is applied to the audio/video content of the episode or the audio/video of the podcast as a whole. The node value
|
||||
should be a lower-cased reference to a license "identifier" defined in the [SPDX License List](https://spdx.org/licenses/) file or, if it's a custom license, it
|
||||
can be a free form abbreviation of the name of the license. Custom licenses should always include a url attribute reference.
|
||||
|
||||
- `url` (optional) This is a url that points to the full license details for this license.
|
||||
|
||||
Example:
|
||||
```xml
|
||||
<podcast:license url="https://creativecommons.org/licenses/by/4.0/">cc-by-4.0</podcast:license>
|
||||
```
|
||||
|
||||
<br>
|
||||
|
||||
|
||||
### **\<podcast:alternateEnclosure>** - <small>[Discussion](https://github.com/Podcastindex-org/podcast-namespace/issues/174#issue-798007719)</small>
|
||||
<br>
|
||||
|
|
|
|||
25
docs/1.0.md
25
docs/1.0.md
|
|
@ -307,3 +307,28 @@ tag when it's published within a new `<item>`.
|
|||
|
||||
<podcast:season name="Race for the Whitehouse">4</podcast:season>
|
||||
```
|
||||
|
||||
<br><br>
|
||||
|
||||
|
||||
## License
|
||||
`<podcast:license>`
|
||||
This element defines a license that is applied to the audio/video content of a single episode, or the audio/video of the podcast as a whole. Custom licenses must always include a url attribute.
|
||||
|
||||
#### Parent
|
||||
`<channel>` or `<item>`
|
||||
|
||||
#### Count
|
||||
Single
|
||||
|
||||
#### Node Value
|
||||
The node value must be a lower-cased reference to a license "identifier" defined in the [SPDX License List](https://spdx.org/licenses/) file if the license being used is a well-known, public license. Or, if it is a custom license, it
|
||||
must be a free form abbreviation of the name of the license as you reference it publicly.
|
||||
|
||||
#### Attributes
|
||||
- **url:** (optional) This is a url that points to the full, legal language of the license being referenced. This attribute is optional for well-known public licenses. For new, or custom licenses it is required.
|
||||
|
||||
#### Examples
|
||||
`<podcast:license>cc-by-4.0</podcast:license>`
|
||||
|
||||
`<podcast:license url="https://example.org/mypodcastlicense/full.pdf">my-podcast-license-v1</podcast:license>`
|
||||
Ładowanie…
Reference in New Issue