Mercurial > libervia-backend

comparison doc/libervia-cli/bookmarks.rst @ 3573:813595f88612

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
merge changes from main branch
author Goffi <goffi@goffi.org>
date Thu, 17 Jun 2021 13:05:58 +0200
parents 267e4987b58b
children d6837db456fd
comparison
equal deleted inserted replaced
3541:888109774673 3573:813595f88612
1 ============================ 1 ============================
2 bookmarks: get/set bookmarks 2 bookmarks: get/set bookmarks
3 ============================ 3 ============================
4 4
5 Bookmarks are links to MUC rooms or URLs with a few metadata. Due to historical reasons, 5 Bookmarks are links to MUC rooms or URLs with a few metadata. Due to historical reasons,
6 XMPP has several ways to handle bookmarks, and SàT handle them as transparently as 6 XMPP has several ways to handle bookmarks, and Libervia handle them as transparently as
7 possible. 7 possible.
8 8
9 With SàT there are 3 places where you can get/store your bookmarks: 9 With Libervia there are 3 places where you can get/store your bookmarks:
10 10
11 local 11 local
12 the bookmarks is stored only locally in the database of SàT. It won't be available to 12 the bookmarks is stored only locally in the database of Libervia. It won't be available to
13 other devices. 13 other devices.
14 private 14 private
15 the bookmarks use the old private XML storage (`XEP-0049`_). It is not recommended to 15 the bookmarks use the old private XML storage (`XEP-0049`_). It is not recommended to
16 use this if PubSub storage is available 16 use this if PubSub storage is available
17 pubsub 17 pubsub
18 the bookmarks use PEP storage (`XEP-0223`_), this is the currently recommended way to 18 the bookmarks use PEP storage (`XEP-0223`_), this is the currently recommended way to
19 store bookmarks. 19 store bookmarks.
20 20
21 When possible, you can specify ``auto`` to let SàT choose the best location (i.e. 21 When possible, you can specify ``auto`` to let Libervia choose the best location (i.e.
22 ``pubsub`` if available, then ``private`` then ``local`` if nothing else is possible). 22 ``pubsub`` if available, then ``private`` then ``local`` if nothing else is possible).
23 23
24 .. _XEP-0049: https://xmpp.org/extensions/xep-0049.html 24 .. _XEP-0049: https://xmpp.org/extensions/xep-0049.html
25 .. _XEP-0223: https://xmpp.org/extensions/xep-0223.html 25 .. _XEP-0223: https://xmpp.org/extensions/xep-0223.html
26 26
93 93
94 $ li bookmarks add sat@chat.jabberfr.org -a 94 $ li bookmarks add sat@chat.jabberfr.org -a
95 95
96 Add a link to Libervia official website:: 96 Add a link to Libervia official website::
97 97
98 $ li bookmarks add -t url https://www.salut-a-toi.org -n "SàT officiel" 98 $ li bookmarks add -t url https://www.salut-a-toi.org -n "Libervia officiel"