Mercurial > libervia-backend

comparison doc/libervia-cli/avatar.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
comparison
equal deleted inserted replaced
3541:888109774673 3573:813595f88612
1 =============================== 1 ===============================
2 avatar: retrieve/upload avatars 2 avatar: retrieve/upload avatars
3 =============================== 3 ===============================
4 4
5 Avatars are images associated to an XMPP entity. Several XMPP extensions are in use, SàT 5 Avatars are images associated to an XMPP entity. Several XMPP extensions are in use, Libervia
6 tries to hide the technical details so avatar are as easy as possible to manipulate for 6 tries to hide the technical details so avatar are as easy as possible to manipulate for
7 end-user. 7 end-user.
8 8
9 get 9 get
10 === 10 ===
11 11
12 Retrieve the avatar of the given entity. Entity jid is specified as positional argument. 12 Retrieve the avatar of the given entity. Entity jid is specified as positional argument.
13 13
14 If an avatar is found, a path to its cached file is printed. Please note that this is the 14 If an avatar is found, a path to its cached file is printed. Please note that this is the
15 cache used by all SàT ecosystem, **do not modify the cached image**. You may use it for 15 cache used by all Libervia ecosystem, **do not modify the cached image**. You may use it for
16 read-only access, or copy it if you want to modify the image. 16 read-only access, or copy it if you want to modify the image.
17 17
18 You may use the ``-s, --show`` argument to display the found avatar. The software used to 18 You may use the ``-s, --show`` argument to display the found avatar. The software used to
19 display the image can be specified in SàT configuration (cf. :ref:`configuration`), in the 19 display the image can be specified in Libervia configuration (cf. :ref:`configuration`), in the
20 ``[li]`` section: the ``image_cmd`` setting let you specify the path to the software. If 20 ``[li]`` section: the ``image_cmd`` setting let you specify the path to the software. If
21 ``image_cmd`` is not used, ``li`` will try some common software, and if none is found, it 21 ``image_cmd`` is not used, ``li`` will try some common software, and if none is found, it
22 will try to open the image in a browser (which may sometimes result in using the default 22 will try to open the image in a browser (which may sometimes result in using the default
23 image software of the platform). 23 image software of the platform).
24 24