+ + + + + +

Classer ses articles

Pour pouvoir retrouver plus facilement vos articles, plusieurs méthodes existent.

Articles favoris

Lorsque vous souhaitez mettre de côté un article, vous pouvez le marquer comme favori.

Marquer un article comme favori

Depuis la page de lecture d'un article, ou depuis une liste d'articles (par exemple, la liste des articles non lus), vous pouvez mettre un article comme favori juste en cliquant sur l'étoile qui apparait.
+Recliquer sur cette étoile enlèvera le statut favori de cet article.

Retrouver tous ses articles favoris

Dans le menu de wallabag, cliquez sur Favoris pour retrouver tous les articles que vous avez déjà mis en favori.

Articles archivés

Lorsque vous avez lu un article, vous pouvez l'archiver : ainsi il n'apparaitra plus dans votre liste d'articles non lus.
+Le fait d'archiver un article ne le supprime pas de wallabag.

Archiver un article

Depuis la page de lecture d'un article, ou depuis une liste d'articles (par exemple, la liste des articles non lus), vous pouvez archiver un article juste en cliquant sur l'icône ✓.
+Recliquer sur cette icône remettra l'article en statut non lu.

Retrouver tous ses articles archivés

Dans le menu de wallabag, cliquez sur Archive pour retrouver tous les articles que vous avez déjà archivés.

Supprimer l'article

Attention, la suppression d'un article est définitive : il est supprimé de la base de données de wallabag.

Pour supprimer un article, une icône de corbeille se trouve sur la page d'un article ou sur une liste d'articles (articles non lus, favoris ou archivés par exemple).

Nous vous faisons confiance : c'est pourquoi il n'y a aucune demande de confirmation lors de la suppression.

+ +

+ + + + + +

Configurer wallabag

Depuis le menu configuration, vous avez la possibilité de changer quelques options de wallabag.

Certaines parties ne seront pas présentées ici car elles bénéficient d'un chapitre complet dans la documentation (flux RSS, l'import depuis un service tiers, l'export de vos données, la conversion en ePub et le mode multi-utilisateurs).

Thème

Des goûts et des couleurs, on ne discute pas. C'est pourquoi wallabag vous propose de changer son habillage pour plaire à chacun.
+Sélectionnez le thème de votre choix dans la liste déroulante et validez en cliquant sur Mettre à jour.

Langue

Sélectionnez la langue de votre choix dans la liste déroulante et validez en cliquant sur Mettre à jour.

Mot de passe

Saisissez votre nouveau mot de passe dans les deux champs prévus et validez en cliquant sur Mettre à jour.
+Vous serez alors déconnecté et devrez saisir votre nouveau mot de passe pour accéder à wallabag.

Vider le cache

Le cache permet à wallabag d'effectuer certains traitements plus rapidement.
+Après une mise à jour de wallabag, il est conseillé de vider le cache. Vous n'avez qu'un clic à faire pour le vider.

+ +

+ + + + + +

Convertir en ePub

Pour que vous puissiez lire vos articles sauvegardés depuis votre liseuse, wallabag vous permet de les convertir au format ePub et ainsi vous créer un eBook pour vos longues soirées d'hiver.

Mise en garde

Attention, la génération de fichiers ePub peut être très consommatrice de ressources pour le serveur sur lequel est installé wallabag. Cela dépend du nombre d'articles et de leur longueur.
+Ne générez pas un eBook trop important si cela n'est pas nécessaire.

Où convertir les articles

Vous pouvez convertir vos articles depuis différents endroits de wallabag :

sur la page de lecture d'un article : le lien ePub convertira ce seul article
depuis une liste d'articles (articles non lus, favoris ou archivés, articles d'un tag) : un lien en bas de page vous permet de convertir tous les articles de cette catégorie
depuis une recherche : le lien se trouve en bas de page
depuis la page de configuration : vous allez pouvoir convertir tous vos articles, peu importe la catégorie dans laquelle ils se trouvent

TODO parler de calibre

+ +

+ + + + + +

Flux RSS

Les flux RSS vous permettent :

