Create user guide

Co-authored-by: ljf (zamentur) <zamentur@users.noreply.github.com>
Co-authored-by: nathanael-h <7300309+nathanael-h@users.noreply.github.com>
This commit is contained in:
tituspijean 2022-04-23 16:44:19 +02:00
parent 3972c4533e
commit 4a64b21fab
No known key found for this signature in database
GPG key ID: EF3B0D7CC0A94720
349 changed files with 208 additions and 0 deletions

View file

@ -7,6 +7,8 @@ routes:
default: '/XMPP'
---
!! TODO: simplify this page for the admin and link it to the user's guide
![](image://XMPP_logo.png?resize=100)
YunoHost está instalado con un servidor de mensajería instantánea Metronome que implementa el [protocolo XMPP](https://es.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol).

View file

@ -7,6 +7,8 @@ routes:
default: '/XMPP'
---
!! TODO: simplify this page for the admin and link it to the user's guide
![](image://XMPP_logo.png?resize=100)
YunoHost est installé par défaut avec un serveur de messagerie instantanée Metronome qui implémente le [protocole XMPP](https://fr.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol) (anciennement connu sous le nom de Jabber).

View file

@ -7,6 +7,8 @@ routes:
default: '/XMPP'
---
!! TODO: simplifier cette page pour l'admin et mettre un lien vers le guide de l'utilisateur
![](image://XMPP_logo.png?resize=100)
By default, YunoHost comes installed with an instant messaging server called Metronome which implements the [XMPP protocol](https://en.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol) (previously known as Jabber).

View file

@ -0,0 +1,62 @@
---
title: Chat, VoIP y red local con XMPP
template: docs
taxonomy:
category: docs
routes:
default: '/XMPP'
---
![](image://XMPP_logo.png?resize=100)
YunoHost está instalado con un servidor de mensajería instantánea Metronome que implementa el [protocolo XMPP](https://es.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol).
XMPP es un protocolo abierto y extensible que también permite crear salones de discusión, compartir status y datos, echar llamadas en VoIP y hacer videoconferencias.
Todas las aplicaciones basadas en XMPP son compatibles entre ellas : cuando utilizas un cliente XMPP puedes discutir con cualquier persona que tenga una cuenta XMPP/Jabber. Este protocolo ya es utilizado por millones de personas en el mundo.
## Cuenta XMPP/Jabber
Una cuenta XMPP/Jabber está basada en un ID bajo la forma `usuario@dominio.tld`, así como una contraseña. La contraseña es la de la cuenta del usuario de YunoHost.
## Conectarse a XMPP
Existen varios clientes web de tipo red social, como :
- [Movim](https://movim.eu)
- [ConverseJS](https://conversejs.org/)
- [Libervia/Salut à Toi](https://salut-a-toi.org/)
También puedes utilizar un cliente Desktop como :
- [Gajim](https://gajim.org/es/) (Linux, Windows)
- [Dino](https://dino.im) (Linux)
- [Thunderbird](https://www.thunderbird.net/es-ES/) (multiplataformas)
- [Beagle IM](https://beagle.im/) (macOS)
- [Profanity](https://profanity-im.github.io/) (Linux)
... o un cliente smartphone :
- [Conversations](https://conversations.im/) (Android)
- [Xabber](http://xabber.com) (Android)
- [Movim](https://movim.eu) (Android)
- [ChatSecure](https://chatsecure.org/) (iOS)
- [Siskin IM](https://siskin.im/) (iOS)
- [Monal](https://monal.im/) (iOS)
- [Kaidan](https://www.kaidan.im/) (Ubuntu Touch / Plasma Mobile)
Aquí tienes una lista más exhaustiva de clientes XMPP (en) : https://xmpp.org/software/clients.html
### Cifrar tu conversaciones con OMEMO :
Es posible cifrar tu conversaciones XMPP con la ayuda de [OMEMO](https://xmpp.org/extensions/xep-0384.html), por ejemplo utilizando Gajim :
* Instalar `gajim` y el plugin `gajim-omemo`
* Activar el plugin en `Tools > Plugins`
* Activar el cifrado en una conversación con un contacto que también tiene OMEMO activado.
### Salón de discusión
Para crear un salón de discusión (Multi-user chat) en tu servidor YunoHost, utiliza el ID nombredelsalon@muc.dominio.tld (donde dominio.tld es el dominio principal de tu servidor).
Si utilizas un nombre de dominio personal, es necesario [añadir una redirección de tipo CNAME para el subdominio `muc.`](/dns_config) en tu servidor DNS.
### VoIP y videoconferencias
Un buen medio de llamar a un contacto XMPP en VoIP o en llamada video, es utilizar el cliente [Jitsi](http://jitsi.org/).

View file

@ -0,0 +1,69 @@
---
title: Chat, VoIP et réseau social avec XMPP
template: docs
taxonomy:
category: docs
routes:
default: '/XMPP'
---
![](image://XMPP_logo.png?resize=100)
YunoHost est installé par défaut avec un serveur de messagerie instantanée Metronome qui implémente le [protocole XMPP](https://fr.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol) (anciennement connu sous le nom de Jabber).
Ce protocole est déjà utilisé par des millions de personnes dans le monde - c'est un protocole ouvert. Toutes les applications basées sur XMPP sont compatibles entre elles : lorsque vous utilisez un client XMPP, vous pouvez interagir avec quiconque possède un compte XMPP.
XMPP est un protocole extensible - cela signifie que les utilisateurs peuvent configurer des « extensions » pour les salons de discussions, partager des messages et des fichiers, et passer des appels voix et vidéo en utilisant XMPP.
## Compte XMPP
Pour utiliser XMPP, il est nécessaire de disposer d'un compte dont l'identifiant prend la forme `utilisateur@votre.domaine.tld`, ainsi quun mot de passe.
Sous YunoHost, un compte XMPP est créé automatiquement pour chaque utilisateur. Les identifiants XMPP sont simplement ladresse email principale de l'utilisateur ainsi que son mot de passe.
## Se connecter à son compte XMPP YunoHost
Il existe différents types de clients pour se connecter à XMPP.
### Clients web
- [Movim](https://movim.eu)
- [ConverseJS](https://conversejs.org/)
- [Libervia/Salut à Toi](https://salut-a-toi.org/)
### Clients de bureau
- [Gajim](http://gajim.org/fr/) (Linux, Windows)
- [Dino](https://dino.im) (Linux)
- [Thunderbird](https://www.thunderbird.net/) (multi-plateformes)
- [Beagle IM](https://beagle.im/) (macOS)
- [Profanity](https://profanity-im.github.io/) (Linux)
### Clients sur mobile
- [Conversations](https://conversations.im/) (Android)
- [Xabber](http://xabber.com) (Android)
- [Movim](https://movim.eu) (Android)
- [Monal](https://monal.im/) (iOS)
- [ChatSecure](https://chatsecure.org/) (iOS)
- [Siskin IM](https://siskin.im/) (iOS)
- [Kaidan](https://www.kaidan.im/) (Ubuntu Touch / Plasma Mobile)
Voici une liste plus exhaustive des clients XMPP : [https://fr.wikipedia.org/wiki/Liste_de_clients_XMPP](https://fr.wikipedia.org/wiki/Clients_XMPP)
## Chiffrer ses conversations avec OMEMO
Il est possible de rendre les conversations plus sécurisées et privées en les chiffrant à l'aide de [OMEMO](https://xmpp.org/extensions/xep-0384.html), notamment en utilisant Gajim :
- Installez `gajim` et le plugin `gajim-omemo` ;
- Activez le plugin dans `Outils > Plugins` ;
- Activez le chiffrement dans une conversation avec un contact disposant de OMEMO.
## Salon de discussion
Pour créer un salon de discussion (Multi-user chat) sur votre serveur YunoHost, utilisez lidentifiant nomsalon@muc.domaine.tld (où domaine.tld est le domaine principal de votre serveur).
Si vous utilisez un nom de domaine personnel, il est nécessaire d[ajouter une redirection de type CNAME pour le sous domaine `muc.`](/dns_config) au niveau de votre serveur DNS.
## VoIP et visioconférence
Un moyen pratique dappeler un contact XMPP, en VoIP ou en appel vidéo, est dutiliser le client [Jitsi](http://jitsi.org/).

View file

@ -0,0 +1,71 @@
---
title: Chat, VoIP and social network with XMPP
template: docs
taxonomy:
category: docs
routes:
default: '/XMPP'
---
![](image://XMPP_logo.png?resize=100)
By default, YunoHost comes installed with an instant messaging server called Metronome which implements the [XMPP protocol](https://en.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol) (previously known as Jabber).
This protocol is already used by millions of people around the world—it is an open protocol.
All applications based on XMPP are compatible with each other: When using an XMPP client, you can interact with anybody who has an XMPP account.
XMPP is an extensible protocol—this means users can configure "extensions" to chatrooms, share messages and files, and make voice and video calls using XMPP.
## XMPP account
To use an XMPP account you need a username, in the format: `user@domain.tld`, and a password.
With YunoHost, an XMPP account is created for all YunoHost users automatically.
The XMPP account credentials corresponds to the user's main e-mail address and password.
## Connecting to your YunoHost XMPP account
You can connect to your YunoHost XMPP account in different ways.
### Web clients
- [Movim](https://movim.eu)
- [ConverseJS](https://conversejs.org/)
- [Libervia/Salut à Toi](https://salut-a-toi.org/)
### Desktop clients
- [Gajim](https://gajim.org/) (Linux, Windows)
- [Dino](https://dino.im) (Linux)
- [Thunderbird](https://www.thunderbird.net/fr/) (multiplatform)
- [Beagle IM](https://beagle.im/) (macOS)
- [Profanity](https://profanity-im.github.io/) (Linux)
### Mobile clients
- [Conversations](https://conversations.im/) (Android)
- [Xabber](https://xabber.com) (Android)
- [Movim](https://movim.eu) (Android)
- [ChatSecure](https://chatsecure.org/) (iOS)
- [Monal](https://monal.im/) (iOS)
- [Siskin IM](https://siskin.im/) (iOS)
- [Kaidan](https://www.kaidan.im/) (Ubuntu Touch / Plasma Mobile)
Here is an exhaustive list of XMPP clients: https://xmpp.org/software/clients.html
## Encrypt conversations with OMEMO
XMPP chats can be made secure and private using [OMEMO encryption](https://xmpp.org/extensions/xep-0384.html), for instance using Gajim:
- Install `gajim` and the plugin `gajim-omemo`.
- Turn on the plugin in `Tools > Plugins`.
- Turn on the encryption in the chat with somebody who also has OMEMO.
## Chatrooms
To create a chatroom (multi-user chat) on your YunoHost server, use the identifier `chatroomname@muc.yourdomain.tld`.
For this to work you need to [add the corresponding `muc.` DNS record](/dns_config) in the DNS configuration.
## VoIP and videoconferences
A practical tool to call an XMPP client, either with voice or voice+video, is to use the [Jitsi](https://jitsi.org/) client.

Some files were not shown because too many files have changed in this diff Show more