]> git.immae.eu Git - github/wallabag/wallabag.git/commitdiff
Added documentation about siteconfig fix
authorNicolas Lœuillet <nicolas@loeuillet.org>
Fri, 7 Oct 2016 12:17:13 +0000 (14:17 +0200)
committerNicolas Lœuillet <nicolas@loeuillet.org>
Fri, 7 Oct 2016 12:17:13 +0000 (14:17 +0200)
Found in #2358, thank you @j0k3r

docs/en/user/errors_during_fetching.rst
docs/fr/user/errors_during_fetching.rst

index 68892750350409d837bdc3db42f54395d6c1efef..615eb2dac56a13f34854a819542ecfeff9a4aee2 100644 (file)
@@ -12,9 +12,21 @@ There may be several reasons:
 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/>`__.
+You can `sending us an email with the article's URL <mailto:hello@wallabag.org>`_.
+
+Or you can also try to fix this problem by yourself.
+
+You can try to see if it works here: `http://f43.me/feed/test <http://f43.me/feed/test>`_ (it uses almost the same way as wallabag to retrieve content).
+
+If it works here and not on wallabag, it means there are something internally in wallabag that breaks the parser (hard to fix).
+
+If it doesn't works, try to extract a site config using: `http://siteconfig.fivefilters.org/ <http://siteconfig.fivefilters.org/>`_ (select which part of the content is actually the content).
+
+You can test it **f43.me** website: click on **Want to try a custom siteconfig?** and put the generated file from siteconfig.fivefilters.org.
+
+Repeat until you have something ok.
+
+Then you can submit a pull request to `https://github.com/fivefilters/ftr-site-config <https://github.com/fivefilters/ftr-site-config>`_ which is the global repo for siteconfig files.
 
 How can I try to re-fetch this article?
 ---------------------------------------
index 74290bef405f9dc78d24771b2f32e82fa57021ce..a5d3680aac2a057add7935fcf8055b877bfdc4fa 100644 (file)
@@ -12,9 +12,21 @@ Il peut y avoir plusieurs raisons :
 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/>`__.
+Vous pouvez `nous envoyer un email avec l'URL de l'article <mailto:hello@wallabag.org>`_.
+
+Ou vous pouvez aussi essayer de résoudre ce problème vous même.
+
+Vous pouvez essayer de voir si ça fonctionne ici : `http://f43.me/feed/test <http://f43.me/feed/test>`_ (ce site utilise principalement la même manière de fonctionner que wallabag pour récupérer les articles).
+
+Si ça fonctionne ici et pas sur wallabag, c'est qu'il y a un souci avec wallabag qui casse le parser (difficile à résoudre).
+
+Si ça ne fonctionne pas, vous pouvez essayer de créer un fichier de configuration en utilisant : `http://siteconfig.fivefilters.org/ <http://siteconfig.fivefilters.org/>`_ (sélectionnez les parties du contenu qui correspondent à ce que vous souhaitez garder).
+
+Vous pouvez tester ce fichier sur le site **f43.me** : cliquez sur **Want to try a custom siteconfig?** et insérez le fichier généré depuis siteconfig.fivefilters.org.
+
+Répétez cette opération jusqu'à avoir quelque chose qui vous convienne.
+
+Ensuite, vous pouvez créer une pull request ici `https://github.com/fivefilters/ftr-site-config <https://github.com/fivefilters/ftr-site-config>`_, qui est le projet principal pour stocker les fichiers de configuration.
 
 Comment puis-je réessayer de récupérer le contenu ?
 ---------------------------------------------------