From d63b3d2397138aecf1d70f59672b82105bc9416f Mon Sep 17 00:00:00 2001 From: Felix Ableitner Date: Wed, 24 Mar 2021 16:53:41 +0100 Subject: [PATCH] Some adjustments to previous commit, move file --- src/en/SUMMARY.md | 2 +- .../federation_getting_started.md} | 32 ++++++++----------- 2 files changed, 14 insertions(+), 20 deletions(-) rename src/en/{federation/federation.md => administration/federation_getting_started.md} (59%) diff --git a/src/en/SUMMARY.md b/src/en/SUMMARY.md index fcdff46..0d454ba 100644 --- a/src/en/SUMMARY.md +++ b/src/en/SUMMARY.md @@ -10,11 +10,11 @@ - [Install with Ansible](administration/install_ansible.md) - [Other Installation Methods](administration/other_installation_methods.md) - [Configuration](administration/configuration.md) + - [Getting started with Federation](administration/federation_getting_started.md) - [Troubleshooting](administration/troubleshooting.md) - [Backup and Restore](administration/backup_and_restore.md) - [Federation](federation/federation.md) - [Federation Overview](federation/overview.md) - - [Administration](federation/administration.md) - [Resources](federation/resources.md) - [Lemmy Protocol](federation/lemmy_protocol.md) - [Client Development](client_development/client_development.md) diff --git a/src/en/federation/federation.md b/src/en/administration/federation_getting_started.md similarity index 59% rename from src/en/federation/federation.md rename to src/en/administration/federation_getting_started.md index 0e9622d..5f9ffc0 100644 --- a/src/en/federation/federation.md +++ b/src/en/administration/federation_getting_started.md @@ -1,5 +1,5 @@ # Federation -https://lemmy.ml/u/20776 + Lemmy uses the ActivityPub protocol (a W3C standard) to enable federation between different servers (often called instances). This is very similar to the way email works. For example, if you use gmail.com, then you can not only send mails to other gmail.com users, but also to yahoo.com, yandex.ru and so on. Email uses the SMTP protocol to achieve this, so you can think of ActivityPub as "SMTP for social media". The amount of different actions possible on social media (post, comment, like, share, etc) means that ActivityPub is much more complicated than SMTP. As with email, ActivityPub federation happens only between servers. So if you are registered on `enterprise.lemmy.ml`, you only connect to the API of `enterprise.lemmy.ml`, while the server takes care of sending and receiving data from other instances (eg `voyager.lemmy.ml`). The great advantage of this approach is that the average user doesn't have to do anything to use federation. In fact if you are using Lemmy, you are likely already using it. One way to confirm is by going to a community or user profile. If you are on `enterprise.lemmy.ml` and you see a user like `@nutomic@voyager.lemmy.ml`, or a community like `!main@ds9.lemmy.ml`, then those are federated, meaning they use a different instance from yours. @@ -15,29 +15,23 @@ One way you can take advantage of federation is by opening a different instance, You can see the list of linked instances by following the "Instances" link at the bottom of any Lemmy page. -## Searching for communities +## Fetching communities -If you search for a community first time, 20 posts are fetched initially. Only if a least one user on your instance subscibes this community on the other host, this host will deliver updates to your instance. -Updates mean: -- new posts -- new comments -- votings -- edited comments and posts +If you search for a community first time, 20 posts are fetched initially. Only if a least one user on your instance subscribes to the remote community, will the community send updates to your instance. Updates include: -You can copy the URL of the community from the address-bar in your browser and insert it in your search-field. Wait a few seconds, the post will appear below. There is no indicator for a running search now! +- New posts, comments +- Votes +- Post, comment edits and deletions +- Mod actions -## Searching for posts +You can copy the URL of the community from the address bar in your browser and insert it in your search field. Wait a few seconds, the post will appear below. At the moment there is no loading indicator for the search, so wait a few seconds if it shows "no results". -Copy the URL of a post in your lemmy's search-field. Wait a few seconds until the post will appear. Klick on it, you'll be lead to the posting into the community, where you cann see the "Follow"-button and follow the community. Be aware, not all postings are fetched from the community, only a few ammount, and no comments! +## Fetching posts -## Searching for comments +Paste the URL of a post into your Lemmy instance's search field. Wait a few seconds until the post appears. This will also fetch the community profile, and the profile of the post creator. -If you find an interesting comment under a posting on another instance, you can find below the comment in the 3-dot-menu the link-symbol. Copy this link, oder klick on the link-button and copy the url from your address-bar in the browser. The link looks like `https://lemmy.ml/post/56382/comment/40796`. Remove the `post/XXX` part from this link and put it into your search-bar. For this example, search for `https://lemmy.ml/comment/40796`. -This comment, all parent comments, users and community and the responding posting is fetched from the remote instance, if they are not known locally. -No siblings are fetched!! +## Fetching comments -If you wand more comments from older postings, you have to search for them the same way as described just above. +If you find an interesting comment under a posting on another instance, you can find below the comment in the 3-dot-menu the link-symbol. Copy this link. It looks like `https://lemmy.ml/post/56382/comment/40796`. Remove the `post/XXX` part and put it into your search-bar. For this example, search for `https://lemmy.ml/comment/40796`. This comment, all parent comments, users and community and the corresponding post are fetched from the remote instance, if they are not known locally. -## Drawbacks - -There is no possibility to fetch easily old postings or comments from a remote instance from your instance, if you have joined a community. +Sibling comments are not fetched! If you want more comments from older posts, you have to search for each of them as described above.