diff --git a/proposal-docs/social/social.md b/proposal-docs/social/social.md index 017c179..2c6de3d 100644 --- a/proposal-docs/social/social.md +++ b/proposal-docs/social/social.md @@ -22,31 +22,41 @@ There are three elements: ### Social Element -- **\**[one or more "podcast:socialSignUp" elements]**\** +- **\**[one or more "podcast:socialSignUp" elements]**\** Channel (optional | multiple) This element allows a podcaster to specify one or more platforms where listeners can interact. There may be several occurences of this tag for the same element (on several platforms, the podcast may have several accounts on the same plaforms…) - - `platform` (required): This is the platform id. It can be one of the following: - - activitypub - - facebook - - twitter - - instagram - - slack - - discord - - xmpp - - irc - - matrix - - … - - `podcastAccountId` (required): The podcast ID on this platform. - - `podcastAccountUrl` (required): The podcast URL on this platform. + - `platform` (required): This is the platform id. It can be one of the following: + - castopod + - mastodon + - peertube + - facebook + - twitter + - instagram + - slack + - discord + - … + - `protocol` (required): This is the protocol name. It can be one of the following: + - activitypub + - xmpp + - irc + - matrix + - facebook + - twitter + - instagram + - slack + - discord + - … + - `accountId` (required): The podcast ID on this platform. + - `accountUrl` (required): The podcast URL on this platform. - `priority` (optional): This platform priority (useful if the podcaster wants to tell which platform is preferred, lower is better) Examples: - - `` - - `` + - `` + - `` ### SocialSignUp Element @@ -66,13 +76,23 @@ There are three elements: ### SocialInteract Element -- **\**[URL to this episode on this platform]**** +- **\**[URL to this episode on this platform]**** Item (optional | multiple) This element allows listeners to interact (comment, share, like…) with an episode. - `platform` (required): This is the platform id. It can be one of the following: + - castopod + - mastodon + - peertube + - facebook + - twitter + - instagram + - slack + - discord + - … + - `protocol` (required): This is the protocol name. It can be one of the following: - activitypub - facebook - twitter @@ -83,17 +103,18 @@ There are three elements: - irc - matrix - … - - `podcastAccountId` (required): The podcast ID on this platform. + - `accountId` (required): The podcast ID on this platform. - `pubDate` (optional): publication date on this platform. This can be useful when there are several interactions for the same platform for the same episode (for instance, two Tweets about the same episode). Format must be [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). - `priority` (optional): This platform priority (useful if the podcaster wants to tell which platform is preferred, lower is better) - element's content: URL to this episode on this platform Examples: - - `https://twitter.com/Podverse/status/1375624446296395781` + - `https://twitter.com/Podverse/status/1375624446296395781` + - `https://lespoesiesdheloise.fr/@heloise/notes/e4b3d7f3-e84b-40c6-b828-f5537f0c3659` ## Full RSS feed example -``` +```xml @@ -101,12 +122,15 @@ There are three elements: Les Poésies d’Héloïse […] - + - + + + + @@ -118,8 +142,8 @@ There are three elements: https://lespoesiesdheloise.fr/@heloise/episodes/oisillon-bleu […] - https://lespoesiesdheloise.fr/@heloise/notes/4ba8df51-d67d-405d-a475-6471e1235c1c - https://www.facebook.com/LesPoesiesDHeloise/posts/399766303947452 + https://lespoesiesdheloise.fr/@heloise/notes/4ba8df51-d67d-405d-a475-6471e1235c1c + https://www.facebook.com/LesPoesiesDHeloise/posts/399766303947452 […]