wallabag2_ynh/README_fr.md

Wallabag pour YunoHost

Read this readme in english. Lire ce readme en français.

Ce package vous permet d'installer Wallabag rapidement et simplement sur un serveur YunoHost. Si vous n'avez pas YunoHost, regardez ici pour savoir comment l'installer et en profiter.

Vue d'ensemble

Application de lecture-plus-tard auto-hébergeable

Version incluse : 2.4.2~ynh2

Démo : https://demo.yunohost.org/wallabag/

Captures d'écran

Avertissements / informations importantes

Caractéristiques spécifiques YunoHost

En plus des fonctionnalités principales de Wallabag, ce paquet propose également :

• Une intégration avec le système de gestion des utilisateurs et le SSO de YunoHost - e.g. un bouton de déconnexion
• De permettre à un utilisateur d'être administrateur (réglage lors de l'installation)
• Un import asynchrone utilisant Redis (à activer dans les Paramètres Internes). L'import via RabbitMQ n'est pas (encore ?) supporté.

Limitations

• Supprimer un utilisateur YunoHost ne supprimera pas l'utilisateur Wallabag lié, il sera seulement désactivé. Vous devez le supprimer manuellement avant. Voir : https://github.com/YunoHost-Apps/wallabag2_ynh/issues/39

• La mise à niveau depuis le paquet YunoHost de Wallabag v1 demande une opération manuelle, c'est pourquoi un nouveau paquet est fournit. Pour le processus de migration, merci de vous référer à la documentation officiel de Wallabag.

Branche de test (Testing)

Soyez concient que la branche testing pourrait contenir des bugs et n'est pas recommandée si vous recherchez la stabilité de votre application.

Les personnes souhaitant (bêta) tester de nouvelles mises à jour (ex: une nouvelle version), listée dans la section des Pull Requests, sont les bienvenues. Plus de tests nous permettrons de sortir des mises à jour plus vite 🙂. Pour tester la branche testing, utilisez sudo yunohost app upgrade wallabag2 -u https://github.com/YunoHost-Apps/wallabag2_ynh/tree/testing.

Attention : Une mise à jour classique avec l'interface d'administration ou avec sudo yunohost app upgrade wallabag2 (sans préciser l'URL) fera retourner votre application au niveau de la branche master. Ceci pourrait casser votre wallabag si vous revenez à une version précédente (et si la nouvelle n'est pas rétrocompatible).

Documentations et ressources

• Site officiel de l'app : https://www.wallabag.org
• Documentation officielle utilisateur : https://yunohost.org/#/app_wallabag2
• Documentation officielle de l'admin : https://doc.wallabag.org/en/
• Dépôt de code officiel de l'app : https://github.com/wallabag/wallabag
• Documentation YunoHost pour cette app : https://yunohost.org/app_wallabag2
• Signaler un bug : https://github.com/YunoHost-Apps/wallabag2_ynh/issues

Informations pour les développeurs

Merci de faire vos pull request sur la branche testing.

Pour essayer la branche testing, procédez comme suit.

sudo yunohost app install https://github.com/YunoHost-Apps/wallabag2_ynh/tree/testing --debug
ou
sudo yunohost app upgrade wallabag2 -u https://github.com/YunoHost-Apps/wallabag2_ynh/tree/testing --debug

Plus d'infos sur le packaging d'applications : https://yunohost.org/packaging_apps