Skip to content
Extraits de code Groupes Projets
Valider 30df2a04 rédigé par Kubat's avatar Kubat
Parcourir les fichiers

Small README updates

parent eecd1b55
Branches
Aucune étiquette associée trouvée
Aucune requête de fusion associée trouvée
Afficher les modifications d'espaces
En ligne Côte à côte
Affichage de
avec 32 ajouts et 31 suppressions
README.md
+ 32
− 31
Voir le fichier @ 30df2a04
......@@ -2,7 +2,7 @@
Matrix-stickers est un dépôt créé pour regrouper les pack de stickers créés par les IIEns.
Il propose aussi plusieurs tutoriels afin d'installer un meilleur "stickerpicker", d'utiliser des packs de sticker
ainsi que de les créer soi-même.
Salon d'aide : ##sticker:iiens.net
Salon d'aide : `##sticker:iiens.net`
**Table des matières**
- [Utiliser le stickerpicker d'un ami](#user-content-utiliser-le-stickerpicker-dun-ami)
......@@ -28,19 +28,18 @@ Pour cela :
"stickerpicker": {
"content": {
"type": "m.stickerpicker",
"url": "https://example.com/stickerpicker/web/?theme=$theme", // TODO à remplacer par l'adresse du pote
"url": "https://{% nom de domaine %}/stickerpicker/web/?theme=$theme",
"name": "Stickerpicker",
"data": {}
},
"sender": "@id:homeserver", // TODO votre compte
// nom0000:iiens.net sur Arise
"sender": "@{% id %}:{% homeserver %}",
"state_key": "stickerpicker",
"type": "m.widget",
"id": "stickerpicker"
}
}
```
Supprimer ensuite les commentaires.
Il faut remplacer les données entre `{%%}` par ce qu'il correspond à votre compte / installation.
6. Actualiser
## Avoir un meilleur stickerpicker
......@@ -63,30 +62,28 @@ Pour cela:
4. Se connecter à Element. Utiliser la commande `/devtools` dans n'importe quel tchat.
![devtools](screenshots/screen_devtools.png)
5. Cliquer sur `Explorer les données du compte` puis sur `m.widgets`.
- Si absent, activer le gestionnaire d'intégration :
`Tout les paramètres -> Général -> Gerer les intégrations`. Envoyer ensuite n'importe quel sticker.
- Si `m.widgets` est absent, il faut activer le gestionnaire d'intégration dans `Tout les paramètres -> Général -> Gerer les intégrations`.
Ensuite il faut clicker sur `Envoyer` plutôt que `Modifier` dans le point suivant.
![devtools1](screenshots/devtools.png)
6. Cliquer sur `Modifier` et remplacer tout par le code suivant en n'oubliant pas de modifier
6. Cliquer sur `Modifier` (ou `Modifier`, cf point 5) et remplacer tout par le code suivant en n'oubliant pas de modifier
les champs "url" et "sender" avec les infos correspondantes :
```json
{
"stickerpicker": {
"content": {
"type": "m.stickerpicker",
"url": "https://example.com/stickerpicker/web/?theme=$theme", // TODO
// nom.iiens.net sur Arise
"url": "https://{% nom de domaine %}/stickerpicker/web/?theme=$theme",
"name": "Stickerpicker",
"data": {}
},
"sender": "@id:homeserver", // TODO
// nom0000:iiens.net sur Arise
"sender": "@{% id %}:{% homeserver %}",
"state_key": "stickerpicker",
"type": "m.widget",
"id": "stickerpicker"
}
}
```
Supprimer les commentaires ensuite. (Json ne supporte pas les comments :( )
Il faut remplacer les données entre `{%%}` par ce qu'il correspond à votre compte / installation.
7. Actualiser Element
Vous avez maintenant un stickerpicker pouvant envoyer des stickers privacy\_pam.
......@@ -100,19 +97,21 @@ Pour en ajouter un dans le stickerpicker, allez voir ce
## Créer des packs de stickers
Avec le nouveau stickerpicker installé, il est possible de créer ses propres packs de stickers.
Un pack de stickers se résume à un fichier json possédant des informations précises sur les images téléversées.
- Note 1 : Il est conseillé de créer un compte secondaire sur matrix.org pour créer les packs de stickers. Si vous utilisez votre compte Arise,
il est possible que vos packs ne soient plus disponibles, car Arise libère de la place aléatoirement quand c'est nécessaire. Pour se créer un compte
sur matrix.org, rendez vous [ici](https://app.element.io/#/register). Même si vos stickers seront
hébergés sur votre compte secondaire, vous pourrez toujours utiliser le stickerpicker et envoyer les stickers avec votre compte Arise.
- Note 2 : Il est déconseillé d'effectuer cette étape sur perso.iiens.net. Préférez le faire sur votre machine car cette étape nécessite
le paquet "ImageMagick" qui n'est pas à jour sur perso.iiens.net ( impossible de le mettre à jour ) et casse la transparence de vos images. Si vous souhaitez
tout de même le faire sur perso.iiens.net, vous pouvez recompiler à la main le paquet, je vous laisse chercher comment faire.
- Note 1 : Il est conseillé de créer un compte secondaire sur matrix.org pour créer les packs de stickers.
Si vous utilisez votre compte Arise, il est possible que vos packs ne soient plus disponibles. En effet Arise
libère de la place aléatoirement quand c'est nécessaire. Pour se créer un compte sur matrix.org, rendez vous
[ici](https://app.element.io/#/register). Même si vos stickers sont hébergés sur votre compte secondaire, vous
pourrez toujours utiliser le stickerpicker et envoyer les stickers avec votre compte Arise.
- Note 2 : Il est déconseillé d'effectuer cette étape sur perso.iiens.net. Préférez le faire sur votre machine car
cette étape nécessite le paquet "ImageMagick" qui n'est pas à jour sur perso.iiens.net (impossible de le mettre à jour)
et casse la transparence de vos images. Si vous souhaitez tout de même le faire sur perso.iiens.net, vous pouvez
recompiler à la main le paquet, je vous laisse chercher comment faire.
Pour créer ce ficher json et téléverser ses images, il existe deux méthodes :
### Méthode automatique (Recommandé)
**Via le script matrixpack.sh**
**Requis** : *ImageMagick* (`sudo apt-get install imagemagick`/`pacman -S imagemagick`).
**Requis** : *ImageMagick* (en tant que root : `apt install imagemagick`/`pacman -S imagemagick`).
Ce script suppose que vous avez déjà créer un ou plusieurs dossiers regroupant les images que vous souhaitez utiliser en sticker.
Le nom du dossier définira le nom du pack, et les images s'y trouvant deviendront les stickers du pack.
1. Cloner ce dépôt
......@@ -145,8 +144,8 @@ Cela va copier le fichier nomdupack.json dans le dossier `packs` se trouvant dan
**Facultatif :**
Vous pouvez aussi ajouter le nouveau sous-dossier créé par le script dans ce dépôt et ainsi contribuer !
Pour cela faites une pull request.
Pour cela faites une pull request. Pensez à demander l'accès à un fork déjà existant plustôt que de créer
le votre pour économiser de la place, les disques c'est pas gratuit.
**Tips**
```bash
......@@ -156,12 +155,14 @@ scp matrix-stickers/packs/*/*.json nom0000@perso.iiens.net:html/stickerpicker/we
### Méthode manuelle
1. 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)**
**Ne le faites pas sur le serveur Matrix d'Arise, les admins peuvent suppriment les images pour libérer de
la place, mais ça n'a jamais été fait (source : Nitorac & Kubat)**. De manière générale pensez à compresser
un peu vos images avant de les upload, les disques c'est pas gratuit.
2. Commencer votre fichier json de cette façon
```json
{
"title": "Titre du pack", // TODO
"id": "Ce que vous voulez",
"title": "{% titre du pack %}",
"id": "{% ce que vous voulez, uuidgen est votre ami %}",
"stickers": [
...
]
......
0% ou .
You are about to add 0 people to the discussion. Proceed with caution.
Veuillez vous inscrire ou vous pour commenter