kopia lustrzana https://github.com/snarfed/bridgy-fed
revise docs for activitypub vs ostatus, etc
Ryan Barrett
rodzic
1f977a7d5c
commit
670ece3fc6
10
README.md
10
README.md
|
|
@ -88,8 +88,10 @@ Here are in progress notes on how I'm testing interoperability with various fede
|
|||
* Tried posting a bunch of ways, couldn't get any to work :/
|
||||
* [Kroeg](https://github.com/puckipedia/Kroeg)
|
||||
* Not open to other users yet. Seems to be running at [puckipedia.com/social](https://puckipedia.com/social).
|
||||
* [Pleroma](https://pleroma.social/)
|
||||
* [snarfed@cawfee.club](https://cawfee.club/snarfed)
|
||||
|
||||
### Salmon
|
||||
### OStatus / Salmon
|
||||
|
||||
* [Friendica](http://friendi.ca/)
|
||||
* [snarfed@libranet.de](https://libranet.de/profile/snarfed)
|
||||
|
|
@ -105,12 +107,6 @@ Here are in progress notes on how I'm testing interoperability with various fede
|
|||
* Only has Atom `link rel="alternate"` for [full feed](https://lastauth.com/feed/snarfed?f=&top=1), not individual post :/
|
||||
* Atom feed has Salmon link rels inside top level `feed`, not in individual `entry`s
|
||||
* Atom entries have `author.name` as username (snarfed)
|
||||
* [Mastodon](https://joinmastodon.org/)
|
||||
* [snarfed@mastodon.technology](https://mastodon.technology/@snarfed)
|
||||
* Example post: [HTML](https://mastodon.technology/@snarfed/2604611), [Atom](https://mastodon.technology/users/snarfed/updates/73978.atom)
|
||||
* Profile HTML/Atom have Salmon link rel. Individual post HTML/Atom don't. `author.email` is snarfed@mastodon.technology
|
||||
* [Pleroma](https://pleroma.social/)
|
||||
* [snarfed@cawfee.club](https://cawfee.club/snarfed)
|
||||
|
||||
Stats
|
||||
---
|
||||
|
|
|
|||
|
|
@ -48,8 +48,8 @@ and the rest of the <a href="https://en.wikipedia.org/wiki/Fediverse">fediverse<
|
|||
<ul>
|
||||
<li><a href="#work">How does it work?</a></li>
|
||||
<li><a href="#sites">Which sites are supported?</a></li>
|
||||
<li><a href="#setup">How do I set it up?</a></li>
|
||||
<li><a href="#use">How do I use it?</a></li>
|
||||
<li><a href="#setup">How do I set it up?</a></li>
|
||||
<li><a href="#image">How do I include an image in a post?</a></li>
|
||||
<li><a href="#discovery">How can people on the fediverse find me?</a></li>
|
||||
<li><a href="#troubleshooting">I tried it, and it didn't work!</a></li>
|
||||
|
|
@ -96,11 +96,41 @@ We're aware of the sites below, and we've made progress on some, but they're not
|
|||
<li><em><a href="https://github.com/snarfed/bridgy-fed/issues/9">Friendica</a></em>, via OStatus.</li>
|
||||
<li><em><a href="https://github.com/snarfed/bridgy-fed/issues/8">GNU Social</a></em> (née StatusNet), via OStatus.</li>
|
||||
<li><em><a href="https://github.com/snarfed/bridgy-fed/issues/11">MediaGoblin</a></em>, via ActivityPub?</li>
|
||||
<li><em><a href="https://github.com/snarfed/bridgy-fed/issues/12">Pleroma</a></em>, via OStatus.</li>
|
||||
<li><em><a href="https://github.com/snarfed/bridgy-fed/issues/12">Pleroma</a></em>, via ActivityPub.</li>
|
||||
<li><em><a href="https://github.com/snarfed/bridgy-fed/issues/10">postActiv</a></em>, via ActivityPub or OStatus.</li>
|
||||
</ul>
|
||||
</li>
|
||||
|
||||
<li id="use" class="question">How do I use it?</li>
|
||||
<li class="answer">
|
||||
|
||||
<p>
|
||||
Federated social network identities take the form <code>@username@example.com</code>, like an email address with a leading <code>@</code>. Your site's identity via Bridgy Fed will be <code>@yourdomain.com@yourdomain.com</code>. Once you've <a href="#setup">set up Atom on your site</a>, people can follow you at that address.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
Most fedsocnets also publish Atom themselves, so you can add profile URLs like <a href="https://mastodon.technology/@snarfed">mastodon.technology/@snarfed</a> to your <a href="https://indieweb.org/reader">reader</a> and see their posts there too.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
To use it, first <a href="#setup">set up your site</a>, then create an IndieWeb <a href="https://indieweb.org/post">post</a>, <a href="https://indieweb.org/like">like</a>, <a href="https://indieweb.org/repost">repost</a>, <a href="https://indieweb.org/reply">reply</a>, or <a href="https://indieweb.org/follow">follow</a> as usual, and include a link to <code><a href="https://fed.brid.gy/">https://fed.brid.gy/</a></code> in that post. Your web server should then <a href="#setup">send Bridgy Fed a webmention</a>, which it will translate to a Salmon slap or ActivityPub activity and forward to the destination. For example:
|
||||
</p>
|
||||
|
||||
<pre><div class="<span class='keyword'>h-entry</span>">
|
||||
Regarding <a class="<span class='keyword'>u-in-reply-to</span>" href="<a href='https://mastodon.technology/@snarfed/3194674'>https://mastodon.technology/@snarfed/3194674</a>">this post</a>:
|
||||
<p class="<span class='keyword'>e-content</span>"><span class='value'>Highly entertaining. Please subscribe me to your newsletter.</span></p>
|
||||
<a href="<a href='https://fed.brid.gy/'>https://fed.brid.gy/</a>"></a>
|
||||
</div>
|
||||
</pre>
|
||||
|
||||
<p>
|
||||
To receive likes, reposts, replies, and follows from fedsocnets, just make sure your site accepts webmentions! Bridgy translates incoming Salmon slaps and ActivityPub activities to webmentions and sends them to your site.</p>
|
||||
|
||||
<p>
|
||||
The webmention source URL will usually be a proxy page on <code>fed.brid.gy</code>. For best results, <a href="https://brid.gy/about#appspot">make sure your webmention handler detects and handles <code>u-url</code> links</a>!
|
||||
</p>
|
||||
</li>
|
||||
|
||||
<li id="setup" class="question">How do I set it up?</li>
|
||||
<li class="answer">
|
||||
<p>
|
||||
|
|
@ -116,10 +146,6 @@ Next, add an <a href="https://en.wikipedia.org/wiki/Atom_(standard)">Atom</a> fe
|
|||
<pre><link rel="alternate" type="application/atom+xml"
|
||||
href="https://granary.io/url?url=http://[DOMAIN]/&input=html&output=atom&hub=https://bridgy-fed.superfeedr.com/" /></pre>
|
||||
|
||||
<p>
|
||||
If you want people on fedsocnets to see your posts, your site will also need to support <a href="https://indieweb.org/WebSub">WebSub</a> (née PubSubHubbub). Specifically, <a href="https://blog.superfeedr.com/howto-pubsubhubbub/#discovery">your Atom feed needs to advertise it</a>. <a href="https://github.com/tootsuite/mastodon/issues/1441#issuecomment-302969948">Example details for Mastodon.</a> If you're on a CMS, it may already have a plugin! <a href="https://wordpress.org/">WordPress</a> has <a href="https://indieweb.org/WebSub#WordPress_Plugins_for_PuSH">a couple</a>, and <a href="http://withknown.com/">Known</a> has it <a href="https://indieweb.org/WebSub#1000s_of_Known_Sites">built in</a>. Or you can use <a href="https://superfeedr.com/publisher">Superfeedr</a> or <a href="https://switchboard.p3k.io/">Switchboard</a>.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
Finally, configure your web site to redirect these URL paths to the same paths on <code>https://fed.brid.gy/</code>, including query parameters:
|
||||
</p>
|
||||
|
|
@ -175,39 +201,13 @@ https://en.support.wordpress.com/site-redirect/
|
|||
|
||||
</ul>
|
||||
|
||||
<p>
|
||||
If you want people on OStatus sites like Hubzilla to see your posts, your web site will also need to support <a href="https://indieweb.org/WebSub">WebSub</a> (née PubSubHubbub). Specifically, <a href="https://blog.superfeedr.com/howto-pubsubhubbub/#discovery">your Atom feed needs to advertise it</a>. <a href="https://github.com/tootsuite/mastodon/issues/1441#issuecomment-302969948">Example details for Mastodon.</a> If you're on a CMS, it may already have a plugin! <a href="https://wordpress.org/">WordPress</a> has <a href="https://indieweb.org/WebSub#WordPress_Plugins_for_PuSH">a couple</a>, and <a href="http://withknown.com/">Known</a> has it <a href="https://indieweb.org/WebSub#1000s_of_Known_Sites">built in</a>. Or you can use <a href="https://superfeedr.com/publisher">Superfeedr</a> or <a href="https://switchboard.p3k.io/">Switchboard</a>.
|
||||
</p>
|
||||
|
||||
</ol>
|
||||
</li>
|
||||
|
||||
<li id="use" class="question">How do I use it?</li>
|
||||
<li class="answer">
|
||||
|
||||
<p>
|
||||
Federated social network identities take the form <code>@username@example.com</code>, like an email address with a leading <code>@</code>. Your site's identity via Bridgy Fed will be <code>@yourdomain.com@yourdomain.com</code>. Once you've <a href="#setup">set up Atom and WebSub on your site</a>, people can follow you at that address.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
Most fedsocnets also publish Atom themselves, so you can add profile URLs like <a href="https://mastodon.technology/@snarfed">mastodon.technology/@snarfed</a> to your <a href="https://indieweb.org/reader">reader</a> and see their posts there too.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
To use it, create an IndieWeb <a href="https://indieweb.org/post">post</a>, <a href="https://indieweb.org/like">like</a>, <a href="https://indieweb.org/repost">repost</a>, <a href="https://indieweb.org/reply">reply</a>, or <a href="https://indieweb.org/follow">follow</a> as usual, and include a link to <code><a href="https://fed.brid.gy/">https://fed.brid.gy/</a></code> in that post. Your web server should then <a href="#setup">send Bridgy Fed a webmention</a>, which it will translate to a Salmon slap or ActivityPub activity and forward to the destination. For example:
|
||||
</p>
|
||||
|
||||
<pre><div class="<span class='keyword'>h-entry</span>">
|
||||
Regarding <a class="<span class='keyword'>u-in-reply-to</span>" href="<a href='https://mastodon.technology/@snarfed/3194674'>https://mastodon.technology/@snarfed/3194674</a>">this post</a>:
|
||||
<p class="<span class='keyword'>e-content</span>"><span class='value'>Highly entertaining. Please subscribe me to your newsletter.</span></p>
|
||||
<a href="<a href='https://fed.brid.gy/'>https://fed.brid.gy/</a>"></a>
|
||||
</div>
|
||||
</pre>
|
||||
|
||||
<p>
|
||||
To receive likes, reposts, replies, and follows from fedsocnets, just make sure your site accepts webmentions! Bridgy translates incoming Salmon slaps and ActivityPub activities to webmentions and sends them to your site.</p>
|
||||
|
||||
<p>
|
||||
The webmention source URL will usually be a proxy page on <code>fed.brid.gy</code>. For best results, <a href="https://brid.gy/about#appspot">make sure your webmention handler detects and handles <code>u-url</code> links</a>!
|
||||
</p>
|
||||
</li>
|
||||
|
||||
<li id="image" class="question">How do I include an image in a post?</li>
|
||||
<li class="answer">
|
||||
<p>
|
||||
|
|
@ -246,7 +246,7 @@ I love scotch. Scotchy scotchy scotch.
|
|||
<li class="answer">
|
||||
<p>
|
||||
I'm <a href="https://snarfed.org/">Ryan Barrett</a>. I'm just a guy who
|
||||
<a href="https://snarfed.org/2012-07-25_why_i_have_my_own_web_site">likes the web</a> and likes <a href="https://indieweb.org/why">owning my data</a>.
|
||||
<a href="https://snarfed.org/2012-07-25_why_i_have_my_own_web_site">likes the web</a> and <a href="https://indieweb.org/why">owning my data</a>.
|
||||
</p>
|
||||
</li>
|
||||
|
||||
|
|
|
|||
Ładowanie…
Reference in New Issue