aboutsummaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorNicolas Lœuillet <nicolas@loeuillet.org>2016-10-07 14:17:13 +0200
committerNicolas Lœuillet <nicolas@loeuillet.org>2016-10-07 14:17:13 +0200
commitbaf0ffa7df64b1bfe140593fb52f979fef97dbae (patch)
treec73dccdae1d7b95256b49a2bc542e0ba74eae38e
parentbf71a734f64a911549e188a5c69ac8e08eec896e (diff)
downloadwallabag-baf0ffa7df64b1bfe140593fb52f979fef97dbae.tar.gz
wallabag-baf0ffa7df64b1bfe140593fb52f979fef97dbae.tar.zst
wallabag-baf0ffa7df64b1bfe140593fb52f979fef97dbae.zip
Added documentation about siteconfig fix
Found in #2358, thank you @j0k3r
-rw-r--r--docs/en/user/errors_during_fetching.rst18
-rw-r--r--docs/fr/user/errors_during_fetching.rst18
2 files changed, 30 insertions, 6 deletions
diff --git a/docs/en/user/errors_during_fetching.rst b/docs/en/user/errors_during_fetching.rst
index 68892750..615eb2da 100644
--- a/docs/en/user/errors_during_fetching.rst
+++ b/docs/en/user/errors_during_fetching.rst
@@ -12,9 +12,21 @@ There may be several reasons:
12How can I help to fix that? 12How can I help to fix that?
13--------------------------- 13---------------------------
14 14
15- `by sending us an email with the article's URL <mailto:hello@wallabag.org>`_ 15You can `sending us an email with the article's URL <mailto:hello@wallabag.org>`_.
16- by trying to fix this article by yourself :) by creating a file for the article. 16
17 You can use `this tool <http://siteconfig.fivefilters.org/>`__. 17Or you can also try to fix this problem by yourself.
18
19You 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).
20
21If it works here and not on wallabag, it means there are something internally in wallabag that breaks the parser (hard to fix).
22
23If 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).
24
25You can test it **f43.me** website: click on **Want to try a custom siteconfig?** and put the generated file from siteconfig.fivefilters.org.
26
27Repeat until you have something ok.
28
29Then 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.
18 30
19How can I try to re-fetch this article? 31How can I try to re-fetch this article?
20--------------------------------------- 32---------------------------------------
diff --git a/docs/fr/user/errors_during_fetching.rst b/docs/fr/user/errors_during_fetching.rst
index 74290bef..a5d3680a 100644
--- a/docs/fr/user/errors_during_fetching.rst
+++ b/docs/fr/user/errors_during_fetching.rst
@@ -12,9 +12,21 @@ Il peut y avoir plusieurs raisons :
12Comment puis-je aider pour réparer ça ? 12Comment puis-je aider pour réparer ça ?
13--------------------------------------- 13---------------------------------------
14 14
15- `en nous envoyant un email avec l'URL de l'article <mailto:hello@wallabag.org>`_ 15Vous pouvez `nous envoyer un email avec l'URL de l'article <mailto:hello@wallabag.org>`_.
16- en essayant de réparer cet article par vous-même :) en créant un fichier pour l'article. 16
17 Vous pouvez utiliser `cet outil <http://siteconfig.fivefilters.org/>`__. 17Ou vous pouvez aussi essayer de résoudre ce problème vous même.
18
19Vous 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).
20
21Si ça fonctionne ici et pas sur wallabag, c'est qu'il y a un souci avec wallabag qui casse le parser (difficile à résoudre).
22
23Si ç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).
24
25Vous 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.
26
27Répétez cette opération jusqu'à avoir quelque chose qui vous convienne.
28
29Ensuite, 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.
18 30
19Comment puis-je réessayer de récupérer le contenu ? 31Comment puis-je réessayer de récupérer le contenu ?
20--------------------------------------------------- 32---------------------------------------------------