matrix-puppet-discord_ynh/README_fr.md

81 lines
3.8 KiB
Markdown
Raw Normal View History

2022-08-14 10:31:11 +02:00
<!--
2024-03-29 07:12:07 +01:00
Nota bene: ce README est automatiquement généré par <https://github.com/YunoHost/apps/tree/master/tools/readme_generator>
Il NE doit PAS être modifié à la main.
2022-08-14 10:31:11 +02:00
-->
2021-09-17 13:12:01 +02:00
# Matrix-Discord bridge pour YunoHost
2021-09-11 16:08:56 +02:00
2023-10-31 15:21:44 +01:00
[![Niveau dintégration](https://dash.yunohost.org/integration/matrix-puppet-discord.svg)](https://dash.yunohost.org/appci/app/matrix-puppet-discord) ![Statut du fonctionnement](https://ci-apps.yunohost.org/ci/badges/matrix-puppet-discord.status.svg) ![Statut de maintenance](https://ci-apps.yunohost.org/ci/badges/matrix-puppet-discord.maintain.svg)
2021-09-17 13:12:01 +02:00
[![Installer Matrix-Discord bridge avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=matrix-puppet-discord)
2021-09-11 16:08:56 +02:00
2024-03-29 07:12:07 +01:00
*[Lire le README dans d'autres langues.](./ALL_README.md)*
2021-09-11 16:08:56 +02:00
2024-03-29 07:12:07 +01:00
> *Ce package vous permet dinstaller Matrix-Discord bridge rapidement et simplement sur un serveur YunoHost.*
> *Si vous navez pas YunoHost, consultez [ce guide](https://yunohost.org/install) pour savoir comment linstaller et en profiter.*
2021-09-11 16:08:56 +02:00
2023-10-31 15:21:44 +01:00
## Vue densemble
2021-09-11 16:08:56 +02:00
Ceci est une passerelle vers Discord pour Matrix. Il gère la messagerie privée ou en groupe, tout comme la discussion dans une guilde (serveur Discord). Le projet est basé sur [mx-puppet-bridge](https://gitlab.com/mx-puppet/mx-puppet-bridge).
2021-09-11 16:08:56 +02:00
2021-09-17 13:12:01 +02:00
### Fonctionnalités
2021-09-11 16:08:56 +02:00
2021-09-17 13:12:01 +02:00
- Messagerie directe (1:1)
- Discussion privée en groupe
- Plein texte
- Messages formattés
- Fichiers / médias
- Notification de rédaction / suppression
- Présence (Discord → Matrix seulement)
- Notification de saisie (Discord → Matrix seulement)
- Réponses
- Modifications de messages
- Réactions
- Stickers
- Multi-utilisateur·rices
- Gestion des ami·es
- initier des chats depuis matrix
2021-09-11 16:08:56 +02:00
2021-09-17 13:12:01 +02:00
### Comment faire
2021-09-11 16:08:56 +02:00
Voir la documentation sur <https://gitlab.com/mx-puppet/discord/mx-puppet-discord> (en anglais).
2021-09-11 16:08:56 +02:00
2021-09-17 17:24:41 +02:00
2024-03-29 07:12:07 +01:00
**Version incluse:** 0.1.7~ynh4
2021-09-11 16:08:56 +02:00
2023-10-31 15:21:44 +01:00
## Captures décran
2021-09-11 16:08:56 +02:00
2023-10-31 15:21:44 +01:00
![Capture décran de Matrix-Discord bridge](./doc/screenshots/example.jpg)
2021-09-11 16:08:56 +02:00
## Avertissements / informations importantes
2021-09-17 13:12:01 +02:00
Après l'installation, lancer une conversation privée avec `@_discordpuppet_bot:yourserver.com`. Ensuite, entrer `help` dans le chat pour lire les instructions.
2021-09-11 16:08:56 +02:00
2021-09-17 13:12:01 +02:00
Vous pouvez par ailleurs modifier le fichier `/etc/matrix-puppet-discord/user.config.yaml` pour personnaliser la configuration (notamment les permissions pour utiliser la passerelle). Redémarrez bien ensuite la passerelle pour que les modifications soient effectives (`systemctl restart matrix-puppet-discord`).
2021-09-11 16:08:56 +02:00
2024-03-29 07:12:07 +01:00
## :red_circle: Anti-fonctionnalités
- **Application non maintenue**: Ce logiciel n'est plus maintenu. Attendez-vous à ce qu'il ne fonctionne plus avec le temps, et que l'on découvre des failles de sécurité qui ne seront pas corrigées, etc.
2021-09-11 16:08:56 +02:00
## Documentations et ressources
2024-03-29 07:12:07 +01:00
- Site officiel de lapp: <https://gitlab.com/mx-puppet/discord/mx-puppet-discord>
- Documentation officielle de ladmin: <https://gitlab.com/mx-puppet/discord/mx-puppet-discord>
- Dépôt de code officiel de lapp: <https://gitlab.com/mx-puppet/discord/mx-puppet-discord>
- YunoHost Store: <https://apps.yunohost.org/app/matrix-puppet-discord>
- Signaler un bug: <https://github.com/YunoHost-Apps/matrix-puppet-discord_ynh/issues>
2021-09-11 16:08:56 +02:00
## Informations pour les développeurs
2024-03-29 07:12:07 +01:00
Merci de faire vos pull request sur la [branche `testing`](https://github.com/YunoHost-Apps/matrix-puppet-discord_ynh/tree/testing).
2021-09-11 16:08:56 +02:00
2024-03-29 07:12:07 +01:00
Pour essayer la branche `testing`, procédez comme suit:
2022-08-14 10:31:11 +02:00
2024-03-29 07:12:07 +01:00
```bash
2021-09-17 13:12:01 +02:00
sudo yunohost app install https://github.com/YunoHost-Apps/matrix-puppet-discord_ynh/tree/testing --debug
ou
sudo yunohost app upgrade matrix-puppet-discord -u https://github.com/YunoHost-Apps/matrix-puppet-discord_ynh/tree/testing --debug
2021-09-11 16:08:56 +02:00
```
2024-03-29 07:12:07 +01:00
**Plus dinfos sur le packaging dapplications:** <https://yunohost.org/packaging_apps>