From baf0ffa7df64b1bfe140593fb52f979fef97dbae Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Fri, 7 Oct 2016 14:17:13 +0200 Subject: Added documentation about siteconfig fix Found in #2358, thank you @j0k3r --- docs/en/user/errors_during_fetching.rst | 18 +++++++++++++++--- docs/fr/user/errors_during_fetching.rst | 18 +++++++++++++++--- 2 files changed, 30 insertions(+), 6 deletions(-) (limited to 'docs') 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: How can I help to fix that? --------------------------- -- `by sending us an email with the article's URL `_ -- by trying to fix this article by yourself :) by creating a file for the article. - You can use `this tool `__. +You can `sending us an email with the article's URL `_. + +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 `_ (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/ `_ (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 `_ which is the global repo for siteconfig files. How can I try to re-fetch this article? --------------------------------------- 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 : Comment puis-je aider pour réparer ça ? --------------------------------------- -- `en nous envoyant un email avec l'URL de l'article `_ -- en essayant de réparer cet article par vous-même :) en créant un fichier pour l'article. - Vous pouvez utiliser `cet outil `__. +Vous pouvez `nous envoyer un email avec l'URL de l'article `_. + +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 `_ (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/ `_ (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 `_, qui est le projet principal pour stocker les fichiers de configuration. Comment puis-je réessayer de récupérer le contenu ? --------------------------------------------------- -- cgit v1.2.3 From 9cfea18a5dbcf0aee8a755396dd25084671e1b02 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Fri, 7 Oct 2016 14:40:32 +0200 Subject: Fixed review --- docs/en/user/errors_during_fetching.rst | 4 ++-- docs/fr/user/errors_during_fetching.rst | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) (limited to 'docs') diff --git a/docs/en/user/errors_during_fetching.rst b/docs/en/user/errors_during_fetching.rst index 615eb2da..e8ef6ce6 100644 --- a/docs/en/user/errors_during_fetching.rst +++ b/docs/en/user/errors_during_fetching.rst @@ -14,7 +14,7 @@ How can I help to fix that? You can `sending us an email with the article's URL `_. -Or you can also try to fix this problem by yourself. +Or you can also try to fix this problem by yourself (so we can be focused on improving wallabag internally instead of writing siteconfig :) ). You can try to see if it works here: `http://f43.me/feed/test `_ (it uses almost the same way as wallabag to retrieve content). @@ -22,7 +22,7 @@ If it works here and not on wallabag, it means there are something internally in If it doesn't works, try to extract a site config using: `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. +You can test it on **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. diff --git a/docs/fr/user/errors_during_fetching.rst b/docs/fr/user/errors_during_fetching.rst index a5d3680a..5fa29a85 100644 --- a/docs/fr/user/errors_during_fetching.rst +++ b/docs/fr/user/errors_during_fetching.rst @@ -14,7 +14,7 @@ Comment puis-je aider pour réparer ça ? Vous pouvez `nous envoyer un email avec l'URL de l'article `_. -Ou vous pouvez aussi essayer de résoudre ce problème vous même. +Ou vous pouvez aussi essayer de résoudre ce problème vous même (comme ça, nous restons concentrés pour améliorer wallabag au lieu d'écrire ces fichiers de configuration :) ). Vous pouvez essayer de voir si ça fonctionne ici : `http://f43.me/feed/test `_ (ce site utilise principalement la même manière de fonctionner que wallabag pour récupérer les articles). -- cgit v1.2.3 From fba816c43bdf787d587f2fb11ba7c6b385a40dea Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Fri, 7 Oct 2016 15:14:15 +0200 Subject: Added link to fivefilters website --- docs/en/user/errors_during_fetching.rst | 6 +++--- docs/fr/user/errors_during_fetching.rst | 4 ++-- 2 files changed, 5 insertions(+), 5 deletions(-) (limited to 'docs') diff --git a/docs/en/user/errors_during_fetching.rst b/docs/en/user/errors_during_fetching.rst index e8ef6ce6..3190b4cc 100644 --- a/docs/en/user/errors_during_fetching.rst +++ b/docs/en/user/errors_during_fetching.rst @@ -16,11 +16,11 @@ You can `sending us an email with the article's URL ` Or you can also try to fix this problem by yourself (so we can be focused on improving wallabag internally instead of writing siteconfig :) ). -You can try to see if it works here: `http://f43.me/feed/test `_ (it uses almost the same way as wallabag to retrieve content). +You can try to see if it works here: `http://f43.me/feed/test `_ (it uses almost the same système 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 works here and not on wallabag, it mean there is something internally in wallabag that breaks the parser (hard to fix: please open an issue about it). -If it doesn't works, try to extract a site config using: `http://siteconfig.fivefilters.org/ `_ (select which part of the content is actually the content). +If it doesn't works, try to extract a site config using: `http://siteconfig.fivefilters.org/ `_ (select which part of the content is actually the content). You can `read this documentation before `_. You can test it on **f43.me** website: click on **Want to try a custom siteconfig?** and put the generated file from siteconfig.fivefilters.org. diff --git a/docs/fr/user/errors_during_fetching.rst b/docs/fr/user/errors_during_fetching.rst index 5fa29a85..1a60e4bd 100644 --- a/docs/fr/user/errors_during_fetching.rst +++ b/docs/fr/user/errors_during_fetching.rst @@ -18,9 +18,9 @@ Ou vous pouvez aussi essayer de résoudre ce problème vous même (comme ça, no Vous pouvez essayer de voir si ça fonctionne ici : `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 fonctionne ici et pas sur wallabag, c'est qu'il y a un souci avec wallabag qui casse le parser (difficile à résoudre : merci d'ouvrir un nouveau ticket à ce sujet). -Si ça ne fonctionne pas, vous pouvez essayer de créer un fichier de configuration en utilisant : `http://siteconfig.fivefilters.org/ `_ (sélectionnez les parties du contenu qui correspondent à ce que vous souhaitez garder). +Si ça ne fonctionne pas, vous pouvez essayer de créer un fichier de configuration en utilisant : `http://siteconfig.fivefilters.org/ `_ (sélectionnez les parties du contenu qui correspondent à ce que vous souhaitez garder). Vous pouvez `lire cette documentation avant `_. 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. -- cgit v1.2.3 From 4e5d219663b08c5dfba2aaa885c9cef38097bf7d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Fri, 7 Oct 2016 15:27:05 +0200 Subject: Fixed review --- docs/en/user/errors_during_fetching.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'docs') diff --git a/docs/en/user/errors_during_fetching.rst b/docs/en/user/errors_during_fetching.rst index 3190b4cc..6684563a 100644 --- a/docs/en/user/errors_during_fetching.rst +++ b/docs/en/user/errors_during_fetching.rst @@ -16,9 +16,9 @@ You can `sending us an email with the article's URL ` Or you can also try to fix this problem by yourself (so we can be focused on improving wallabag internally instead of writing siteconfig :) ). -You can try to see if it works here: `http://f43.me/feed/test `_ (it uses almost the same système as wallabag to retrieve content). +You can try to see if it works here: `http://f43.me/feed/test `_ (it uses almost the same system as wallabag to retrieve content). -If it works here and not on wallabag, it mean there is something internally in wallabag that breaks the parser (hard to fix: please open an issue about it). +If it works here and not on wallabag, it means there is something internally in wallabag that breaks the parser (hard to fix: please open an issue about it). If it doesn't works, try to extract a site config using: `http://siteconfig.fivefilters.org/ `_ (select which part of the content is actually the content). You can `read this documentation before `_. -- cgit v1.2.3