Guide d'utilisation
v0.3 (19 nov 2018)
Introduction
Matrix héberge désormais les discussions de la communauté de l'Assemblée Virtuelle, en remplacement de Slack. Un serveur Matrix est auto-hébergé sur le serveur de l'association, et répond au nom de domaine matrix.virtual-assembly.org.
Le principe de Matrix repose sur une juxtaposition de « salons », répartis sur une fédération de serveurs et qui sont tous indépendants les uns des autres (et non hiérarchisés). Ces salons peuvent être regroupés au sein de communautés[^1] (groupes) qui agissent comme des filtres sur l'ensemble des salons de la fédération Matrix. Un salon peut appartenir à plusieurs communautés. A chaque communauté correspond au moins un salon. Par convention, nous donnons à celui-ci le même nom que la communauté correspondante.
Ainsi existe une communauté General, qui comprend à ce jour deux salons : General et Reception.
Outils d'accès aux salons
Pour accéder aux conversations de la fédération Matrix (et plus particulièrement dans notre cas de l'Assemblée Virtuelle) vous devez choisir un logiciel client, dont il existe une liste accessible sur cette page : Matrix clients. Pour notre part, nous recommandons Riot qui est disponible à la fois comme application de bureau, application web et application mobile. C'est actuellement l'application la plus mature pour accéder à Matrix.
Dans la suite du document, nous parlerons uniquement de Riot. Les autres clients ne sont pas documentés ici pour l'instant.
- Si vous utilisez l'interface web de Riot, rendez-vous à l'adresse suivante :
Communauté Assemblée Virtuelle. Vous arriverez alors sur une page présentant les salons de la communauté General.
- Pour télécharger l'application de bureau, c'est ici : Télécharger Riot
- Si vous préféreez l'application mobile, rendez vous sur le store iOS ou Android
Pour pouvoir accéder aux discussions de la communauté, il est nécessaire d'avoir un compte sur Matrix, peu importe le serveur sur lequel vous êtes inscrit. Attention, toutefois, votre expérience utilisateur pourrait être différente en fonction de votre compte (cf. Configuration)
Création de compte
Lorsque vous ouvrez votre client et que vous voulez rejoindre une communauté ou accéder à un salon, il vous est demandé de créer un compte, à moins que vous ne soyez déjà inscrit quelque part sur le réseau Matrix.
Toutefois, avoir un compte sur le serveur matrix.virtual-assembmly.org vous offira plus de confort dans l'utilisation des salons, et en premier lieu améliorera les fonctions de navigation, de recherche et de découverte.
La première chose à vérifier pour créer un compte sur notre serveur, c'est que vous êtes connu de l'équipe sysadmin de l'Assemblée. Si vous étiez sur Slack, ou que vous êtes de puis longtemps au contact de l'Assemblée, il est probable que ce soit le cas. Sinon, adressez-vous à quelqu'un de l'Assemblée que vous connaissez, afin qu'il avertisse l'équipe sysadmin que vous êtes autorisé à avoir accès aux salons de l'Assemblée Virtuelle[^2]. Vous recevrez très rapidement une notification pour créer votre compte.
Suivant la page sur laquelle vous êtes, vous pouvez voir deux invitations différentes. La différence entre « Rejoindre la communauté » et « Rejoindre le salon » est que, dans le premier cas, vous verrez apparaître l'icône de la communauté dans la colonne latérale à l'extrême gauche de la fenêtre. Vous pouvez faire partie d'autant de communautés que vous le souhaitez et celles-ci vous sépareront visuellement les salons selon différents domaines d'intérêt.
Pour le reste, la procédure d'inscription est la même dans les deux cas.
Attention : sur l'interface web, vous verrez apparaître une fenêtre « pop-up » ; cliquez alors sur « sélectionner un autre serveur »
Pour créer un compte, remplissez le formulaire ainsi :
- Indiquer votre adresse éléctronique[^3], mais...
- ... ne remplissez pas le champ Téléphone (ceci empêcherait votre compte de fonctionner correctement).
- Choisissez un pseudonyme et un mot de passe
- Avant de cliquer sur S'inscrire :
- Vous devez choisir le serveur qui hébergera votre compte ->
* le Serveur par défaut est sur le domaine https://matrix.org
* le Serveur personnalisé, celui de l'Assemblée Virtuelle (nous vous conseillons fortement de choisir cette option).
- Pour l'URL du service d'accueil, indiquez : https://matrix.virtual-assembly.org
- Pour l'URL du serveur d'identité, laissez la valeur par défaut : https://vector.im
- Choisissez la langue de l'interface
- Vous pouvez maintenant cliquer sur S'inscrire
Remplir le formulaire en donnant votre adresse électronique indique votre appartenance (ou non) à l'Assemblée Virtuelle (les adresses ont été reprises depuis Slack).
Une fois connecté, vous pouvez rejoindre les différents salons, dont les icônes s'ajouteront dans la colonne de gauche et que vous pouvez ensuite trier par priorité.
Les identifiants des salons et des communautés sont normalisés comme suit :
|--------------|--------------------------------------------|
| salon | #{nom du salon}:{serveur de chat} |
|--------------|--------------------------------------------|
| communauté | +{nom de la communauté}:{serveur de chat} |
|--------------|--------------------------------------------|
Ainsi le salon Ontologies a pour identifiant :
#ontologies:matrix.virtual-assembly.org
Pour y accéder depuis le web, il faut ajouter le radical
https://riot.im/app/# suivi de /group ou /room selon les cas.
e.g. : https://riot.im/app/#/room/#ontologies:matrix.virtual-assembly.org
Interface
Barre d'Outils
En bas à gauche de la fenêtre de Riot, vous trouvez une barre d'outils qui vous permet, de gauche à droite
- Ajouter une communauté à la liste existante
- Revenir sur la page d'accueil de Riot
- Entamer une discussion personnelle avec une personne[^4]
- Afficher le répertoire des salons
- Créer un nouveau salon
- Paramètres de votre profil personnel
Attention : Le répertoire des salons que vous voyez dépend du serveur Matrix sur lequel vous avez votre compte. Si c'est sur l'instance de l'Assemblée Virtuelle, tout ira bien, sinon vous verrez la liste des salons de matrix.org, ce qui ne vous sera pas d'une grande utilité, d'autant que vous ne pourrez pas faire de recherche.
Utilisation
Mentions
- Pour mentionner une personne dans une conversation, insérez l'annotation "@pseudo_de_la_personne" (comme dans Slack)
- Vous pouvez mentionner toutes les personnes inscrites sur le salon avec l'annotation "@room".
- Vous pouvez mentionner un (autre) salon dans une conversation en faisant précéder son nom d'un croisillon "#".
- Vous pouvez faire mention d'un communauté dans une conversation en préfixant son nom avec le signe “+”.
Bonnes pratiques
- Ne laissez pas votre avatar vide, et mettez une image facilement discernable.
Notes
- « communauté » est le terme utilisé par Riot, alors que Matrix définit des « groupes »
- La procédure doit encore être validée
- Si vous déjà étiez inscrit sur Slack, veillez à reprendre l'adresse électronique que vous y utilisez.
- L'équivalent des messages directs de Slack.