de lire vos articles depuis votre lecteur de flux RSS préféré
d'activer les fonctionnalités de lecture pour les applications smartphones

Tout d'abord, vous devez activer la fonctionnalité RSS en générant votre jeton de flux.
+Rendez-vous dans configuration de wallabag et créez le jeton dans la partie Flux. +À tout moment, vous pouvez générer un nouveau jeton.

Lire les articles

Une fois le jeton créé, vous avez accès à trois flux RSS :

celui des articles non lus
celui des articles favoris
celui des articles archivés

Ajoutez le flux de votre choix dans votre lecteur de flux RSS.
+Attention, lorsque vous lirez un article depuis votre lecteur de flux, ça ne le marquera pas comme lu dans wallabag.

Partager vos lectures

Si vous souhaitez partager vos lectures avec quelqu'un, envoyez-lui par exemple le flux RSS de vos articles préférés. Ainsi, dès qu'un article sera mis en favori dans wallabag, cette personne pourra également le lire.

Activer les fonctionnalités pour smartphones

Vous avez créé le jeton de flux RSS : il va vous être utile pour configurer votre application smartphone. Pour en savoir sur les applications smartphones, vous pouvez lire Sauvegarder son premier article.

+ +

+ + + + + +

Se créer un compte sur Framabag

Puisque vous ne souhaitez peut-être pas gérer l'installation et la mise à jour de wallabag, ou puisque vous n'avez peut-être pas les connaissances pour l'installer, il vous est possible de vous créer un compte gratuit sur Framabag.org.

Création du compte

Cliquez sur le bouton Créez votre compte / Create your account.

Vous devez saisir certaines informations : votre nom d'utilisateur, votre mot de passe et votre adresse email. Votre adresse n'est utilisée que pour la validation de votre compte, sauf si vous cochez la case pour recevoir la newsletter (3 à 4 envois par an).

Une fois ce formulaire validé, vous recevez un email avec un lien de confirmation. Cliquez dessus, votre compte sera alors créé.

Vous recevrez un dernier email avec l'adresse de votre compte Framabag, de la forme https://www.framabag.org/u/votre-nom-d'utilisateur.

Stockage de vos informations

Framabag utilise une base de données par utilisateur. Nous ne faisons et ne ferons aucune utilisation de vos données stockées.

Vous avez oublié votre mot de passe

Si vous avez oublié votre mot de passe pour vous connecter à Framabag, un formulaire est disponible depuis la page d'accueil du service.
+Remplissez-le, un email de confirmation vous sera envoyé et vous permettra de saisir votre nouveau mot de passe.

Suppression de votre compte

Si vous souhaitez supprimer votre compte, contactez-nous par email : hello@wallabag.org avec l'adresse de création de votre compte, en nous indiquant votre nom d'utilisateur.

Nous vous répondrons quand votre compte sera supprimé : dès cet instant, plus aucune information vous concernant ne sera stockée sur Framabag.

+ +

+ + + + + +

Importer ou exporter ses données

Importer

Pour importer des données dans wallabag, vous devez vous rendre dans la page Configuration.

Mise en garde

L'import de données peut être une opération gourmande pour votre serveur. C'est pourquoi elle s'effectue en deux étapes :

l'insertion des URL dans la base de données de wallabag
dans un second temps, la récupération, pour chaque article, du contenu complet

Ces deux actions ne peuvent pas être effectuées simultanément, car nous vous donnons la possibilité d'importer des milliers de liens, mais aujourd'hui, wallabag n'a pas les possibilités techniques nécessaires pour effectuer tout ce travail automatiquement.

Depuis Pocket

Exporter ses données depuis Pocket

Depuis votre compte Pocket, rendez-vous dans vos options. +TODO

Importer ses données Pocket

Depuis la page de configuration de wallabag, partie Import, sélectionnez le fichier ril_export.html que Pocket a généré puis cliquez sur Import.
+wallabag ne fait qu'insérer les liens dans sa base de données. Il faut maintenant lui faire récupérer le contenu de chaque article.

Pour cela, cliquez sur Click to finish import : wallabag récupèrera alors le contenu de 10 articles à la fois.

