erebion/libervia-backend
Watch
1
0
Fork
You've already forked libervia-backend
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

doc (components/AP gateway): "reactions":

Browse source 
fix 371
This commit is contained in:
Goffi 2022-08-31 17:07:03 +02:00
commit 84e6d9ceb2
1 changed files with 24 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

32
doc/components.rst
View file

@ -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.