# Manuel utilisateur
Une courte introduction à l’utilisation de Matrix et des clients Riot (web et mobile).
# Introduction
Matrix est un protocole de discussion décentralisée (« fédérée ») open source. Un serveur Matrix est un noeud dans un réseau d’autres serveurs. Par conséquent, les utilisateurs d’un serveur donné ont la possibilité de participer à des salons de discussion hébergés sur d’autres serveurs, créant ainsi le réseau Matrix.
[[https://matrix.org/blog/home|Une présentation schématique (scroller bieeeen tout en bas)]]
# Notre installation
Nous disposons d’un serveur Matrix hébergé sur [[https://temptest.draak.fr:8448]] (normalement cette adresse donne une erreur « no such resource » sur un navigateur), et une version du client web « Riot.im » pour Matrix à [[https://temptest.draak.fr:8080]].
À noter que le client web est une option parmis beaucoup (à divers degrés de maturité). [[https://matrix.org/docs/projects/try-matrix-now.html|Une liste (presque) complète peut être consultée ici]].
# Connexion
Navigateur web (non mobile)
Naviguer vers [[https://temptest.draak.fr:8080]]. La page de connexion s’ouvre.
Laisser la sélection sur « serveur par défaut, qui est paramétré pour notre serveur propre.
Entrer le nom et le mot de passe qui a été fourni, et valider.
Clients mobiles
Il existe un client Riot pour iOS et Android, sur leurs stores respectifs.
Sur la fenêtre de connexion, afficher les « réglages avancés ». Par défaut le serveur de connexion est Matrix.org, il faut le changer en [[https://temptest.draak.fr:8448]]. Ne pas changer le server d’identité.
Valider.
# Quelques concepts
Les discussions sont centrées autour de salons, que les utilisateurs rejoignent.
Il est généralement possible pour un arrivant tardif à un salon de lire ce qui a été dit avant son arrivée.
Les salons sont soit publics, soit sur invitation (voir aussi [[matrix:manuel_utilisateur|Manuel utilisateur#Créer un salon]]).
# Alias
Les salons et les utilisateurs possèdent des alias pour les identifier.
Un salon prend le format ''#nom_du_salon:nom_du_serveur'', par exemple ''#general:temptest.draak.fr''.
Les utilisateurs, similairement, sont ''@nom_utilisateur:nom_du_serveur_accueil'', par exemple ''@karthanistyr:temptest.draak.fr''.
# Créer un salon
Dans un navigateur, créer un salon avec le bouton ➕ en bas de la colonne de gauche.
Sur mobile, on peut créer un salon depuis l’onglet salons #.
Attention: les options de confidentialité du salon affectent comment les participants le rejoignent. On préfère les salons sur invitation, ce qui empêche des utilisateurs extérieurs de les rejoindre (sauf invitation bien sur), ce qui est idéal pour notre intimité à tous.
Il est déconseillé de « lister le salon publiquement », car il devient découvrable depuis l’extérieur.
Une fois le salon créé, penser à inviter les participants souhaités via leur nom (voir ci-dessus pour le format).
# Formatage
On peut formater le texte avec [[http://commonmark.org/help/|Markdown]].
# Mentions
On peut attirer l’attention de quelqu’un en le « mentionnant ». Insérer le signe @ dans la boîte de texte déclenche l’auto complétion des noms. Puis sélectionner l’individu insère la mention dans le message. Il ne reste plus qu’à ecrire le reste du message.