kopia lustrzana https://github.com/snarfed/bridgy-fed
246 wiersze
11 KiB
HTML
246 wiersze
11 KiB
HTML
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
|
|
<title>Bridgy Fed</title>
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
<meta name="mobile-web-app-capable" content="yes"/>
|
|
<link rel="shortcut icon" sizes="128x128" href="https://brid.gy/static/bridgy_logo_128.jpg">
|
|
<link rel="apple-touch-icon-precomposed" sizes="128x128" href="https://brid.gy/static/bridgy_logo_128.jpg">
|
|
<!-- 32x32 last so that browsers prefer it -->
|
|
<link rel="shortcut icon" sizes="32x32" href="https://brid.gy/static/favicon.png">
|
|
<link rel="apple-touch-icon-precomposed" sizes="32x32" href="https://brid.gy/static/favicon.png">
|
|
<link rel="stylesheet" href="/static/bootstrap.min.css" />
|
|
<link rel="stylesheet" href="/static/style.css" type="text/css" />
|
|
<link rel="webmention" href="/webmention" />
|
|
</head>
|
|
|
|
<body>
|
|
|
|
<main class="tp-main lead container">
|
|
|
|
<br />
|
|
<p class="big row" style="color: red; font-weight: bold">
|
|
ALPHA! STILL UNDER DEVELOPMENT.
|
|
</p>
|
|
|
|
<div id="intro" class="row">
|
|
<div id="logos" class="col-xs-4">
|
|
<a href="/"><img class="img-responsive" src="/static/bridgy_logo.jpg" /></a>
|
|
</div>
|
|
|
|
<div id="header" class="col-xs-8">
|
|
<p class="big">
|
|
Got an <a href="https://indieweb.org/">IndieWeb</a> site?<br />
|
|
Want to interact with <a href="https://joinmastodon.org/">Mastodon</a>, <a href="https://project.hubzilla.org/">Hubzilla</a>,<br />
|
|
and the rest of the <a href="https://en.wikipedia.org/wiki/Fediverse">fediverse</a>?<br />
|
|
<a id="title" href="/">Bridgy Fed</a> is for you.
|
|
</p></div>
|
|
</div>
|
|
|
|
<p class="clearfix"></p>
|
|
|
|
<br />
|
|
|
|
<p class="row">
|
|
<button id="get-started" class="btn btn-default"
|
|
onclick="document.getElementById('get-started').style.display = 'none';
|
|
document.getElementById('docs').style.display = 'block';">
|
|
Get started</button>
|
|
</p>
|
|
|
|
<div id="docs" style="display: none">
|
|
<ul>
|
|
<li><a href="#work">How does it work?</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="#sites">Which sites are supported?</a></li>
|
|
<li><a href="#cost">How much does it cost?</a></li>
|
|
<li><a href="#who">Who are you? Why did you make this?</a></li>
|
|
<li><a href="#privacy">What do you do with my data?</a></li>
|
|
<li><a href="#history">How long has this been around?</a></li>
|
|
<li><a href="#bug">I found a bug! I have a feature request!</a></li>
|
|
</ul>
|
|
|
|
<ul>
|
|
<li id="work" class="question">How does it work?</li>
|
|
<li class="answer">
|
|
<p>
|
|
Bridgy Fed lets you interact with federated social networks like <a href="https://joinmastodon.org/">Mastodon</a> from your <a href="https://indieweb.org/">IndieWeb</a> site. It translates replies, likes, and reposts from <a href="http://www.webmention.org/">webmentions</a> to federated social networking protocols like <a href="https://activitypub.rocks/">ActivityPub</a> and <a href="https://en.wikipedia.org/wiki/OStatus">OStatus</a>, and vice versa.
|
|
</p>
|
|
|
|
<li id="setup" class="question">How do I set it up?</li>
|
|
<li class="answer">
|
|
<p>
|
|
First, your site needs to support <a href="http://www.webmention.org/">webmentions</a>. <a href="https://indieweb.org/webmention#Publishing_Software">Check out the IndieWeb wiki</a> for instructions for your web server.
|
|
</p>
|
|
|
|
<p>
|
|
Next, if your site doesn't already have an <a href="https://en.wikipedia.org/wiki/Atom_(standard)">Atom</a> feed, add one. If you're on WordPress, install the <a href="https://wordpress.org/plugins/atom-default-feed/">Atom Default Feed plugin</a>.
|
|
<!-- or just <a href="https://codex.wordpress.org/WordPress_Feeds#Finding_Your_Feed_URL">add this</a> to your HTML header:<br /> -->
|
|
Otherwise, you can use <a href="https://granary-demo.appspot.com/">granary</a>. Just add this to your site's HTML <code><head></code> and fill in <code>DOMAIN</code> with your site's domain:
|
|
</p>
|
|
<pre><link rel="alternate" type="application/atom+xml" href="https://granary-demo.appspot.com/url?url=http://[DOMAIN]/&input=html&output=atom&hub=https://bridgy-fed.superfeedr.com/" /></pre>
|
|
|
|
<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>
|
|
<pre>
|
|
/.well-known/host-meta
|
|
/.well-known/host-meta.xrd
|
|
/.well-known/host-meta.jrd
|
|
/.well-known/webfinger
|
|
</pre>
|
|
|
|
<p>Here are instructions for a few common web servers:</p>
|
|
|
|
<ul>
|
|
<li>
|
|
<p><em><a href="http://wordpress.org/">WordPress</a> (self-hosted)</em>: install the <a href="https://wordpress.org/plugins/safe-redirect-manager/">Safe Redirect Manager</a> plugin, then add these entries:</p>
|
|
<code>
|
|
/.well-known/host-meta* => https://fed.brid.gy/.well-known/host-meta*<br/>
|
|
/.well-known/webfinger* => https://fed.brid.gy/.well-known/webfinger*
|
|
</code>
|
|
</li>
|
|
|
|
<li><em><a href="http://withknown.com/">Known</a></em>: TODO
|
|
</li>
|
|
|
|
<li><em><a href="http://httpd.apache.org/">Apache</a></em>: add this to your <code>.htaccess</code> file:<br />
|
|
<pre>RewriteEngine on
|
|
RewriteBase /
|
|
RewriteRule ^.well-known/(host-meta|webfinger).* https://fed.brid.gy/$0 [redirect=302,last]</pre>
|
|
</li>
|
|
|
|
<li><em><a href="">nginx</a></em>: add this to your <code>nginx.conf</code> file, in the <code>server</code> section:<br />
|
|
<pre>rewrite ^/.well-known/(host-meta|webfinger).* https://fed.brid.gy/$request_uri redirect;</pre>
|
|
</li>
|
|
|
|
<!--
|
|
<em><a href="https://www.blogger.com/">Blogger</a></em>:
|
|
Not to other domains
|
|
https://helplogger.blogspot.com/2014/07/how-to-set-custom-redirects-for-blogger-post.html
|
|
|
|
<em><a href="https://medium.com/">Medium</a>: TODO</em>
|
|
Redirects but not custom
|
|
https://help.medium.com/hc/en-us/articles/213475208-301-Redirects
|
|
|
|
<em><a href="http://www.tumblr.com/">Tumblr</a></em>:
|
|
Looks doable!
|
|
https://tumblr.zendesk.com/hc/en-us/articles/231449328-Redirect-pages
|
|
|
|
<em><a href="http://wordpress.com/">WordPress.com</a></em>:
|
|
Site Redirect, but not per URL
|
|
https://en.support.wordpress.com/site-redirect/
|
|
|
|
-->
|
|
|
|
</ul>
|
|
|
|
</ol>
|
|
</li>
|
|
|
|
<li id="use" class="question">How do I use it?</li>
|
|
<li class="answer">
|
|
<p>
|
|
To <a href="https://indieweb.org/like">like</a>, <a href="https://indieweb.org/repost">repost</a>, or <a href="https://indieweb.org/reply">reply</a> to a post on a federated social network, just include a link to <code><a href="https://fed.brid.gy/">https://fed.brid.gy/</a></code> in your post. Your web server should then <a href="setup">send it 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, and replies from federated social networks, just make sure your site accepts webmentions! Bridgy translates incoming Salmon slaps and ActivityPub activities to webmentions and sends them to your site. For replies, the source will usually be the permalink on the social network itself. For likes and reposts, the source 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="sites" class="question">Which sites are supported?</li>
|
|
<li class="answer">
|
|
<p>
|
|
These sites are currently supported:
|
|
</p>
|
|
<ul>
|
|
<li><em><a href="https://joinmastodon.org/">Mastodon</a></em>: replies, likes, and reposts aka boosts are supported, both directions, via ActivityPub.</li>
|
|
<li><em><a href="https://project.hubzilla.org/">Hubzilla</a></em>: replies, likes, and reposts aka shares are supported, both directions, via OStatus.</li>
|
|
</ul>
|
|
<p>
|
|
We're currently investigating these sites, and may support them in the future:
|
|
</p>
|
|
<ul>
|
|
<li><em><a href="https://diasporafoundation.org/">Diaspora</a></em>, via OStatus.</li>
|
|
<li><em><a href="http://friendi.ca/">Friendica</a></em>, via OStatus.</li>
|
|
<li><em><a href="https://gnu.io/social/">GNU Social</a></em> (née StatusNet), via OStatus.</li>
|
|
</ul>
|
|
|
|
<p>
|
|
We're aware of the sites below, but not currently working on them. Feel free to <a href="https://github.com/snarfed/bridgy-fed/issues">file a feature request</a> if you're interested in any of them!
|
|
</p>
|
|
<ul>
|
|
<li><em><a href="https://mediagoblin.org/">MediaGoblin</a></em></li>
|
|
<li><em><a href="https://postactiv.com/">postActiv</a></em></li>
|
|
<li><em><a href="http://pump.io/">pump.io</a></em></li>
|
|
<li><em><a href="https://gitgud.io/lambadalambda/pleroma">pleroma</a></em></li>
|
|
</ul>
|
|
</li>
|
|
|
|
<li id="cost" class="question">How much does it cost?</li>
|
|
<li class="answer">
|
|
<p>Nothing! Bridgy Fed is small, and it doesn't cost much to run. We don't need donations, promise.
|
|
</p>
|
|
<p>If you <em>really</em> want to contribute, <a href="https://github.com/snarfed/bridgy-fed/issues">file an issue</a> or <a href="https://github.com/snarfed/bridgy-fed">send a pull request</a>, or <a href="https://opencollective.com/indieweb">donate to the IndieWeb</a>!
|
|
</p></li>
|
|
|
|
<li id="who" class="question">Who are you? Why did you make this?</li>
|
|
<li class="answer">
|
|
<p>
|
|
I'm <a class="h-card" 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>.
|
|
</p>
|
|
</li>
|
|
|
|
<li id="privacy" class="question">What do you do with my data?</li>
|
|
<li class="answer">
|
|
<p>Nothing! Bridgy Fed isn't a business, and never will be, so I don't have the same motivations to abuse your data that other services might. More concretely, Bridgy Fed won't ever send you email, it stores as little of your <a href="http://en.wikipedia.org/wiki/Personally_identifiable_information">PII</a> (personally identifiable information) as possible, and it <em>never</em> has access to any of your passwords.
|
|
</p>
|
|
</li>
|
|
|
|
<li id="history" class="question">How long has this been around?</li>
|
|
<li class="answer">
|
|
<p>I started thinking about bridging federated social networks and peer to peer networkswhen I discovered them in the early 2000s. I started talking about bridging them to the IndieWeb in 2016, <a href="http://indieweb.org/2017/ostatusbridge">led a session on it at IndieWeb Summit</a> in July 2017, wrote up <a href="https://snarfed.org/indieweb-activitypub-bridge">concrete</a> <a href="https://snarfed.org/indieweb-ostatus-bridge"> designs</a> soon after, and started working on Bridgy Fed in August 2017.
|
|
</li>
|
|
|
|
<li id="bug" class="question">I found a bug! I have a feature request!</li>
|
|
<li class="answer">
|
|
<p>Great! Please <a href="https://github.com/snarfed/bridgy-fed/issues">file it in GitHub</a>. Thank you!
|
|
</p>
|
|
</li>
|
|
|
|
</ul>
|
|
</div>
|
|
|
|
<div id="footer">
|
|
<a href="https://github.com/snarfed/bridgy-fed/issues">Bugs</a>
|
|
| <a href="https://github.com/snarfed/bridgy-fed">Source</a>
|
|
| <a href="https://indieweb.org/">#IndieWeb</a>
|
|
| <a href="https://brid.gy/">Bridgy</a>
|
|
</div>
|
|
|
|
</div>
|
|
</main>
|
|
|
|
<!-- Automatically show docs if there's a fragment (ie fragmention) -->
|
|
<script type="text/javascript">
|
|
if (document.location.hash) {
|
|
document.getElementById('get-started').style.display = 'none';
|
|
document.getElementById('docs').style.display = 'block';
|
|
}
|
|
</script>
|
|
<script src="/static/fragmention.js"></script>
|
|
|
|
</body>
|
|
</html>
|