Added documentation about siteconfig fix

Found in #2358, thank you @j0k3r
This commit is contained in:
Nicolas Lœuillet 2016-10-07 14:17:13 +02:00
parent bf71a734f6
commit baf0ffa7df
No known key found for this signature in database
GPG key ID: 5656BE27E1E34D0A
2 changed files with 30 additions and 6 deletions

View file

@ -12,9 +12,21 @@ There may be several reasons:
How can I help to fix that? How can I help to fix that?
--------------------------- ---------------------------
- `by sending us an email with the article's URL <mailto:hello@wallabag.org>`_ You can `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/>`__. 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? How can I try to re-fetch this article?
--------------------------------------- ---------------------------------------

View file

@ -12,9 +12,21 @@ Il peut y avoir plusieurs raisons :
Comment puis-je aider pour réparer ça ? Comment puis-je aider pour réparer ça ?
--------------------------------------- ---------------------------------------
- `en nous envoyant un email avec l'URL de l'article <mailto:hello@wallabag.org>`_ Vous pouvez `nous envoyer 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/>`__. 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 ? Comment puis-je réessayer de récupérer le contenu ?
--------------------------------------------------- ---------------------------------------------------