mirror
/
bridgy-fed
kopia lustrzana https://github.com/snarfed/bridgy-fed
1
0
Forkuj 0
Kod Zgłoszenia Packages Projekty Wydania Wiki Aktywność

docs: show completed parts of translation tables in green

pull/525/head
Ryan Barrett 2023-05-26 12:42:55 -07:00
rodzic 2f2e26b233
commit 6268f5d9a0
Nie znaleziono w bazie danych klucza dla tego podpisu
ID klucza GPG: 6BE31FDF4776E9D4
2 zmienionych plików z 34 dodań i 30 usunięć
Pokaż statystyki Ściągnij plik aktualizacji Ściągnij plik porównania Expand all files Collapse all files

24
static/style.css
Wyświetl plik

@ -390,11 +390,6 @@ input[type="submit"] {
display: inline-block;
}
/* Override the inline display:block which makes it align left instead of center. */
iframe#twitter-widget-0 {
display: inline !important;
}
#footer {
margin-top: 2em;
margin-bottom: 1em;
@ -481,6 +476,18 @@ a img.shadow:hover
background-color: #f6f6f6;
}
.docs .done {
background-color: #ebf6eb;
}
.docs tr:nth-child(even) .done {
background-color: #e2f6e2;
}
.docs .not-done {
background-color: white;
}
.question {
margin-top: 2em;
margin-bottom: .5em;
@ -491,13 +498,6 @@ a img.shadow:hover
margin-bottom: .5em;
}
/* confirm_instagram.html */
iframe {
width: 50%;
border: 1px solid gray;
height: 300px;
}
.right {
float: right;
margin-left: 20px;

40
templates/docs.html
Wyświetl plik

@ -491,7 +491,10 @@ I'm <a href="https://snarfed.org/">Ryan Barrett</a>. I'm just a guy who likes <a
<p>Here are internal details on how Bridgy Fed translates user identity and events between protocols, including some like <a href="https://github.com/nostr-protocol/nostr">Nostr</a> and <a href="https://blueskyweb.xyz/">Bluesky</a>/<a href="https://atproto.com/">AT Protocol</a> that aren't launched yet. This includes in progress ideas that may not be implemented yet or fully thought through. Caveat hacker!
</p>
<p>Here's how we (plan to) translate <em>user identity</em> between protocols. Specifically, each square shows how a user in a given row is identified to the protocol in a given column. BF is Bridgy Fed. <em>Enhanced</em> is users who have done extra setup for BF, <em>basic</em> is users who haven't.
<p>In the tables below, BF is Bridgy Fed, <em>enhanced</em> is users who have done extra setup for BF, <em>basic</em> is users who haven't. <span class="done">Green parts</span> have been implemented and running here for years, the rest are still in the early design phase.
</p>
<p>Here's how we (plan to) translate <em>user identity</em> between protocols. Specifically, each square shows how a user in a given row is identified to the protocol in a given column.
</p>
<table>
@ -508,8 +511,9 @@ I'm <a href="https://snarfed.org/">Ryan Barrett</a>. I'm just a guy who likes <a
<tr>
<th>IndieWeb</th>
<td>-</td>
<td><em>basic</em>: <code>@[domain]@fed.brid.gy</code><br>
<em>enhanced</em>: <code>@[domain]@[domain]</code>
<td class="done">
<span class="not-done"><em>basic</em>: <code>@[domain]@fed.brid.gy</code></span><br>
<em>enhanced</em>: <code>@[domain]@[domain]</code>
</td>
<td><em>users</em>: domain as handle<br>
<em>code</em>: <code><a href="https://atproto.com/specs/did-plc">did:plc</a></code> generated by BF
@ -520,7 +524,7 @@ I'm <a href="https://snarfed.org/">Ryan Barrett</a>. I'm just a guy who likes <a
</tr>
<tr>
<th>ActivityPub</th>
<td>Fediverse profile URL</td>
<td class="done">Fediverse profile URL</td>
<td>-</td>
<td><em>users</em>: <code>[username].[instance]</code> (fabricated domain)<br>
<em>code</em>: <code><a href="https://atproto.com/specs/did-plc">did:plc</a></code> generated by BF
@ -564,8 +568,8 @@ I'm <a href="https://snarfed.org/">Ryan Barrett</a>. I'm just a guy who likes <a
<tbody>
<tr>
<th>User discovery inbound</th>
<td>serve <code><a href="https://microformats.org/wiki/h-card">h-card</a></code> on BF user page</td>
<td><em>basic</em>: serve <a href="https://webfinger.net/">WebFinger</a> and <a href="https://www.w3.org/TR/activitypub/#actors">AP actor</a> on fed.brid.gy<br>
<td class="done">serve <code><a href="https://microformats.org/wiki/h-card">h-card</a></code> on BF user page</td>
<td class="done"><em>basic</em>: serve <a href="https://webfinger.net/">WebFinger</a> and <a href="https://www.w3.org/TR/activitypub/#actors">AP actor</a> on fed.brid.gy<br>
<em>enhanced</em>: user's site serves and redirects <a href="https://webfinger.net/">WebFinger</a> to fed.brid.gy
</td>
<td>resolve <a href="https://www.w3.org/TR/did-core/">DID</a>, serve DID document with fed.brid.gy <a href="https://atproto.com/guides/data-repos">PDS</a></td>
@ -573,44 +577,44 @@ I'm <a href="https://snarfed.org/">Ryan Barrett</a>. I'm just a guy who likes <a
</tr>
<tr>
<th>User discovery outbound</th>
<td>Fetch home page, parse <code><a href="https://microformats.org/wiki/h-card">h-card</a></code></td>
<td>look up <a href="https://webfinger.net/">WebFinger</a>, fetch <a href="https://www.w3.org/TR/activitypub/#actors">AP actor</a></td>
<td class="done">Fetch home page, parse <code><a href="https://microformats.org/wiki/h-card">h-card</a></code></td>
<td class="done">look up <a href="https://webfinger.net/">WebFinger</a>, fetch <a href="https://www.w3.org/TR/activitypub/#actors">AP actor</a></td>
<td>resolve <a href="https://www.w3.org/TR/did-core/">DID</a>, subscribe to <a href="https://atproto.com/guides/data-repos">PDS</a> repo, extract profile object?</td>
<td>discover user's relays with <a href="https://github.com/nostr-protocol/nips/blob/master/.md">NIP-65</a>, query <a href="https://github.com/nostr-protocol/nips/blob/master/.md">NIP-39</a> to get profile</td>
</tr>
<tr>
<th>Publish inbound</th>
<td><a href="https://webmention.net/">webmention</a> to fed.brid.gy</td>
<td>deliver to fed.brid.gy <a href="https://www.w3.org/TR/activitypub/#inbox">inbox</a>, user or shared</td>
<td class="done"><a href="https://webmention.net/">webmention</a> to fed.brid.gy</td>
<td class="done">deliver to fed.brid.gy <a href="https://www.w3.org/TR/activitypub/#inbox">inbox</a>, user or shared</td>
<td>subscribe to user's <a href="https://atproto.com/guides/data-repos">PDS</a> repo on fed.brid.gy</td>
<td>publish <a href="https://github.com/nostr-protocol/nips/blob/master/01.md#events-and-signatures">event</a> to BF relay</td>
</tr>
<tr>
<th>Publish outbound</th>
<td>serve on BF user page followings <code><a href="https://microformats.org/wiki/h-feed">h-feed</a></code></td>
<td>deliver to recipient's <a href="https://www.w3.org/TR/activitypub/#inbox">inbox</a></td>
<td class="done">serve on BF user page followings <code><a href="https://microformats.org/wiki/h-feed">h-feed</a></code></td>
<td class="done">deliver to recipient's <a href="https://www.w3.org/TR/activitypub/#inbox">inbox</a></td>
<td>serve repo diff via <a href="https://atproto.com/lexicons/com-atproto-sync"><code>sync</code> XRPCs</a> to subscribing <a href="https://blueskyweb.xyz/blog/5-5-2023-federation-architecture">BGSes</a></td>
<td>serve to subscribers</td>
</tr>
<tr>
<th>Follow inbound</th>
<td><em>users</em>: UI on BF user page<br>
<td class="done"><em>users</em>: UI on BF user page<br>
<em>code</em>: <a href="https://webmention.net/">webmention</a> with <code><a href="https://indieweb.org/follow#How_to_publish">u-follow-of</a></code></td>
<td><code><a href="https://www.w3.org/TR/activitystreams-vocabulary/#dfn-follow">Follow</a></code> activity delivered to BF user <a href="https://www.w3.org/TR/activitypub/#inbox">inbox</a></td>
<td class="done"><code><a href="https://www.w3.org/TR/activitystreams-vocabulary/#dfn-follow">Follow</a></code> activity delivered to BF user <a href="https://www.w3.org/TR/activitypub/#inbox">inbox</a></td>
<td>receive <code><a href="https://atproto.com/lexicons/com-atproto-sync#comatprotosyncsubscriberepos">sync.subscribeRepos</a></code>?</td>
<td>user's client sends <code><a href="https://github.com/nostr-protocol/nips/blob/master/01.md#from-client-to-relay-sending-events-and-creating-subscriptions">REQ</a></code> to BF relay</td>
</tr>
<tr>
<th>Follow outbound</th>
<td><a href="https://webmention.net/">webmention</a> with BF proxy HTML page as source</td>
<td>deliver <code><a href="https://www.w3.org/TR/activitystreams-vocabulary/#dfn-follow">Follow</a></code> to followee's <a href="https://www.w3.org/TR/activitypub/#inbox">inbox</a></td>
<td class="done"><a href="https://webmention.net/">webmention</a> with BF proxy HTML page as source</td>
<td class="done">deliver <code><a href="https://www.w3.org/TR/activitystreams-vocabulary/#dfn-follow">Follow</a></code> to followee's <a href="https://www.w3.org/TR/activitypub/#inbox">inbox</a></td>
<td>call <code><a href="https://atproto.com/lexicons/com-atproto-sync#comatprotosyncsubscriberepos">sync.subscribeRepos</a></code> on followee's <a href="https://atproto.com/guides/data-repos">PDS</a>?</td>
<td>discover followee's relay(s) with <a href="https://github.com/nostr-protocol/nips/blob/master/.md">NIP-65</a>, send them a <code><a href="https://github.com/nostr-protocol/nips/blob/master/01.md#from-client-to-relay-sending-events-and-creating-subscriptions">REQ</a></code></td>
</tr>
<tr>
<th>Response inbound</th>
<td><a href="https://webmention.net/">webmention</a> to a BF proxy page</td>
<td><code><a href="https://www.w3.org/TR/activitystreams-vocabulary/#dfn-create">Create</a></code>, <code><a href="https://www.w3.org/TR/activitystreams-vocabulary/#dfn-like">Like</a></code>, <code><a href="https://www.w3.org/TR/activitystreams-vocabulary/#dfn-announce">Announce</a></code> delivered to BF user <a href="https://www.w3.org/TR/activitypub/#inbox">inbox</a></td>
<td class="done"><a href="https://webmention.net/">webmention</a> to a BF proxy page</td>
<td class="done"><code><a href="https://www.w3.org/TR/activitystreams-vocabulary/#dfn-create">Create</a></code>, <code><a href="https://www.w3.org/TR/activitystreams-vocabulary/#dfn-like">Like</a></code>, <code><a href="https://www.w3.org/TR/activitystreams-vocabulary/#dfn-announce">Announce</a></code> delivered to BF user <a href="https://www.w3.org/TR/activitypub/#inbox">inbox</a></td>
<td>response object received from a subscribed repo?<br>
(what if it's from a user we don't subscribe to?)</td>
<td><a href="https://github.com/nostr-protocol/nips/blob/master/.md">NIP-10</a> response <a href="https://github.com/nostr-protocol/nips/blob/master/01.md#events-and-signatures">event</a> received at BF relay or other relay</td>