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>

pages/01.administer/06.admin_overview/05.users/04.xmpp/XMPP.es.md

@@ -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).

pages/01.administer/06.admin_overview/05.users/04.xmpp/XMPP.fr.md

@@ -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).

pages/01.administer/06.admin_overview/05.users/04.xmpp/XMPP.md

@@ -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).

pages/02.user_guide/04.xmpp/XMPP.es.md

@@ -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/).

pages/02.user_guide/04.xmpp/XMPP.fr.md

@@ -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 qu’un mot de passe.
+
+Sous YunoHost, un compte XMPP est créé automatiquement pour chaque utilisateur. Les identifiants XMPP sont simplement l’adresse 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 l’identifiant 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 d’appeler un contact XMPP, en VoIP ou en appel vidéo, est d’utiliser le client [Jitsi](http://jitsi.org/).

pages/02.user_guide/04.xmpp/XMPP.md

@@ -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.