Merge pull request #652 from johnspurlock/patch-9

Followup edits for `<podcast:contentLink>` change
pull/658/head
Dave Jones 2024-08-09 22:45:15 -05:00 zatwierdzone przez GitHub
commit b24ae6d0dd
Nie znaleziono w bazie danych klucza dla tego podpisu
ID klucza GPG: B5690EEEBB952194
1 zmienionych plików z 16 dodań i 10 usunięć

Wyświetl plik

@ -37,7 +37,7 @@ document in your XML:
- [Medium](#medium)
- [Images](#images)
- [Live Item](#live-item)
- [Content Link](#content-link)
- [Content Link](#content-link)
- [Social Interact](#social-interact)
- [Block](#block)
- [Txt](#txt)
@ -1125,8 +1125,8 @@ A bare bones example:
<br><br><br><br><!-- Tag block -->
## Content Link
`<podcast:contentLink>`<br><br>
The `contentLink` tag is used to indicate that the content begin delivered by the parent element can be found at an
external location instead of, or in addition to, being delivered directly to the tag itself within an app. In most
The `contentLink` tag is used to indicate that the content being delivered by the parent element can be found at an
external location instead of, or in addition to, the tag itself within an app. In most
instances it is used as a fallback link for the user to use when the app itself can't handle a certain content
delivery directly.
@ -1134,22 +1134,29 @@ For instance, perhaps a podcast feed specifies a `<podcast:liveItem>` to deliver
may also give a `<podcast:contentLink>` pointing to YouTube and Twitch versions of the live stream as well, just in
case the listener uses an app that doesn't fully support live streaming content.
Currently this tag is only indicated for use in the `<podcast:liveItem>` tag. In the future, its use will be expanded.
### Parent
&nbsp; `<podcast:item>` or `<podcast:liveItem>`
&nbsp; `<item>` or `<podcast:liveItem>`
### Count
&nbsp; Multiple
### Node Value
The node value is a free form string meant to explain to the user where this content link points and/or the nature
of it's purpose.
The node value is a free-form string meant to explain to the user where this content link points and/or the nature
of its purpose.
### Attributes
- **href** (required) A string that is the uri pointing to content outside of the application.
### Examples
(under `<item>`)
```xml
<podcast:contentLink href="https://www.youtube.com/watch?v=8c7HWZROxD8">Watch this episode on YouTube!</podcast:contentLink>
```
(under `<podcast:liveItem>`)
```xml
<podcast:contentLink href="https://youtube.com/blahblah/livestream">Live on YouTube!</podcast:contentLink>
```
@ -1159,7 +1166,6 @@ of it's purpose.
```
<br><br><br><br><!-- Tag block -->
## Social Interact
`<podcast:socialInteract>`<br><br>