TODO

TODO nouveau ticket : pourquoi quand on clique une fois, ça ne charge pas en boucle ? Il me semblait que ça faisait ça ping @mariroz

Depuis Instapaper

Exporter ses données depuis Instapaper

TODO

Importer ses données Instapaper

TODO

Depuis Readability

Exporter ses données depuis Readability

TODO

Importer ses données Readability

TODO

Depuis wallabag

Puisque vous pouvez exporter vos données de wallabag (lire ci-dessous), il est évidemment possible de les réimporter.

Dans le formulaire d'import, sélectionnez votre fichier d'export wallabag (au format JSON). Démarrez l'import et voila.

Contrairement aux imports ci-dessus, le traitement est moins long car toutes les données (titre et contenu des articles) sont déjà présentes dans le fichier, il n'est pas nécessaire pour wallabag d'accéder à chacune des URL.
+Par contre, le fichier d'import est forcément plus conséquent.

Depuis un fichier HTML ou JSON

TODO

Exporter

Il est possible d'exporter ses données depuis la page Configuration de wallabag. Plusieurs raisons possibles :

réinstaller wallabag
quitter le service Framabag pour installer soi-même wallabag
un compte sur un wallabag multi-utilisateurs souhaite avoir sa propre installation de wallabag
...

Vous téléchargerez alors un fichier au format JSON.
+Comme nous l'avons vu ci-dessus, il est possible d'importer ce fichier dans wallabag.

+ +

+ + + + + +

Lire un article

Lire un article n'est pas la chose la plus compliquée dans wallabag. Vous n'avez qu'à cliquer sur le titre d'un article pour l'afficher.

Revenir là où vous avez laissé votre article

Si vous quittez un article alors que vous n'êtes qu'à la moitié de celui-ci par exemple, lorsque vous reviendrez, wallabag vous renverra là où vous avez laissé l'article.

Cette astuce ne fonctionne qu'avec l'application web et pas les applications smartphones.

Actions possibles depuis l'article

Ces actions sont possibles grâce aux icônes affichés en haut de la page. Nous partons du principe que vous utilisez le thème Baggy (lire la documentation pour changer de thème), les icônes dans les autres thèmes sont sensiblement les mêmes.
+Voici donc ces actions, par ordre d'apparition des icônes.

Lire l'article original

Renvoie vers l'article original.

Marquer l'article comme lu

Archive l'article, qui se retrouvera dans la catégorie Archive du menu de wallabag.
+Recliquer dessus permet de replacer cet article en état non lu.

Mettre l'article en favori

Marque l'article comme favori, qui se retrouvera dans la catégorie Favoris du menu de wallabag.
+Recliquer dessus permet d'enlever le statut de favori.

Supprimer l'article

Supprime complètement l'article de wallabag. Il ne pourra être restauré. Attention, aucune confirmation n'est demandée.

Partager vers twitter

Partage le titre et le lien original de l'article sur twitter.

Partager par email

Partage le titre et le lien original de l'article par email.

Imprimer l'article

Ouvre la fenêtre d'impression du navigateur.

Convertir en ePub

Convertit l'article au format ePub. Un chapitre complet existe.

Signaler que l'article s'affiche mal

Permet de signaler qu'un article ne s'affiche pas comme attendu. Un chapitre complet existe.

+ +

+ + + + + +

Rechercher du contenu dans wallabag

Pour que vous puissiez retrouver un article au plus vite, nous avons mis en place un moteur de recherche complet.

Cliquez sur Rechercher dans le menu de wallabag. Là, saisissez un terme de recherche.

wallabag ira parcourir tous vos articles et affichera ceux qui contiennent le terme de recherche dans leur titre ou dans le contenu de l'article.

Convertir cette recherche au format ePub

Vous pouvez convertir les articles retournés au format ePub, pour les lire sur une liseuse par exemple. Lisez Convertir en ePub pour en savoir plus.

Assigner un tag aux résultats de cette recherche

Vous pouvez créer un tag en fonction du critère de recherche. Lisez Classer ses articles pour en savoir plus.

+ +

+ + + + + +

