• Afficher la page
  • Anciennes révisionsLiens de retour

    • Différences

    Ci-dessous, les différences entre deux révisions de la page.

    Lien vers cette vue comparative

    Les deux révisions précédentesRévision précédente
    Prochaine révision    		Révision précédente
    Dernière révisionLes deux révisions suivantes
    tuto_utiliser_matrix_au_quotidien [2020/09/17 23:21] – colonia2017tuto_utiliser_matrix_au_quotidien [2021/10/04 13:59] – [Pont Matrix-Discord] barbier2016
    Ligne 1: Ligne 1:
    -====== Prise en main de Matrix et Element (anciennement Riot) ======+====== Prise en main rapide d'Element (anciennement Riot) ======
      
    -===== Résumé pour utiliser element avec un compte créé par Arise ===== 
     **Salon d'aide** : **#matrix:iiens.net** **Salon d'aide** : **#matrix:iiens.net**
    -  * **Pour se connecter à Element** : +  * **Se connecter sur Element** : 
         * Se rendre sur le site https://chat.iiens.net (anciennement https://riot.iiens.net) :     * Se rendre sur le site https://chat.iiens.net (anciennement https://riot.iiens.net) :
         * Le bon serveur d'accueil est déjà défini (matrix.iiens.net).     * Le bon serveur d'accueil est déjà défini (matrix.iiens.net).
         * Pour se connecter utiliser vos identifiants Arise (nomAnnéedePromo).     * Pour se connecter utiliser vos identifiants Arise (nomAnnéedePromo).
    -  * **Pour rejoindre un salon** :  +  * **Rejoindre un salon** :  
    -    * **/join #nom_du_salon:nom_du_serveur** dans n'importe quel tchat  +    * <code bash> /join #nom_du_salon:nom_du_serveur </code> 
    -    * Cas particulier d'un salon IRC d'Arise :  +    * Cas particulier pour rejoindre un salon IRC, deux # :  
    -      * **/join ##nom_du_salon:iiens.net** n'oubliez pas les deux #. +      * <code bash> /join ##nom_du_salon:iiens.net </code>
    -      * Exemple : /join ##ensiie:iiens.net+
       * **Envoyer un message privé** :     * **Envoyer un message privé** :  
    -    * L'id d'une personne est écrit comme ceci : **@id:nom_du_serveur** +    * L'id d'une personne s'écrit de cette façon : **@id:nom_du_serveur**. La manière d'envoyer un message diffère sur pc ou sur mobile.
         * Sur pc :      * Sur pc : 
    -      * Utiliser le bouton + près de la rubrique **Personnes** et entrez l'id de la personne à contacter. Cela créera un salon privé entre vous et le destinataire. Exemple : **@miryuni:iiens.net**+      * Utiliser le bouton + près de la rubrique **Personnes** et entrez l'id de la personne à contacter (Exemple : **@pseudo:iiens.net**). Cela créera un salon privé entre vous et le destinataire.
         * Sur mobile :      * Sur mobile : 
           * Utiliser le gros bouton vert "+", puis "Commencer une discussion"         * Utiliser le gros bouton vert "+", puis "Commencer une discussion"  
    -      * Entrez l'id de la personne. Exemple : **@miryuni:iiens.net** +      * Entrez l'id de la personne.
    -  * **Créer une communauté** :  +
    -    * Une communauté est écrit comme ceci: **+id:nom_du_serveur** +
       * **Afficher plus de commande en écrivant "/" dans un tchat.**   * **Afficher plus de commande en écrivant "/" dans un tchat.**
      
    Ligne 34: Ligne 30:
       * **Pour inviter un utilisateur d'irc dans un salon**    * **Pour inviter un utilisateur d'irc dans un salon** 
         * Attention à n'utiliser que les commandes de ChanServ sinon il ne //pourra pas rejoindre le salon//.     * Attention à n'utiliser que les commandes de ChanServ sinon il ne //pourra pas rejoindre le salon//.
     +  * **Le pseudo sur IRC**
     +    * Ne changez pas de pseudo sur irc avec la commande !nick, cela désynchronisera **pour toujours** votre pseudo matrix et irc. Utilisez la commande /nick ou changez votre pseudo via les paramètres de l'interface graphique. 
       * **Se dépoiraliser** : Aller dans un salon lié à irc (possédant deux #) puis:   * **Se dépoiraliser** : Aller dans un salon lié à irc (possédant deux #) puis:
         * /myroomnick <peu importe> -> /myroomnick <votre pseudo> -> mp Nickserv en envoyant: "identify <votre mot-passe>"     * /myroomnick <peu importe> -> /myroomnick <votre pseudo> -> mp Nickserv en envoyant: "identify <votre mot-passe>"
    Ligne 39: Ligne 37:
     ====== Présentation ====== ====== Présentation ======
      
    -Matrix est un protocole de communication décentralisé. Son architecture est similaire à celle des mails. Chacun peut choisir le serveur qu'il souhaite et tout les serveurs peuvent communiquer entre eux. Sauf cas exceptionnel où un serveur l'empêche explicitement. +Matrix est un protocole de communication en temps réel décentralisé possédant une architecture similaire à celle des mails. Lorsqu'on envoie un mail à une personne, on ne se soucie pas de savoir si son serveur sur lequel il a créé son compte est le même que le notre (gmail, outlook, etc...). De la même manière dans Matrix, chaque personne peut choisir le serveur sur lequel il souhaite s'inscrire, et peut interagir avec une autre personne sans se préoccuper de son serveur (sauf cas exceptionnel où un serveur l'empêche explicitement).
      
     Matrix est disponible aussi bien sur pc (sous forme web ou bien desktop) que sur mobile (pour Android et IOS). Matrix est disponible aussi bien sur pc (sous forme web ou bien desktop) que sur mobile (pour Android et IOS).
     +===== Matrix, Element, Riot, IRC, c'est quoi tout ça? =====
     On entend souvent les termes Matrix, Riot, Element, IRC à l'école. Précisons tout cela. Element est un client reposant sur le protocole Matrix. C'est pour cela qu'il est courant de confondre les deux dans le langage courant. IRC est aussi un protocole mais complètement différent du protocole Matrix. Nous faisons la confusion IRC <-> Matrix/Element car il est possible de communiquer d'un protocole à un autre très facilement. Quand à Riot, c'est tout simplement l'ancien nom de Element.  On entend souvent les termes Matrix, Riot, Element, IRC à l'école. Précisons tout cela. Element est un client reposant sur le protocole Matrix. C'est pour cela qu'il est courant de confondre les deux dans le langage courant. IRC est aussi un protocole mais complètement différent du protocole Matrix. Nous faisons la confusion IRC <-> Matrix/Element car il est possible de communiquer d'un protocole à un autre très facilement. Quand à Riot, c'est tout simplement l'ancien nom de Element. 
     +===== Les bridges =====
     Matrix permet aussi de réaliser des "bridges". Cela permet de transporter les messages "Matrix" à un autre système de messagerie. Un bridge pour IRC est notamment disponible et permet de discuter de manière quasi transparente entre utilisateurs d'IRC et de Matrix. Matrix permet aussi de réaliser des "bridges". Cela permet de transporter les messages "Matrix" à un autre système de messagerie. Un bridge pour IRC est notamment disponible et permet de discuter de manière quasi transparente entre utilisateurs d'IRC et de Matrix.
      
    Ligne 69: Ligne 67:
     ====== Prise en main ====== ====== Prise en main ======
      
    -L'interface de Riot est plutôt classique, la plupart des fonctionnalités que l'on peut attendre d'une application de messagerie moderne sont présentes.+L'interface d'Element est plutôt classique. La plupart des fonctionnalités que l'on peut attendre d'une application de messagerie moderne sont présentes.
      
     ===== Installation et connexion ===== ===== Installation et connexion =====
      
    -**Element** est disponible sur **Android** et **IOS** via les app store ou en version web sur https://chat.iiens.net. Un client desktop est aussi disponible : https://element.io/get-started.+**Element** est disponible sur **Android** et **IOS** via les app store ou en version web sur https://chat.iiens.net. Un client desktop est aussi téléchargeable sur https://element.io/get-started.
      
       *Note : pour Android, il existe une version d'Element disponible sur F-Droid qui n'utilise pas les services Google. Attention, le système de notification nécessite alors de faire régulièrement des requêtes, ce qui impacte la consommation d'énergie. Il y a aussi cette interface alternative à Element android : https://f-droid.org/fr/packages/de.spiritcroc.riotx/   *Note : pour Android, il existe une version d'Element disponible sur F-Droid qui n'utilise pas les services Google. Attention, le système de notification nécessite alors de faire régulièrement des requêtes, ce qui impacte la consommation d'énergie. Il y a aussi cette interface alternative à Element android : https://f-droid.org/fr/packages/de.spiritcroc.riotx/
    Ligne 89: Ligne 87:
      
     Si vous voulez vous identifier, il faut MP @irc_NickServ:iiens.net et écrire : IDENTIFY <mdp> <mail> Si vous voulez vous identifier, il faut MP @irc_NickServ:iiens.net et écrire : IDENTIFY <mdp> <mail>
     +
     +**Attention, depuis les dernières versions de Matrix, les MP sont par défaut chiffrés et le bot ne peut donc pas lire vos messages.  
     +Il faut donc créer un salon vide non chiffré puis inviter le bot, qui rejoindra automatiquement. **
      
     Vous pouvez aussi utiliser "!nick <pseudo>" dans la conversation avec le bot (@_irc_bot:iiens.net). Attention, cela ne change le pseudo que côté IRC sans toucher à celui de Matrix, et à partir de ce moment la synchro automatique avec le pseudo matrix est désactivée. Vous pouvez aussi utiliser "!nick <pseudo>" dans la conversation avec le bot (@_irc_bot:iiens.net). Attention, cela ne change le pseudo que côté IRC sans toucher à celui de Matrix, et à partir de ce moment la synchro automatique avec le pseudo matrix est désactivée.
     +
     +
      
     "/myroomname <pseudo>" peut aussi être utilisé. Cela ne change le pseudo que sur la room actuelle côté matrix. Par contre si jamais cette room est bridgée vers IRC, le bridge va détecter le changement et utiliser ce pseudo côté IRC aussi (sur toutes les rooms bridgées, on peut donc avoir sur certaines room un pseudo différent côté IRC et côté matrix). Cela ne désactive pas la synchro automatique avec le pseudo matrix si jamais il change. "/myroomname <pseudo>" peut aussi être utilisé. Cela ne change le pseudo que sur la room actuelle côté matrix. Par contre si jamais cette room est bridgée vers IRC, le bridge va détecter le changement et utiliser ce pseudo côté IRC aussi (sur toutes les rooms bridgées, on peut donc avoir sur certaines room un pseudo différent côté IRC et côté matrix). Cela ne désactive pas la synchro automatique avec le pseudo matrix si jamais il change.
    Ligne 124: Ligne 127:
      
       * **Pour en ajouter** :    * **Pour en ajouter** : 
    -    * Paramètres -> notifications -> Messages contenant des mots-clés -> cliquer sur "mots-clés" et en ajouter séparés par une virgule. Régler ses notifications sur **bruyantes** (sinon le mot clé ne fonctionnera pas). +    * Paramètres des notifications -> Messages contenant des mots-clés -> cliquer sur "mots-clés" en vert. Ajoutez les en les séparant par une virgule. Régler ses notifications sur **Sonore** sinon le mot clé ne fonctionnera pas. 
      
     Les messages contenant un mot clé seront ainsi de la même forme qu'une mention sans auto-complétion. Les messages contenant un mot clé seront ainsi de la même forme qu'une mention sans auto-complétion.
    Ligne 148: Ligne 151:
     Exemple pour **#agora** avec le client web riot : Exemple pour **#agora** avec le client web riot :
      
    -https://riot.im/develop/#/room/##agora:iiens.net+https://chat.iiens.net/develop/#/room/##agora:iiens.net
      
     Dans un salon de discussion, écrire **#nom_du_salon:id_du_serveur** fait un lien cliquable pour le rejoindre. Dans un salon de discussion, écrire **#nom_du_salon:id_du_serveur** fait un lien cliquable pour le rejoindre.
    Ligne 188: Ligne 191:
     {{:tutos/liste_salon_comm.jpg| Exemple accueil communauté}} {{:tutos/liste_salon_comm.jpg| Exemple accueil communauté}}
      
    -Note : rejoindre un salon appartenant à une communauté n'implique pas de faire partie de cette même communauté. En revanche, il pourra voir que le salon appartient à cette communauté et donc obtenir en l'identifiant dans les paramètres du salon dans la section //badge//. Pour éviter cela, supprimez le badge du salon (n'a aucun impact, sauf peut-être cosmétique) ou passez la communauté sur //invitation seulement//.+  *//Note// : rejoindre un salon appartenant à une communauté n'implique pas de faire partie de cette même communauté. En revanche, il pourra voir que le salon appartient à cette communauté et donc obtenir en l'identifiant dans les paramètres du salon dans la section //badge//. Pour éviter cela, supprimez le badge du salon (n'a aucun impact, sauf peut-être cosmétique) ou passez la communauté sur //invitation seulement//.
      
     Page d'accueil de communauté sur mobile : Page d'accueil de communauté sur mobile :
      
    -{{:tutos/accueil_comm_tel.jpg| Exemple accueil communauté}}+{{:tutos/accueil_comm_tel.jpg?270x480| Exemple accueil communauté}}
      
     Sur pc, accueil et salons : Sur pc, accueil et salons :
    Ligne 206: Ligne 209:
     Salons disponibles dans une communauté sur mobile : Salons disponibles dans une communauté sur mobile :
      
    -{{:tutos/salon_comm_tel.png| Exemple salons communauté}}+{{:tutos/salon_comm_tel.png?270x400| Exemple salons communauté}}
      
     Une communauté peut être rejointe par invitation ou par lien. Un lien de communauté aura la forme suivante : Une communauté peut être rejointe par invitation ou par lien. Un lien de communauté aura la forme suivante :
    Ligne 212: Ligne 215:
     https:%%//%%lien.du.client/#/group/+id_du_groupe:nom_du_serveur https:%%//%%lien.du.client/#/group/+id_du_groupe:nom_du_serveur
      
    -====== Administration de salon et communauté / groupe ======+====== Administrer des salons et des communautés / groupes ======
      
    -**Attention**, il n'est **pas encore** possible de changer l'administrateur d'une communauté. Par conséquent, si l'admin d'une communauté est destiné à être passé à d'autres personnes, je recommande de créer la communauté avec un compte d'administration. +  * **Attention**, il n'est **pas encore** possible de changer l'administrateur d'une communauté. Par conséquent, si l'admin d'une communauté est destiné à être passé à d'autres personnes, je recommande de créer la communauté avec un compte d'administration. De plus, pour en supprimer un salon, il faut se rendre sur l'accueil de la communauté, sur la droite il y a les utilisateurs mais aussi les salons. C'est là qu'il sera possible de les supprimer.
    - +
    -De plus, pour en supprimer un salon, il faut se rendre sur l'accueil de la communauté, sur la droite il y a les utilisateurs mais aussi les salons. C'est là qu'il sera possible de les supprimer.+
      
     Pour qu'un salon de communauté puisse être rejoint par tous les utilisateurs possédant un lien, il faut impérativement que ce salon ait une adresse publiée sur le serveur sur lequel il est hébergé (exemple : ##monarchiie:iiens.net ). Si ce salon n'en a pas, il a cependant un identifiant interne de la forme : suite_de_caractères:nom_du_serveur. Pour qu'un salon de communauté puisse être rejoint par tous les utilisateurs possédant un lien, il faut impérativement que ce salon ait une adresse publiée sur le serveur sur lequel il est hébergé (exemple : ##monarchiie:iiens.net ). Si ce salon n'en a pas, il a cependant un identifiant interne de la forme : suite_de_caractères:nom_du_serveur.
    Ligne 229: Ligne 230:
     En ce qui concerne iiens.net, par défaut un créateur de salon sera modérateur et ne pourra pas activer la lecture d'historique, sauf si Arise change ça ultérieurement. En ce qui concerne iiens.net, par défaut un créateur de salon sera modérateur et ne pourra pas activer la lecture d'historique, sauf si Arise change ça ultérieurement.
      
    -===== Paramètres de salons importants dans une communauté =====+===== Précision sur les salons importants dans une communauté =====
      
     **Attention**, ajouter un salon à une communauté présente quelques spécificités importantes : **Attention**, ajouter un salon à une communauté présente quelques spécificités importantes :
    Ligne 251: Ligne 252:
     /!\ Les stickers ne sont pas visibles par les utilisateurs d'IRC /!\ /!\ Les stickers ne sont pas visibles par les utilisateurs d'IRC /!\
      
    -**Ajouter un widget** : Cliquer sur l'icone avec 4 petits carrés -> choisir son widget+  * **Ajouter un widget** :  
     +    * Cliquer sur l'icone avec 4 petits carrés -> choisir son widget
      
     Il existe de plus un widget nommé **Custom Widget**. Il prend en argument le lien d'une webapp et devrait l'afficher directement dans un widget du salon. On peut par exemple lui donner un lien étherpad provenant d'un autre hébergeur que celui par défaut et l'afficher.  Il existe de plus un widget nommé **Custom Widget**. Il prend en argument le lien d'une webapp et devrait l'afficher directement dans un widget du salon. On peut par exemple lui donner un lien étherpad provenant d'un autre hébergeur que celui par défaut et l'afficher. 
    Ligne 257: Ligne 259:
     Les widgets utilisent un serveur appelé //gestionnaire d'intégration//. Par défaut c'est celui de Matrix.org, mais il est possible de changer de gestionnaire d'intégration et d'héberger le sien : https://dimension.t2bot.io/ Les widgets utilisent un serveur appelé //gestionnaire d'intégration//. Par défaut c'est celui de Matrix.org, mais il est possible de changer de gestionnaire d'intégration et d'héberger le sien : https://dimension.t2bot.io/
      
    -En gros, pour changer de gestionnaire d'intégration, il faut un peu bidouiller le code de son client. Dans le cas de <del>Riot(X)</del> Element, il faut pour le moment recompiler l'application après avoir changé la ligne donnant le gestionnaire d'intégration +En gros, pour changer de gestionnaire d'intégration, il faut un peu bidouiller le code de son client. Dans le cas d'Element, il faut pour le moment recompiler l'application après avoir changé la ligne donnant le gestionnaire d'intégration 
      
     On en parlera probablement un jour, j'ai pas encore installé mon gestionnaire d'intégraton.  On en parlera probablement un jour, j'ai pas encore installé mon gestionnaire d'intégraton. 
      
    -====== Avec chiffrement ======+====== Activer le chiffrement sur Element ======
      
     Tout ce qui est au dessus est valable ici aussi. Tout ce qui est au dessus est valable ici aussi.
    Ligne 278: Ligne 280:
      
     **Il ne faut jamais activer le chiffrement sur un salon bridgé vers IRC**. Si c'est le cas, plus aucun messages ne circulera dans le sens Matrix vers IRC. **Il ne faut jamais activer le chiffrement sur un salon bridgé vers IRC**. Si c'est le cas, plus aucun messages ne circulera dans le sens Matrix vers IRC.
     +
     +Les MP sont depuis les dernières versions chiffrés automatiquement de bout en bout, et casse donc la communication avec IRC.
     +Pour créer un MP non chiffré, il faut créer un salon vide non chiffré et inviter l'utilisateur IRC.
      
     ===== Plusieurs contraintes ===== ===== Plusieurs contraintes =====
    Ligne 325: Ligne 330:
       * Envoyer un message dans un salon chiffré et ce message apparaîtra.   * Envoyer un message dans un salon chiffré et ce message apparaîtra.
      
    -{{:tutos/premier_message.png| Exemple avertissement}}+{{:tutos/premier_message.png?400x50| Exemple avertissement}}
      
     Cliquez sur "Afficher les appareils" pour obtenir la liste d'appareils à vérifier. Il suffit de cliquer sur "Vérifier" pour chaque appareil. Cliquez sur "Afficher les appareils" pour obtenir la liste d'appareils à vérifier. Il suffit de cliquer sur "Vérifier" pour chaque appareil.
    Ligne 333: Ligne 338:
     Il est désormais possible de vérifier avec des émojis les appareils en temps réel. L'intérêt étant que les gens ne faisant probablement pas **réellement** la vérification, il est maintenant bien plus facile pour un humain de vérifier pour de vrai des appareils.  Il est désormais possible de vérifier avec des émojis les appareils en temps réel. L'intérêt étant que les gens ne faisant probablement pas **réellement** la vérification, il est maintenant bien plus facile pour un humain de vérifier pour de vrai des appareils. 
      
    -{{:tutos/verif_emoji.png| Exemple Vérification Emoji}}+{{:tutos/verif_emoji.png?401x174| Exemple Vérification Emoji}}
      
       * Cliquer sur un utilisateur (son image de profil dans le chat ou sur lui sur la droite), la liste de ses appareils non vérifiés sera disponible.   * Cliquer sur un utilisateur (son image de profil dans le chat ou sur lui sur la droite), la liste de ses appareils non vérifiés sera disponible.
    Ligne 393: Ligne 398:
       * Web, tout dépend depuis quel site est utilisé le client. Sur tedomum.net la section est déjà disponible, de même sur riot.iiens.net. En revanche sur Riot.im, il faut utiliser riot.im/develop/ plutôt que riot.im/app/   * Web, tout dépend depuis quel site est utilisé le client. Sur tedomum.net la section est déjà disponible, de même sur riot.iiens.net. En revanche sur Riot.im, il faut utiliser riot.im/develop/ plutôt que riot.im/app/
      
    -====== Ésotérisme, random et Devtools ======+===== Pont Matrix-Discord ===== 
     + 
     +Il y a désormais un pont Matrix <-> Discord hébergé par Arise. La procédure pour l'utiliser est la suivante : 
     + 
     +  - Ajouter cette app au serveur Discord (ne pas toucher les permissions) : [[https://discord.com/oauth2/authorize?client_id=765323616010633237&scope=bot&permissions=70379520]] (il faut à priori être admin du serveur pour cela). 
     +  - Sur le channel où sera le pont **uniquement**, donner la permission //View Channel// et //Manage Webhooks// au bot (i.e. au rôle "Arise matrix bridge"). Sur tous les autres channels du serveur que vous ne voulez pas bridge, il ne doit avoir ni la permission //View Channel//, ni //Manage Webhooks//. 
     +  - Inviter **@_discord_bot:iiens.net** dans le salon Matrix (///invite @_discord_bot:iiens.net//). 
     +  - Taper //!discord help// (dans le salon Matrix) et suivre les instructions (il faut être** OP, i.e. avoir le rang 50** minimum pour que ça fonctionne). 
     +  - Aller dans le channel associé sur Discord et accepter le pont (//!matrix approve//). 
     + 
     +[EDIT: Normalement le problème des deux paragraphes suivants a été fixé, le bot ne crée normalement plus de chan qu'il serait possible de rejoindre en connaissant le guild id et le chan id. On peut donc tout à fait bridge des chans privés d'un serveur Discord public sans problème !] 
     + 
     +<del>**Attention** : il est possible de rejoindre avec une simple commande n'importe quel chan bridgé en connaissant 1) le guild id du serveur Discord 2) l'id du chan bridgé. **Mettre en place un pont entre un chan matrix et un chan privé d'un serveur Discord accessible au public n'est donc pas une bonne idée !** (car il serait possible de récupérer le guild id et le chan id facilement et donc accéder à ce chan privé depuis Matrix) 
     + 
     +=> Ne mettre en place des ponts que sur des chans publics d'un serveur Discord public (i.e. à partir du moment où le pont est mis en place, accepter que n'importe qui puisse rejoindre ce chan depuis Matrix) OU sur des chans d'un serveur privé (i.e. sans lien d'invitation, puisque dans ce cas personne à part les membres du serveur ne pourront deviner le guild id et rejoindre depuis Matrix).</del> 
     + 
     +**Notes diverses** : le bot ne marche pas sur des chans chiffrés, et le chiffrement d'un chan ne peut pas être désactivé une fois activé, il faut donc créer un chan non chiffré dès le début. Il faut être OP (rang >= 50) sur le chan Matrix pour que les commandes fonctionnent. Si le bot est kick du chan Matrix, le réinviter risque de ne pas marcher, un workaround est de l'inviter depuis irc avec `/invite _discord_bot1` (dans le cas où le chan a été crée depuis irc). 
     +===== Ésotérisme, random et Devtools =====
      
     Votre identifiant s'affiche à côté de votre pseudo ? Votre identifiant s'affiche à côté de votre pseudo ?
    Ligne 405: Ligne 427:
     ===== Avoir un meilleur sticker picker et des sticker perso  ===== ===== Avoir un meilleur sticker picker et des sticker perso  =====
      
    -  * Copier le contenu de ce repo git https://github.com/maunium/stickerpicker dans votre perso (dans le dossier html) ou votre site web +Prérequis : 
    -  * Placer le dossier packs dans le dossier web + 
    -  * Créer un fichier index.json avec un contenu de cette forme : +  * Avoir un site web. Tout les Iiens qui ont cotisés en ont un donc pas de souci pour le prérequis :) 
    -<code>{ + 
    -  "homeserver_url": "https://example.com", //vous pouvez mettre matrix.org ou matrix.iiens.net peu importe +**OU BIEN** 
    -  "packs": [ + 
    -    "nom_des_packs.json", //vous pouvez donc ne pas mettre un pack qui est dans le dossier pack +  * Avoir quelqu'un qui héberge ses packs de sticker sur son site web 
    -    "another_telegram_imported_pack.json" + 
    -  ] +Dans le premier cas : Aller voir le repository [[https://git.iiens.net/Tigriz/matrix-stickers|matrix-sticker]] se trouvant sur git.iiens.net 
    -}</code> + 
    -  * Sur element web/bureau : /devtools (dans un tchat) -> explorer les données du compte -> m.widget (si pas présent, le créer) -> entrer :  +Dans le second cas: Aller voir le repository [[https://git.iiens.net/Tigriz/matrix-stickers|matrix-sticker]] se trouvant sur git.iiens.net. Si vous avez la flemme voici un résumé du tuto: 
    -<code>{+   
     +1. Demandez lui l'autorisation (ou non).\\  
     +2. Récupérez l'adresse sur laquelle il héberge ses stickers. Cette adresse est de la forme : 
     + 
     +https://nom.iiens.net/stickerpicker/web/?theme=$theme 
     + 
     +3. Connectez vous à Element. Utilisez la commande /devtools 
     + 
     +4. Cliquer sur Explorer les données du compte puis sur m.widgets. Si absent : 1. Activer le gestionnaire d'intégration. 
     +Tout les paramètres -> général -> Gérer les intégrations 2. Envoyer n'importe quel sticker.\\  
     +5. Cliquer sur Modifier et remplacer tout par le code suivant en n'oubliant pas de modifier 
     +les champs "url" et "sender": 
     + 
     +{
         "stickerpicker": {     "stickerpicker": {
             "content": {         "content": {
                 "type": "m.stickerpicker",             "type": "m.stickerpicker",
    -            "url": "https://nomdefamille.iiens.net/dossier/web/?theme=$theme",+            "url": "https://{% nom de domaine %}/stickerpicker/web/?theme=$theme",
                 "name": "Stickerpicker",             "name": "Stickerpicker",
                 "data": {}             "data": {}
             },         },
    -        "sender": "@ariseID:serveur.d'accueil",+        "sender": "@{% id %}:{% homeserver %}",
             "state_key": "stickerpicker",         "state_key": "stickerpicker",
             "type": "m.widget",         "type": "m.widget",
             "id": "stickerpicker"         "id": "stickerpicker"
         }     }
    -}</code> +}\\  
    -  * Relancer/Actualiser element.+Il faut remplacer les données entre {%%} par ce qu'il correspond à votre compte / installation (si vous souhaitez utiliser mes packs de sticker, ils sont visibles en cliquant sur le lien suivant https://monarchiie.iiens.net/stickerpicker/web/index.html?theme=$theme)\\  
     +6. Actualiser
      
     ==== Créer des packs de sticker ==== ==== Créer des packs de sticker ====
      
    -Pour créer un pack de sticker, il suffit de créer un fichier .json dans le dossier pack et d'y indiquer les informations nécessaires.  +Voir [[https://git.iiens.net/Tigriz/matrix-stickers|le repo git matrix-sticker]]. Vous pourrez récupérer des packs de sticker faits par des iiens ou en proposer.
    - +
    -Méthode manuelle :  +
    - +
    -  * Téléverser une image dans un salon non-chiffré. **Ne le faites pas sur le serveur matrix d'arise**, les admins suppriment les images pour libérer de la place (source : Nitorac)  +
    -  * Commencer votre fichier .json de cette façon : +
    -<code>{"title": "Titre du pack", "id": "Ce que vous voulez", "stickers": [ +
    -  ] +
    -} +
    -</code> +
    - +
    -  * Cliquer sur les ... du message -> voir source -> copier le code correspondant à celui ci-dessous et le coller entre les crochets du fichier .json : +
    -<code> +
    -  { +
    -    "body": "boom_ni.gif", +
    -    "info": { +
    -      "size": 3080290, +
    -      "mimetype": "image/gif", +
    -      "thumbnail_info": { +
    -        "w": 498, +
    -        "h": 498, +
    -        "mimetype": "image/png", +
    -        "size": 194660 +
    -      }, +
    -      "w": 498, +
    -      "h": 498, +
    -      "thumbnail_url": "mxc://tedomum.net/LyJmspAoLIOBPHUzqwwEBzmH" +
    -    }, +
    -    "msgtype": "m.image", +
    -    "url": "mxc://tedomum.net/LSJhWayzyrbIkntHxnThICKQ" +
    -  }, +
    -  </code> +
    -  * **Attention** ajouter <code> "id" : "ce que vous voulez" </code> après le champ url. Il est important de ne pas l'oublier sinon les stickers de s'enverront pas +
    -  * répéter jusqu'à avoir tous les stickers voulu dans le pack +
    -  * ajouter le .json à index.json +
    - +
    -Méthode automatique : +
    -  * Via le script matrixpack.sh +
    -Le dossier courant doit être celui des stickers, le nom du pack sera celui du folder. +
    - +
    -./matrixpack.sh token homeserver en récupérant le token de son compte dans Help & About -> Advanced, à la dernière ligne. +
    - +
    -Le script donne un nouveau sous-dossier contenant : +
    - +
    -  * le json des stickers téléversés +
    -  * une prévisualisation des images en mosaïque avec ImageMagick +
    -  * un README.md affichant la prévisualisation +
    - +
    -<code> +
    -#!/bin/bash +
    -# usage +
    -# matrixpack token homeserver +
    -#  +
    -# pack name is the folder name +
    -# sticker name is the file name +
    -# /!\ token is sensitive information +
    - +
    -if test $# != 2 ; then +
    -  echo 1>&2 "$0:FATAL: $# invalid argument number (expected 2)" +
    -  exit 1 +
    -fi +
    - +
    -dir=$(pwd) +
    -token=$1 +
    -packname=${dir##*/} +
    -homeserver=$2 +
    - +
    -echo -e "Creating sticker pack\ndir=$dir\npackname=$packname" +
    - +
    -json="{\"title\":\"$packname\",\"id\":\"$packname\",\"stickers\":[" +
    -first=0 +
    -for f in * +
    -do +
    -  if test $first != 1 ; then +
    -    first=1 +
    -  else json="$json," +
    -  fi +
    -  mxc=$(curl -X POST -H "Content-Type: image/png" --data-binary "@$f" "https://$homeserver/_matrix/media/r0/upload?access_token=$token" | python3 -c "import sys, json; print(json.load(sys.stdin)['content_uri'])") +
    -  json="$json{\"body\":\"$f\",\"info\":{\"h\":128,\"w\":128,\"thumbnail_url\":\"$mxc\"},\"msgtype\":\"m.sticker\",\"url\":\"$mxc\",\"id\":\"$f\"}" +
    -done +
    -montage * "preview.png" +
    -mkdir "$packname" +
    -mv "preview.png" "$packname" +
    -echo -e "### $packname  \n![Preview of $packname](preview.png)" > "$packname/README.md" +
    -echo -n "$json]}" > "$packname/$packname.json" +
    -</code> +
     ====== Quelques serveurs publiques et Installation ====== ====== Quelques serveurs publiques et Installation ======
      
    Ligne 533: Ligne 484:
     ====== Aide ====== ====== Aide ======
      
    -Pour toute demande d'aide, vous pouvez poser vos question dasn salon #matrix (sur irc) ou #matrix:iiens.net (sur Matrix).+Pour toute demande d'aide, vous pouvez poser vos questions dans le salon #matrix (sur irc) ou #matrix:iiens.net (sur Matrix).