kopia lustrzana https://github.com/Podcastindex-org/podcast-namespace
allow socialInteract in <channel> - closes #601
rodzic
5076f74d26
commit
79d44ae131
30
docs/1.0.md
30
docs/1.0.md
|
@ -901,6 +901,9 @@ The node value is a string denoting one of the following possible values:
|
||||||
version audio enclosure attached.
|
version audio enclosure attached.
|
||||||
- `blog` - Describes a feed of informally written articles. Similar to `newsletter` but more informal as in a
|
- `blog` - Describes a feed of informally written articles. Similar to `newsletter` but more informal as in a
|
||||||
traditional blog platform style.
|
traditional blog platform style.
|
||||||
|
- `publisher` - Describes a feed that links to other feeds a publisher owns using the `<podcast:remoteItem>` element.
|
||||||
|
To understand the structure of how "publisher" feeds work, please see the dedicated document
|
||||||
|
(here)[publishers/publishers.md].
|
||||||
|
|
||||||
### List Mediums
|
### List Mediums
|
||||||
In addition to the above mediums, each medium also has a counterpart "list" variant, where the original medium name
|
In addition to the above mediums, each medium also has a counterpart "list" variant, where the original medium name
|
||||||
|
@ -1157,28 +1160,29 @@ of it's purpose.
|
||||||
<br><br><br><br><!-- Tag block -->
|
<br><br><br><br><!-- Tag block -->
|
||||||
## Social Interact
|
## Social Interact
|
||||||
`<podcast:socialInteract>`<br><br>
|
`<podcast:socialInteract>`<br><br>
|
||||||
The `socialInteract` tag allows a podcaster to attach the url of a "root post" of a comment thread to an episode.
|
The `socialInteract` tag allows a podcaster to attach the url of a "root post" of a comment thread to an episode, or
|
||||||
This "root post" is treated as the canonical location of where the comments and discussion around this episode will
|
to the podcast as a whole. This "root post" is treated as the canonical location of where the comments and
|
||||||
take place. This can be thought of as the "official" social media comment space for this episode. If a protocol
|
discussion around the episode or podcast will take place. This can be thought of as the "official" social media
|
||||||
such as "activitypub" is used, or some other protocol that allows programmatic API access, these comments can be
|
comment space for the episode or podcast. If a protocol such as "activitypub" is used, or some other protocol that
|
||||||
directly pulled into the app, and replies can be posted back to the thread from the app itself.
|
allows programmatic API access, these comments can be directly pulled into the app, and replies can be posted back
|
||||||
|
to the thread from the app itself.
|
||||||
|
|
||||||
If multiple `socialInteract` tags are given for an `<item>`, the `priority` attribute is strongly recommended to
|
If multiple `socialInteract` tags are given for an `<item>` or the `<channel>`, the `priority` attribute is strongly
|
||||||
give the app an indication as to which comments to display first.
|
recommended to give the app an indication as to which comments to display first.
|
||||||
|
|
||||||
This tag can also be used as a signal to platforms and apps that the podcaster does not want public comments shown
|
This tag can also be used as a signal to platforms and apps that the podcaster does not want public comments shown
|
||||||
alongside this episode. For this purpose a `protocol` value of "disabled" can be specified, with no other
|
alongside the episode or podcast. For this purpose a `protocol` value of "disabled" can be specified, with no other
|
||||||
attributes or node value present.
|
attributes or node value present.
|
||||||
|
|
||||||
### Parent
|
### Parent
|
||||||
`<item>`
|
`<item>` or `<channel>`
|
||||||
|
|
||||||
### Count
|
### Count
|
||||||
Multiple
|
Multiple
|
||||||
|
|
||||||
### Attributes
|
### Attributes
|
||||||
- **uri** (required) The uri/url of root post comment.
|
|
||||||
- **protocol** (required) The [protocol](/socialprotocols.txt) in use for interacting with the comment root post.
|
- **protocol** (required) The [protocol](/socialprotocols.txt) in use for interacting with the comment root post.
|
||||||
|
- **uri** (required) The uri/url of root post comment.
|
||||||
- **accountId** (recommended) The account id (on the commenting platform) of the account that created this root post.
|
- **accountId** (recommended) The account id (on the commenting platform) of the account that created this root post.
|
||||||
- **accountUrl** (optional) The public url (on the commenting platform) of the account that created this root post.
|
- **accountUrl** (optional) The public url (on the commenting platform) of the account that created this root post.
|
||||||
- **priority** (optional) When multiple socialInteract tags are present, this integer gives order of priority. A
|
- **priority** (optional) When multiple socialInteract tags are present, this integer gives order of priority. A
|
||||||
|
@ -1188,8 +1192,8 @@ attributes or node value present.
|
||||||
Example (simple):
|
Example (simple):
|
||||||
```xml
|
```xml
|
||||||
<podcast:socialInteract
|
<podcast:socialInteract
|
||||||
uri="https://podcastindex.social/web/@dave/108013847520053258"
|
|
||||||
protocol="activitypub"
|
protocol="activitypub"
|
||||||
|
uri="https://podcastindex.social/web/@dave/108013847520053258"
|
||||||
accountId="@dave"
|
accountId="@dave"
|
||||||
/>
|
/>
|
||||||
```
|
```
|
||||||
|
@ -1198,15 +1202,15 @@ Example (complex):
|
||||||
```xml
|
```xml
|
||||||
<podcast:socialInteract
|
<podcast:socialInteract
|
||||||
priority="1"
|
priority="1"
|
||||||
uri="https://podcastindex.social/web/@dave/108013847520053258"
|
|
||||||
protocol="activitypub"
|
protocol="activitypub"
|
||||||
|
uri="https://podcastindex.social/web/@dave/108013847520053258"
|
||||||
accountId="@dave"
|
accountId="@dave"
|
||||||
accountUrl="https://podcastindex.social/web/@dave"
|
accountUrl="https://podcastindex.social/web/@dave"
|
||||||
/>
|
/>
|
||||||
<podcast:socialInteract
|
<podcast:socialInteract
|
||||||
priority="2"
|
priority="2"
|
||||||
uri="https://twitter.com/PodcastindexOrg/status/1507120226361647115"
|
|
||||||
protocol="twitter"
|
protocol="twitter"
|
||||||
|
uri="https://twitter.com/PodcastindexOrg/status/1507120226361647115"
|
||||||
accountId="@podcastindexorg"
|
accountId="@podcastindexorg"
|
||||||
accountUrl="https://twitter.com/PodcastindexOrg"
|
accountUrl="https://twitter.com/PodcastindexOrg"
|
||||||
/>
|
/>
|
||||||
|
|
|
@ -2,3 +2,4 @@ disabled
|
||||||
activitypub
|
activitypub
|
||||||
twitter
|
twitter
|
||||||
lightning
|
lightning
|
||||||
|
bluesky
|
Ładowanie…
Reference in New Issue