Sauvegarder son premier article

Une fois connecté sur wallabag, vous avez plusieurs moyens pour sauvegarder un article.

Depuis l'application web

Voyons d'abord comment faire depuis l'application web. Dans le menu, vous avez un lien Sauvegarder un lien. En cliquant dessus, un formulaire s'affiche : vous n'avez qu'à saisir l'adresse internet de l'article concerné.

Validez et le contenu de l'article est enregistré.

Par défaut, seul le texte est sauvegardé. Si vous souhaitez également conserver une copie des images sur votre serveur, il faut activer le paramètre DOWNLOAD_PICTURES. Lisez le chapitre Les options cachées pour en savoir plus.

Depuis le bookmarklet

Définition Wikipedia

Un bookmarklet est un petit programme JavaScript pouvant être stocké :
+* soit en tant qu'URL dans un signet (marque-page ou lien favori) avec la plupart des navigateurs Web ;
+* soit en tant qu'hyperlien dans une page web.

Depuis le menu de wallabag, cliquez sur configuration. Dans la première partie de cette page, nous avons listé les différents moyens de sauvegarder un article. Vous trouverez ainsi le bookmarklet (c'est le lien bag it !) à glisser / déposer dans la barre de favoris de votre navigateur.

Dorénavant, lorsque vous souhaitez sauvegarder un article sur lequel vous êtes en train de surfer, vous n'avez qu'à cliquer sur ce bookmarklet et l'article sera automatiquement enregistré.

Depuis son smartphone

Avant toute chose

Pour pouvoir utiliser une application smartphone, vous devez activer les flux RSS depuis la partie configuration de wallabag. Certaines informations seront ainsi affichées, comme votre token (jeton de sécurité). Lisez le chapitre Flux RSS pour en savoir plus.

Android

Installation et configuration

Vous pouvez télécharger l'application Android depuis le Google Play Store et depuis F-droid. C'est exactement la même application sur ces deux plateformes de téléchargement.

Une fois installée, démarrez l'application, rendez-vous dans la partie settings et renseignez les champs URL (Adresse complète de votre installation de wallabag ou de votre compte Framabag), User ID (très souvent, il vous faudra mettre 1 comme valeur). Si vous avez créé plusieurs comptes depuis wallabag, il faudra saisir l'identifiant du compte que vous souhaitez connecter à votre application) et Token (recopiez bien tous les caractères du token, disponible dans la configuration de wallabag).

Sauvegarde d'un article

Maintenant que tout est bien configuré, dès que vous naviguerez avec le navigateur de votre smartphone, vous pourrez à tout moment partager un article dans wallabag depuis le menu Partager : vous trouverez une entrée Bag it! qui ajoutera l'article dans wallabag.

Lecture

Lorsque vous ouvrez l'application, cliquez sur Synchronize : vos articles dernièrement sauvegardés seront ainsi téléchargés sur votre smartphone.

Vous n'avez maintenant plus besoin de connexion internet : cliquez sur le bouton List articles pour commencer votre lecture.

En bas de chaque article, un bouton Mark as read vous permet d'archiver l'article.

