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

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

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

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

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

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

src/Wallabag/CoreBundle/Resources/config/services.yml

@@ -39,7 +39,7 @@ services:
     wallabag_core.graby:
         class: Graby\Graby
         arguments:
-            - { error_message: false }
+            - { error_message: "wallabag can't retrieve contents for this article. Please report this issue to us." }
         calls:
             - [ setLogger, [ "@logger" ] ]
         tags: