Merge pull request #1710 from wallabag/v2-message-graby-fails

Fix #811: Display a human message when graby fails to fetch articles

5 files changed, 56 insertions, 0 deletions

diff --git a/docs/en/index.rst b/docs/en/index.rst
index 1bac9ed7..ab58ca6b 100644
--- a/docs/en/index.rst
+++ b/docs/en/index.rst
@@ -28,6 +28,7 @@ The main documentation for this application is organized into a couple sections:
    user/login
    user/configuration
    user/first_article
+   user/errors_during_fetching
    user/import
    user/download_articles
    user/filters
diff --git a/docs/en/user/errors_during_fetching.rst b/docs/en/user/errors_during_fetching.rst
new file mode 100644
index 00000000..d3efc848
--- /dev/null
+++ b/docs/en/user/errors_during_fetching.rst
@@ -0,0 +1,27 @@
+Errors during fetching articles
+===============================
+
+Why does the fetch of an article fail?
+--------------------------------------
+
+There may be several reasons:
+
+- network problem
+- wallabag can't fetch content due to the website structure
+
+How can I help to fix that?
+---------------------------
+
+- `by sending us an email with the article's URL <mailto:hello@wallabag.org>`_
+- by trying to fix this article by yourself :) by creating a file for the article.
+  You can use this tool http://siteconfig.fivefilters.org/.
+
+How can I try to re-fetch this article?
+---------------------------------------
+
+If wallabag failed when fetching an article, you can click on the reload button
+(the third on the below picture).
+
+.. image:: ../../img/user/refetch.png
+   :alt: Refetch content
+   :align: center
diff --git a/docs/fr/index.rst b/docs/fr/index.rst
index af5ed14f..5adc5ab5 100644
--- a/docs/fr/index.rst
+++ b/docs/fr/index.rst
@@ -29,6 +29,7 @@ La documentation principale de cette application est découpée en plusieurs sec
    user/login
    user/configuration
    user/first_article
+   user/errors_during_fetching
    user/import
    user/download_articles
    user/filters
diff --git a/docs/fr/user/errors_during_fetching.rst b/docs/fr/user/errors_during_fetching.rst
new file mode 100644
index 00000000..b20e5973
--- /dev/null
+++ b/docs/fr/user/errors_during_fetching.rst
@@ -0,0 +1,27 @@
+Erreur durant la récupération des articles
+==========================================
+
+Pourquoi la récupération des articles échoue ?
+----------------------------------------------
+
+Il peut y avoir plusieurs raisons :
+
+- problème de connexion internet
+- wallabag ne peut pas récupérer le contenu à cause de la structure du site web
+
+Comment puis-je aider pour réparer ça ?
+---------------------------------------
+
+- `en nous envoyant un email avec l'URL de l'article <mailto:hello@wallabag.org>`_
+- en essayant de réparer cet article par vous-même :) en créant un fichier pour l'article.
+  Vous pouvez utiliser cet outil http://siteconfig.fivefilters.org/.
+
+Comment puis-je réessayer de récupérer le contenu ?
+---------------------------------------------------
+
+Si wallabag échoue en récupérant l'article, vous pouvez cliquer sur le bouton suivant
+(le troisième sur l'image ci-dessous).
+
+.. image:: ../../img/user/refetch.png
+   :alt: Refetch content
+   :align: center
diff --git a/docs/img/user/refetch.png b/docs/img/user/refetch.png
new file mode 100644
index 00000000..ff905248
--- /dev/null
+++ b/docs/img/user/refetch.png