Aujourd'hui, la synchronisation ne s'effectue que dans un sens (de wallabag vers l'application), ce qui empêche de marquer comme lu un article sur wallabag depuis votre smartphone.

iOS

Installation et configuration

TODO

Utilisation

TODO

Windows Phone

Installation et configuration

Vous pouvez télécharger l'application Windows Phone depuis le Windows Store ou directement dans le Store de votre smartphone.

Une fois installée, l'application affichera une notification au premier lancement, demandant la configuration du serveur wallabag. Rendez-vous dans la partie Configuration de l'application en appuyant sur les 3 petits points du menu en bas de l'écran, puis renseignez les champs URL (Adresse complète de votre installation de wallabag ou de votre compte Framabag), User ID (très souvent, il vous faudra mettre 1 comme valeur).
+Si vous avez créé plusieurs comptes depuis wallabag, il faudra saisir l'identifiant du compte que vous souhaitez connecter à votre application) et Token (recopiez bien tous les caractères du token, disponible dans la configuration de wallabag).
+Enfin, sauvegardez les paramètres entrés.

Depuis son navigateur

Firefox

Téléchargez l'extension Firefox sur le site addons.mozilla.org et installez-la comme toute autre extension Firefox.

Dans les préférences de l'extension, renseignez l'URL complète de votre installation de wallabag ou de votre compte Framabag.

Personnalisez la barre d'outils de Firefox pour ajouter wallabag (icône w). Lorsque vous vous trouvez sur un article que vous souhaitez sauvegarder, cliquez sur cette icône : une nouvelle fenêtre s'ouvrira pour ajouter l'article et elle se refermera automatiquement.

Chrome

Téléchargez l'extension Chrome sur le site dédié et installez-la comme toute autre extension Chrome.

Dans les options de l'extension, renseignez l'URL complète de votre installation de wallabag ou de votre compte Framabag.

Lors de l'installation de l'extension, une nouvelle icône est apparue dans la barre d'outils de Chrome, une icône w. Lorsque vous vous trouvez sur un article que vous souhaitez sauvegarder, cliquez sur cette icône : une popup s'ouvrira et vous confirmera que l'article a bien été sauvegardé.

+ +

+ + + + + +

Mon article s'affiche mal dans wallabag

Si vous pensez que wallabag récupère mal le contenu d'un article (texte absent ou incomplet), nous vous proposons plusieurs possibilités.

Demande d'aide

Que ça soit par mail ou via un ticket, n'oubliez pas de nous donner certaines informations qui sont importantes pour que nous puissions résoudre le problème au mieux :

l'URL de l'article concerné
ce que wallabag affiche
ce à quoi vous vous attendiez
la version de wallabag ou alors si vous utilisez Framabag

Ouvrir un ticket sur github

Pour ouvrir un nouveau ticket, il faut aller sur github. Un compte est nécessaire.
+N'oubliez pas de nous envoyer les informations ci-dessus.

Nous envoyer un email

Envoyez-nous un lien à l'adresse hello@wallabag.org.
+N'oubliez pas de nous envoyer les informations ci-dessus.

Résoudre ce problème d'affichage

TODO

+ +

Classer ses articles

Tags

Assigner un tag

Depuis l'article

Depuis la recherche

Retrouver tous les articles d'un même tag

Articles favoris

Marquer un article comme favori

Retrouver tous ses articles favoris

Articles archivés

Archiver un article

Retrouver tous ses articles archivés

Supprimer l'article

Configurer wallabag

Thème

Langue

Mot de passe

Vider le cache

Convertir en ePub

Mise en garde

Où convertir les articles

Flux RSS

Lire les articles

Partager vos lectures

Activer les fonctionnalités pour smartphones

Se créer un compte sur Framabag

Création du compte

Stockage de vos informations

Vous avez oublié votre mot de passe

Suppression de votre compte

Importer ou exporter ses données

Importer

Mise en garde

Depuis Pocket

Exporter ses données depuis Pocket

Importer ses données Pocket

Depuis Instapaper

Exporter ses données depuis Instapaper

Importer ses données Instapaper

Depuis Readability

Exporter ses données depuis Readability

Importer ses données Readability

Depuis wallabag

Depuis un fichier HTML ou JSON

Exporter

Lire un article

Revenir là où vous avez laissé votre article

Actions possibles depuis l'article

Lire l'article original

Marquer l'article comme lu

Mettre l'article en favori

Supprimer l'article

Partager vers twitter

Partager par email

Imprimer l'article

Convertir en ePub

Signaler que l'article s'affiche mal

Rechercher du contenu dans wallabag

Convertir cette recherche au format ePub

Assigner un tag aux résultats de cette recherche

Sauvegarder son premier article

Depuis l'application web

Depuis le bookmarklet

Depuis son smartphone

Avant toute chose

Android

Installation et configuration

Sauvegarde d'un article

Lecture

iOS

Installation et configuration

Utilisation

Windows Phone

Installation et configuration

Depuis son navigateur

Firefox

Chrome

Mon article s'affiche mal dans wallabag

Demande d'aide

Ouvrir un ticket sur github