Wallabag for YunoHost
Overview
Wallabag is a self hostable Read-It-Later application allowing
you to not miss any content anymore. Click, save, read it when you can.
It extracts content so that you can read it when you have time.
It provides a web interface, browser (Firefox / Chrome / Opera) add-ons, mobile apps (Android / iOS / Windows Phone) and even on e-reader (PocketBook / Kobo).
Screenshots
Demo
Configuration
Documentation
- Official documentation: Home · GitBook
- YunoHost documentation: YunoHost • index
YunoHost specific features
In addition to Wallabag core features, the following are made available with
this package:
- Integrate with YunoHost users and SSO - i.e. logout button
- Allow one user to be the administrator (set at the installation)
- Asynchronous import using Redis (need to be enabled in the Internal Settings). RabbitMQ import not supported (yet ?)
Multi-users support
Supported architectures
Limitations
- Removing a Yunohost’s user won’t delete the related wallabag user, but only desactivate it. You need to manualy remove it from wallabag before. See: Error while creating previously deleted user · Issue #39 · YunoHost-Apps/wallabag2_ynh · GitHub
Additional information
NB: Since @jeromelebleu is no longer maintaining this package, I (@lapineige) take over this repository. But I have limited time and experience, so feel free to help !
Upgrade from v1
The upgrade from the YunoHost Wallabag v1
app requires a manual operation, that’s why it’s provided as a new package.
For the migration process, please refer to the
Wallabag official documentation.
Links
- Report a bug: Issues · YunoHost-Apps/wallabag2_ynh · GitHub
- App website: https://www.wallabag.org/
- Upstream app repository: GitHub - wallabag/wallabag: wallabag is a self hostable application for saving web pages: Save and cla
- YunoHost website: https://yunohost.org/
Developers and testers info
Only if you want to use a testing branch for coding, instead of merging directly into master.
Please do your pull request to the testing branch.
To try the testing branch, please proceed like that:
sudo yunohost app install https://github.com/YunoHost-Apps/wallabag2_ynh/tree/testing --debug
or
sudo yunohost app upgrade wallabag2 -u https://github.com/YunoHost-Apps/wallabag2_ynh/tree/testing --debug
Please be aware that the testing branch might contains some bugs and is not recommended if you need a stable app.
Doing a normal upgrade of the package avec sudo yunohost app upgrade wallabag2
(without any URL specified) will revert you app to the master branch.
Wallabag pour YunoHost
Vue d’ensemble
Wallabag est une application de lecture différée : elle permet simplement d’archiver une page web en ne conservant que le contenu. Les éléments superflus (menus, publicités, etc.) sont supprimés.
Sont disponibles: une interface web, des add-ons pour navigateurs (Firefox / Chrome / Opera), des applications pour mobile (Android / iOS / Windows Phone) et mĂŞme sur liseuse (PocketBook / Kobo).
Captures d’écran
DĂ©mo
Configuration
Documentation
- Documentation officielle: Accueil · GitBook
- Documentation YunoHost: YunoHost • index
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é.
Support multi-utilisateurs
Supported architectures
Limitations
- Supprimer un utilisateur Yunohost ne supprimera pas l’utilisateur Wallabag lié, il sera seulement désactivé. Vous devez le supprimer manuellement avant. Voir: Error while creating previously deleted user · Issue #39 · YunoHost-Apps/wallabag2_ynh · GitHub
Informations additionnelles
NB: Depuis que @jeromelebleu ne maintient plus ce paquet, je (@lapineige) reprends la charge de ce dépôt. Mais j’ai un temps et une expérience limitées, donc n’hésitez pas à donner un coup de main !
Mettre Ă niveau depuis la v1
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.
Links
- Signaler un bug: Issues · YunoHost-Apps/wallabag2_ynh · GitHub
- Site de l’application: https://www.wallabag.org/
- Dépôt de l’application principale: GitHub - wallabag/wallabag: wallabag is a self hostable application for saving web pages: Save and cla
- Site web YunoHost: https://yunohost.org/
Informations pour les développeurs
Seulement si vous voulez utiliser une branche de test pour le codage, au lieu de fusionner directement dans la banche principale.
Merci de faire vos pull request sur la branche testing.
Pour essayer la branche testing, procédez comme ceci:
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
Soyez concient que la branche testing pourrait contenir des bugs et n’est pas recommandée si vous recherchez la stabilité de votre application.
Une mise Ă jour classique avec sudo yunohost app upgrade wallabag2
(sans préciser l’URL) fera retourner votre application au niveau de la branche master.