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

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

diff --git a/docs/en/index.rst b/docs/en/index.rst
index 1bac9ed77ff307196072cc438acc6636a0a6e018..ab58ca6b3b9e144035a58fe0c1d2e1b6e8a7b737 100644 (file)
--- 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 (file)
index 0000000..d3efc84
--- /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 af5ed14f2c86a0073c69ac7eb333a8a3ccb324f8..5adc5ab57339c3c54f0f9f6e051a830c90292b03 100644 (file)
--- 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 (file)
index 0000000..b20e597
--- /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 (file)
index 0000000..ff90524
Binary files /dev/null and b/docs/img/user/refetch.png differ

diff --git a/src/Wallabag/CoreBundle/Resources/config/services.yml b/src/Wallabag/CoreBundle/Resources/config/services.yml
index 1aa66be1016519fb942914195c42ea44a45c2d54..677c33daa7f39181f155fb2bc3ee49ca619e3f7b 100644 (file)
--- a/src/Wallabag/CoreBundle/Resources/config/services.yml
+++ b/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: