Merge branch 'master' of albakham/drycat-wiki into master
BIN
docs/assets/img/matrix/matrix-register.png
Normal file
After Width: | Height: | Size: 801 KiB |
BIN
docs/assets/img/riot/riot-encryption.png
Normal file
After Width: | Height: | Size: 13 KiB |
BIN
docs/assets/img/riot/riot-explained.png
Normal file
After Width: | Height: | Size: 360 KiB |
BIN
docs/assets/img/riot/riot-home.png
Normal file
After Width: | Height: | Size: 236 KiB |
BIN
docs/assets/img/riot/riot-integration.png
Normal file
After Width: | Height: | Size: 10 KiB |
BIN
docs/assets/img/riot/riot-integrations.png
Normal file
After Width: | Height: | Size: 62 KiB |
BIN
docs/assets/img/riot/riot-invite.png
Normal file
After Width: | Height: | Size: 26 KiB |
|
@ -1,3 +1,55 @@
|
|||
title: Matrix - Documentation utilisateur - WIki - DryCat.fr
|
||||
description: Une présentation du fonctionnement de Matrix pour un utilisateur.
|
||||
|
||||
# Documentation utilisateur de Matrix
|
||||
|
||||
## Qu'est ce que c'est ?
|
||||
|
||||
Matrix est un protocole ouvert de communication en direct qui peut être utilisé pour faire de la messagerie instantanée mais également pour effectuer appels vocaux et vidéo conférences.
|
||||
|
||||
Voir le [site officiel](https://matrix.org)
|
||||
|
||||
Pour utiliser Matrix, on utilisera le client [Riot](https://about.riot.im) qui, étant le plus évolué, supporte actuellement le plus grand nombre de fonctionnalités.
|
||||
|
||||
## Inscription au service
|
||||
|
||||
Pour s'inscrire, il vous faudra vous rendre à l'adresse [Chat.Drycat.fr](https://chat.drycat.fr/#/register) et suivre le formulaire. En cas de soucis n'hésiter pas à demander de l'aide !
|
||||
|
||||
![](../assets/img/matrix/matrix-register.png)
|
||||
|
||||
## Clients
|
||||
|
||||
Vous trouverez ci-dessous quelques clients pour Matrix que vous pouvez utiliser sur PC ou sur mobile.
|
||||
|
||||
### Sur PC
|
||||
|
||||
[Riot](https://about.riot.im/downloads) (recommandé) est le client supportant le plus des fonctionnalités proposés par Matrix, tel que le chiffrement de obut-en-bout, les appels vidéos, etc. Il est également disponible sur Linux, Windows et MacOS
|
||||
|
||||
[Nheko](https://matrix.org/docs/projects/client/nheko.html) un client alternatif disponible sur Linux, Windows et MacOS. Il supporte partiellement le chiffrement de bout-en-bout pour les messages uniquement.
|
||||
|
||||
[Quaternion](https://matrix.org/docs/projects/client/quaternion.html) disponible sur Linux, Windows et MacOS
|
||||
|
||||
### Sur mobile
|
||||
|
||||
[Riot](https://about.riot.im), le client web que vous utilisez sûrement est aussi disponible sur Android et iOS:
|
||||
|
||||
[Riot pour Android](https://f-droid.org/fr/packages/im.vector.alpha/)
|
||||
|
||||
[Riot pour iOS](https://itunes.apple.com/fr/app/riot-open-source-team-collaboration/id1083446067)
|
||||
|
||||
### Autres
|
||||
|
||||
[Cette page](https://matrix.org/docs/projects/clients-matrix) recense la totalité des clients supportant le protocole Matrix en détaillant leur disponibilité par platerforme et des détails quand aux fonctionnalités supportés.
|
||||
|
||||
### Configuration du Client
|
||||
|
||||
Pour utiliser le serveur de Drycat sur votre client favori, il vous faudra rentrer son adresse dans celui-ci, le plus souvent dans la catégorie `Avancé`.
|
||||
|
||||
Homeserver: https://matrix.drycat.net/
|
||||
|
||||
Identity Server: https://vector.im
|
||||
|
||||
|
||||
## Utilisation
|
||||
|
||||
Je vous invite à lire [la documentation utilisateur de Riot](https://wiki.drycat.fr/riot/users/) pour une démonstration de son utilisation
|
|
@ -15,14 +15,15 @@ La fédération est le terme clé définissant le fonctionnement de Miaou et de
|
|||
|
||||
### Concrétement, comment cela fonctionne ?
|
||||
|
||||
Prennons comme exemple Julie, Maxime, Damien et Nathalie.
|
||||
Prenons comme exemple Julie, Maxime, Damien et Nathalie.
|
||||
|
||||
- Damien et Nathalie sont sur l'instance A
|
||||
- Julie est sur l'instance B
|
||||
- Maxime est sur l'instance C
|
||||
|
||||
Damien voit ce que Nathalie poste et inversement car ils sont sur la même instance. Mais grâce à la fédération, Julie et Maxime voient également ce que Damien et Nathalie postent (et inversement).
|
||||
Maintenant l'instance A est indisponible car elle subit une longue mise à jour. Damien et Nathalie ne peuvent plus accéder à la fédération. Mais Julie et Maxime peuvent toujours communiquer entre eux deux et envoyer des messages à Damien et Nathalie qui ne recevront le message que quand l'instance sera de nouveau disponible.
|
||||
Damien voit ce que Nathalie poste et inversement car ils sont sur la même instance. Mais grâce à la fédération, Julie et Maxime voient également ce que Damien et Nathalie postent (et inversement).
|
||||
|
||||
Maintenant l'instance A est indisponible car elle subit une longue mise à jour. Damien et Nathalie ne peuvent plus accéder à la fédération. Mais Julie et Maxime peuvent toujours communiquer entre eux deux et envoyer des messages à Damien et Nathalie, qui ne recevront le message que lorsque l'instance sera de nouveau disponible.
|
||||
|
||||
## Inscription au service
|
||||
|
||||
|
@ -61,7 +62,7 @@ Différents thèmes sont disponibles dans les paramètres selon les goûts et le
|
|||
### Tooter
|
||||
|
||||
!!! info
|
||||
Il est recommandé de commencer son premier toot par le tag `#introduction` et de vous y présenter aux autres membres de l'instance qui vous accueilleront chaleuresement !
|
||||
Il est recommandé de commencer son premier toot par le tag `#introduction` et de vous y présenter aux autres membres de l'instance qui vous accueilleront chaleureusement !
|
||||
|
||||
Pour écrire votre premier «toot», écrivez simplement votre message dans l'encadré dédié à la composition et cliquez sur le bouton «Miaou».
|
||||
|
||||
|
|
|
@ -0,0 +1,92 @@
|
|||
title: Riot - Documentation utilisateur - WIki - DryCat.fr
|
||||
description: Une présentation du fonctionnement de Riot pour un utilisateur.
|
||||
|
||||
# Documentation utilisateur de Riot
|
||||
|
||||
## Qu'est ce que c'est ?
|
||||
|
||||
[Riot](https://about.riot.im) est le client web qui vous permet d'utiliser Matrix. C'est l'interface avec laquelle vous intéragirez pour communiquer avec vos contacts sur Matrix.
|
||||
|
||||
## Utilisation
|
||||
|
||||
Vous pouvez téléchargez le client sur votre ordinateur où utilisez l'instance [Chat.Drycat.fr](https://chat.drycat.fr) accessible depuis votre navigateur.
|
||||
|
||||
### Interface
|
||||
|
||||
![](../assets/img/riot/riot-home.png)
|
||||
|
||||
Bien qu'ayant un style assez semblable à celui de Discord, le logiciel peut-être un peu déroutant au premier abord, nottament dû à la présence du [Chiffrement de bout-en-bout (E2EE)](https://fr.wikipedia.org/wiki/Chiffrement_de_bout_en_bout).
|
||||
|
||||
___
|
||||
|
||||
Voici une petite explication de l'organisation de l'interface de Riot :
|
||||
|
||||
![](../assets/img/riot/riot-explained.png)
|
||||
|
||||
#### Légende :
|
||||
|
||||
**1** - C'est l'endroit où apparaissent les messages que les membres d'un salon postent.
|
||||
|
||||
**2** - Listes des différentes conversations et salons dont vous faites partie.
|
||||
|
||||
**3** - Listes des membres du salon
|
||||
|
||||
**4** - Fonctionnalités relatives aux «Communautés»
|
||||
|
||||
**5** - Zone de composition de vos messages
|
||||
|
||||
**6** - Menu des Paramètres et de Déconnexion
|
||||
|
||||
**7** - Rechercher parmis les salons
|
||||
|
||||
**8** - Icône et description du salon
|
||||
|
||||
**9** - Options, fonctionnalités et catégorie relatives à la gestion du salon
|
||||
|
||||
### Salons
|
||||
|
||||
#### Inviter des utilisateurs
|
||||
|
||||
!!! info
|
||||
Sur Drycat, votre pseudo est de la forme `@votrepseudo:matrix.drycat.fr`.
|
||||
|
||||
Si vous souhaitez démarrer une conversation avec une connaissance, dans la liste de vos salons cliquez sur le **+** situé à côté de la catégorie «PERSONNES».
|
||||
|
||||
Une fenêtre va s'ouvrir, renseignez l'identifiant Matrix de la forme `@pseudo:serveur.matrix.ici`, le nom ou l'adresse E-mail de votre ou de vos différent⋅e⋅s correspondant⋅e⋅s.
|
||||
|
||||
Une fois cela effectué, cliquez sur le bouton «Commencer une discussion».
|
||||
|
||||
![](../assets/img/riot/riot-invite.png)
|
||||
|
||||
|
||||
Lorsque vous souhaitez discuter de façon privée avec un autre membre d'un salon dont vous faites partie, vous pouvez directement l'inviter dans une «Discussion Directe». Pour ce faire :
|
||||
|
||||
- Cliquez sur l'icône de son profil (à gauche de l'un de ses messages)
|
||||
- Le profil de l'utilisateur va s'ouvrir sur la droite.
|
||||
- Cliquez alors sur «Commencer une discussion» dans la catégorie DISCUSSIONS DIRECTES
|
||||
|
||||
#### Intégrer des widgets
|
||||
|
||||
Il est possible d'intégrer des «widgets» dans un salon, par exemple un bot qui poste le contenu d'un flux RSS, une conférence Jitsi, une musique de Spotify, etc.
|
||||
|
||||
Sélectionnez simplement l'icône en forme de carré dans les Options relatives à la gestion du Salon (n° **9** de la légende) :
|
||||
|
||||
![](../assets/img/riot/riot-integration.png)
|
||||
|
||||
Une menu vous demandant de sélectionner l'intégration que vous souhaitez ajouter va alors apparaître. Faites votre choix :)
|
||||
|
||||
![](../assets/img/riot/riot-integrations.png)
|
||||
|
||||
### Chiffrement
|
||||
|
||||
Le support du chiffrement de bout-en-bout à quelques contraintes qu'il vous faut connaître :
|
||||
|
||||
- Pour éviter qu'un appareil compromis puisse permettre d'accéder à vos messages privés, chaque session depuis un appareil va générer de nouvelles clés
|
||||
- Dans l'état actuel des choses, il faut faire une «Vérification» de chaque appareil de votre correspondant
|
||||
- Il vous faudra faire attention à gérer une liste d'appareils «propre», si chaque session en ajoute un cela peut vite amener à des vérifications de vos appareils laborieuses pour vos contact.
|
||||
|
||||
Ainsi essayez de mettre Riot en liste blanche si vous supprimez les cookies de votre navigateur régulièrement pour ne pas avoir à initier de nouvelle session (sauf sur un appareil non-sûr) ou préférez utiliser le client dédié.
|
||||
|
||||
![](../assets/img/riot/riot-encryption.png)
|
||||
|
||||
Le chiffrement d'un salon s'active dans les paramètres de celui-ci, il vous faut simplement cocher la case réservé à cet usage.
|