diff options
author | Nicolas Lœuillet <nicolas@loeuillet.org> | 2016-10-07 14:17:13 +0200 |
---|---|---|
committer | Nicolas Lœuillet <nicolas@loeuillet.org> | 2016-10-07 14:17:13 +0200 |
commit | baf0ffa7df64b1bfe140593fb52f979fef97dbae (patch) | |
tree | c73dccdae1d7b95256b49a2bc542e0ba74eae38e | |
parent | bf71a734f64a911549e188a5c69ac8e08eec896e (diff) | |
download | wallabag-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.rst | 18 | ||||
-rw-r--r-- | docs/fr/user/errors_during_fetching.rst | 18 |
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: | |||
12 | How can I help to fix that? | 12 | How 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>`_ | 15 | You 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/>`__. | 17 | Or you can also try to fix this problem by yourself. |
18 | |||
19 | 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). | ||
20 | |||
21 | If it works here and not on wallabag, it means there are something internally in wallabag that breaks the parser (hard to fix). | ||
22 | |||
23 | 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). | ||
24 | |||
25 | You can test it **f43.me** website: click on **Want to try a custom siteconfig?** and put the generated file from siteconfig.fivefilters.org. | ||
26 | |||
27 | Repeat until you have something ok. | ||
28 | |||
29 | 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. | ||
18 | 30 | ||
19 | How can I try to re-fetch this article? | 31 | How 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 : | |||
12 | Comment puis-je aider pour réparer ça ? | 12 | Comment 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>`_ | 15 | Vous 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/>`__. | 17 | Ou vous pouvez aussi essayer de résoudre ce problème vous même. |
18 | |||
19 | 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). | ||
20 | |||
21 | 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). | ||
22 | |||
23 | 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). | ||
24 | |||
25 | 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. | ||
26 | |||
27 | Répétez cette opération jusqu'à avoir quelque chose qui vous convienne. | ||
28 | |||
29 | 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. | ||
18 | 30 | ||
19 | Comment puis-je réessayer de récupérer le contenu ? | 31 | Comment puis-je réessayer de récupérer le contenu ? |
20 | --------------------------------------------------- | 32 | --------------------------------------------------- |