Mercurial > libervia-backend

comparison doc/components.rst @ 3790:24f70a29e382

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
doc (components): typo/spelling
author Goffi <goffi@goffi.org>
date Fri, 17 Jun 2022 14:15:23 +0200
parents cebfdfff3e99
children 29380ef68dbe
comparison
equal deleted inserted replaced
3789:665f060fbecb 3790:24f70a29e382
473 Messages Delivery 473 Messages Delivery
474 ~~~~~~~~~~~~~~~~~ 474 ~~~~~~~~~~~~~~~~~
475 475
476 The gateway can convert AP publications to either XMPP pubsub items (using `XEP-0277 476 The gateway can convert AP publications to either XMPP pubsub items (using `XEP-0277
477 (Microblogging over XMPP)`_ when suitable) or to XMPP messages (`<message>` stanzas, i.e. 477 (Microblogging over XMPP)`_ when suitable) or to XMPP messages (`<message>` stanzas, i.e.
478 the ones used for instant messaging). Of course it also convert in a similar way in the 478 the ones used for instant messaging). Of course it also converts in a similar way in the
479 other direction (XMPP → ActivityPub). 479 other direction (XMPP → ActivityPub).
480 480
481 A received AP items will be converted to an XMPP pubsub item if any of the following 481 A received AP item will be converted to an XMPP pubsub item if any of the following
482 condition is fulfilled: 482 conditions is fulfilled:
483 483
484 - it is addressed to the special `*public* collection`_ 484 - it is addressed to the special `*public* collection`_
485 - it is addressed to a local *followers* collection 485 - it is addressed to a local *followers* collection
486 486
487 A received AP item will be convert to an XMPP message if all the following condition are 487 A received AP item will be converted to an XMPP message if all the following conditions
488 fulfilled: 488 are fulfilled:
489 489
490 - it is **not** addressed to the special *public* collection 490 - it is **not** addressed to the special *public* collection
491 - it is **not** addressed to a any local *followers* collection. 491 - it is **not** addressed to a any local *followers* collection.
492 492
493 In other words, if an AP items is addressed directly to one or more local users, is not 493 In other words, if an AP item is addressed directly to one or more local users, is not
494 public and is not addressed to a *followers* collection, it will be converted to an XMPP 494 public and is not addressed to a *followers* collection, it will be converted to an XMPP
495 message, otherwise it will be converted to an XMPP pubsub item. 495 message, otherwise it will be converted to an XMPP pubsub item.
496 496
497 The behaviour is symmetric, thus if you send an XMPP message it will be converted to an AP 497 The behaviour is symmetric, thus if you send an XMPP message it will be converted to an AP
498 item which will be only addressed to your recipient. If you write using XMPP pubsub, the 498 item which will be only addressed to your recipient. If you write using XMPP pubsub, the