FeedMe/doc/en/mobilizer.md

# Mobilizer and full text download
Some RSS feed article just provides summary, not full text. This reading experience is not friendly. FeedMe offers some mobilizers for full download. Now support `FeedMe`，`Mercury` and `Google Web Light`. `FeedMe` is built-in mobilizer of FeedMe，the other two are third party Mobilizer services.

In FeedMe, there are two cases where mobilizer is required.
1. download when sync
2. downlaod when reading

You can find these 2 settings below (NAV side - Subscription - category/feed):

<img src="https://github.com/seazon/FeedMe/blob/master/doc/en/imgs/mobilizer_1.png" width="25%" height="25%" />

# Why the third party mobilizer was set, but the article was still downloaded using FeedMe mobilizer?
Because the third party mobilizer in order to ensure the availability of its services, generally limit the frequency of calls. If the call is too fast or too many times, they will stop the service. Due to the high download frequency when FeedMe is synchronized, it may result in third party mobilizer being unavailable. So at the time of synchronization, only the built-in mobilizer is available.

So, the mobilizer in the `feed settings` dialog is only use for download when reading.

<img src="https://github.com/seazon/FeedMe/blob/master/doc/en/imgs/mobilizer_2.png" width="25%" height="25%" />

Note : Mobilizer is removing some unimportant elements on the page (head, side and bottom of the navigation or link) and re-layout, leaving only the text part. General mobilizer get the article is calculated by algorithm, so can not guarantee 100% correct. Mature mobilizer resolution is more accurate, and built-in is worse.

# Feed & Web
In the top right corner of the article page, it displays `Feed/Web`. Where `Feed` represents the article content from RSS, `Web` represents the article content from the source link.

The content of the web is re-crawled via source links and parsed by Mobilizer. In general, the body content can be parsed correctly, but it may be parsed incorrectly, return the wrong content.

## Current is `Feed` or `Web`?
- When `Feed` is the accent color, it means the current content is `Web`.
- When `Web` is the accent color, it means the current content is `Feed`.

## Switch feed/web view manually
Once enter article page, how can I switch feed/web view manually?

### 1. Tap feed/web link
You can tap the feed/web link at top right corner. The accent color is link, and another one is current state. 

Note: If the web page is not download yet, it will download it at the first time you tap the web link. Which mobilizer it will use? Check the `feed settings` dialog article mobilizer section.

### 2. Menu `Reload page`
`Reload page` is in actionbar overflow menu, or on actionbar if you edit it. It always downloads content from web even if you downloaded the web page before. 

### 3. Double Touch
You can set the double touch action in `Settings` - `Control` as `Toggle feed/web page` to toggle between feed/web. It's behavior just like tap feed/web link.

### 4. Auto download web page
If you enable `Download web page when reading` in `feed settings` dialog, it will automatically download the full text when open the article page which the mobilizer you set.

Note: Like tap feed/web link, it just downloads web page the first time if web page is not download. Of course, if network is NOT available, it will not do anything.

# Default view
So which page will display by default? Feed or web page?
- Show feed view by default.
- Show web view if you enable `Download web page when sync` in `feed settings` and downloaded when syncing.
- Show feed view if you enable `Download web page when sync` in `feed settings` and NOT downloaded when syncing.
- Show web view if you enable `Download web page when reading` in `feed settings` and network is available.
- Show feed view if you enable `Download web page when reading` in `feed settings` and network is NOT available.

When the article content uses for some cases, like `Share content` or play it, it is also following these rules. 

# FeedMe Mobilizer Selector (supported since v4.1)
`FeedMe Mobilizer` uses a simple algorithm to parse the body content of a URL address. Generally, more accurate analysis can be obtained when the text content is relatively large. However, due to the variety of web pages, always happens this simple algorithm parsing incorrectly.

In CSS, selectors are used to select certain element(s) of HTML. Starting from v4.1, FeedMe will simply use some selectors to help `FeedMe Mobilizer` locate content parts more accurately. I call this new feature `FeedMe Mobilizer Selector`.

## advantage
- More accurate analysis of the text content of the article
- Less parsing time

## shortcoming
- HTML/CSS knowledge required
- Need to know how to locate a node in HTML through the browser

## quick guide
1. Choose one feed you need to set the `FeedMe Mobilizer selector`. It usually does not provide full text and `FeedMe Mobilizer` cannot parse it correctly.
2. Open any article from this feed in a desktop browser.
3. Find the smallest node containing the text by looking at the element node, and find the ID or class that can be used for positioning.
4. Open FeedMe, open the subscription management screen of this feed, select `FeedMe` in `Mobilizer`, and the `FeedMe Mobilizer Selector` section will be displayed.
5. Enter the ID or class found for positioning. There are two situations:
    - What you found is ID, for example `content_body`, enter `#content_body`
    - What you found is class, for example `content_body`, enter `.content_body`
6. At this point, the settings have been completed. You can open the web again to see if the parsing is correct. If the web has been opened, it needs to be reloaded and parsed through the `Reload page` of the article interface.