Mercurial > libervia-backend
comparison doc/libervia-cli/avatar.rst @ 3488:c80a0f864b5d
doc: updated doc following global renaming
| author | Goffi <goffi@goffi.org> |
|---|---|
| date | Sun, 21 Mar 2021 18:23:58 +0100 |
| parents | doc/jp/avatar.rst@6cf4bd6972c2 |
| children | 267e4987b58b |
comparison
equal
deleted
inserted
replaced
| 3487:75427f0a5445 | 3488:c80a0f864b5d |
|---|---|
| 1 =============================== | |
| 2 avatar: retrieve/upload avatars | |
| 3 =============================== | |
| 4 | |
| 5 Avatars are images associated to an XMPP entity. Several XMPP extensions are in use, SàT | |
| 6 tries to hide the technical details so avatar are as easy as possible to manipulate for | |
| 7 end-user. | |
| 8 | |
| 9 get | |
| 10 === | |
| 11 | |
| 12 Retrieve the avatar of the given entity. Entity jid is specified as positional argument. | |
| 13 | |
| 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 | |
| 16 read-only access, or copy it if you want to modify the image. | |
| 17 | |
| 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 | |
| 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 | |
| 22 will try to open the image in a browser (which may sometimes result in using the default | |
| 23 image software of the platform). | |
| 24 | |
| 25 When available, cached avatar is returned by defaut. If you want to ignore the cache, use | |
| 26 the ``--no-cache`` option (of course this can result in more network requests). | |
| 27 | |
| 28 example | |
| 29 ------- | |
| 30 | |
| 31 Get the avatar of ``louise@example.org`` and display it:: | |
| 32 | |
| 33 $ li avatar get --show louise@example.org | |
| 34 | |
| 35 | |
| 36 set | |
| 37 === | |
| 38 | |
| 39 Upload and set the given avatar for the profile. The only required argument is the path to | |
| 40 the image to use as avatar. | |
| 41 | |
| 42 example | |
| 43 ------- | |
| 44 | |
| 45 Set the avatar of the default profile:: | |
| 46 | |
| 47 $ li avatar set ~/photos/some_photo.jpg |