From 84e6d9ceb26a570088af1108780bea34aab2bdf2 Mon Sep 17 00:00:00 2001 From: Goffi Date: Wed, 31 Aug 2022 17:07:03 +0200 Subject: [PATCH] doc (components/AP gateway): "reactions": fix 371 --- doc/components.rst | 32 ++++++++++++++++++++++++-------- 1 file changed, 24 insertions(+), 8 deletions(-) diff --git a/doc/components.rst b/doc/components.rst index 5e0bc47c..586b1b2e 100644 --- a/doc/components.rst +++ b/doc/components.rst @@ -675,18 +675,35 @@ activity. Conversion is done in both directions and should be transparent to use Noticed/Like ~~~~~~~~~~~~ -AP's ``Like`` activity is converted on the XMPP side to "`Pubsub Attachment`_", which is -currently a "protoXEP", i.e. a specification proposed as a standard (not yet reviewed by -`XMPP Council`_). ``Like`` is converted to ``noticed`` attachment, meaning that it used in +AP's ``Like`` activity is converted on the XMPP side to "`XEP-0470 (Pubsub +Attachments)`_". ``Like`` is converted to ``noticed`` attachment, meaning that it used in to indicate that something has been seen and taken into account, without really indication -if the content is liked or disliked (see Pubsub Attachment § Foreword: `"noticed" instead -of "like" or "favourite"`_ for the rational). +if the content is liked or disliked (see XEP-0470 § Foreword: `"noticed" instead of "like" +or "favourite"`_ for the rational). As usual, conversion is done in both ways. -.. _Pubsub Attachment: https://xmpp.org/extensions/inbox/pubsub-attachments.html +.. _XEP-0470 (Pubsub Attachments): https://xmpp.org/extensions/xep-0470.html .. _XMPP Council: https://xmpp.org/about/xmpp-standards-foundation/ -.. _"noticed" instead of "like" or "favourite": https://xmpp.org/extensions/inbox/pubsub-attachments.html#noticed-foreword +.. _"noticed" instead of "like" or "favourite": https://xmpp.org/extensions/xep-0470.html#noticed-foreword + +Reactions +~~~~~~~~~ + +Reactions are not specified in `base ActivityPub specification`_. However `Pleroma`_, a +software implemeting ActivityPub, implements them using a non standardised (yet?) +``EmojiReact`` activity. Liberva AP Gateway use it to handle reactions. + +On the XMPP side, `XEP-0470 (Pubsub Attachments)`_ is once again used. + +Libervia also implements `XEP-0444 (Message Reactions)`_ for messages, but because Pleroma +doesn't handle reactions for direct messages, this is not used in the Libervia AP gateway. +If in the future an AP implementation uses reactions on direct messages, it will be +straightforward to add it in the AP gateway. + +.. _base ActivityPub specification: https://www.w3.org/TR/activitypub/ +.. _Pleroma: https://pleroma.social/ +.. _XEP-0444 (Message Reactions): https://xmpp.org/extensions/xep-0444.html Using the Component (for developers) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -712,4 +729,3 @@ Louise can use the following command:: Note the double escaping, one for the shell argument, and the other to specify JSON object. -