[github/wallabag/wallabag.git] / docs / en / user / errors_during_fetching.rst

Errors during fetching articles
===============================

Why does the fetch of an article fail?
--------------------------------------

There may be several reasons:

- network problem
- wallabag can't fetch content due to the website structure

How can I help to fix that?
---------------------------

You can 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 <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 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/ <http://siteconfig.fivefilters.org/>`_ (select which part of the content is actually the content). You can `read this documentation before <http://help.fivefilters.org/customer/en/portal/articles/223153-site-patterns>`_.

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.

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?
---------------------------------------

If wallabag failed when fetching an article, you can click on the reload button
(the third on the below picture).

.. image:: ../../img/user/refetch.png
   :alt: Refetch content
   :align: center
Commit	Line	Data
924ef7ca NL	1	Errors during fetching articles
	2	===============================
	3
	4	Why does the fetch of an article fail?
	5	--------------------------------------
	6
	7	There may be several reasons:
	8
	9	- network problem
	10	- wallabag can't fetch content due to the website structure
	11
	12	How can I help to fix that?
	13	---------------------------
	14
2e389b0b	15	You can try to fix this problem by yourself (so we can be focused on improving wallabag internally instead of writing siteconfig :) ).
baf0ffa7	16
4e5d2196	17	You can try to see if it works here: `http://f43.me/feed/test <http://f43.me/feed/test>`_ (it uses almost the same system as wallabag to retrieve content).
baf0ffa7	18
4e5d2196	19	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).
baf0ffa7	20
fba816c4	21	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 `read this documentation before <http://help.fivefilters.org/customer/en/portal/articles/223153-site-patterns>`_.
baf0ffa7	22
9cfea18a	23	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.
baf0ffa7 NL	24
	25	Repeat until you have something ok.
	26
	27	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.
924ef7ca NL	28
	29	How can I try to re-fetch this article?
	30	---------------------------------------
	31
	32	If wallabag failed when fetching an article, you can click on the reload button
	33	(the third on the below picture).
	34
	35	.. image:: ../../img/user/refetch.png
	36	:alt: Refetch content
	37	:align: center