From 97fb0bfdc7878cafca78c0fe3db8304b0ecfc7fe Mon Sep 17 00:00:00 2001 From: zhangshunjie Date: Fri, 2 Jun 2017 15:19:27 +0800 Subject: [PATCH] add contents in mobilizer --- README.md | 3 +-- doc/en/mobilizer.md | 33 +++++++++++++++++++++++++++++++-- doc/en/podcast_tts.md | 5 +++++ doc/zh/README.md | 3 +-- 4 files changed, 38 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 299d2ff..ce7de88 100644 --- a/README.md +++ b/README.md @@ -8,9 +8,8 @@ This is the documentation of FeedMe. - Filter (Chinese) - Customize Menus (Chinese) - Feed setting -- Mobilizer +- Mobilizer and full text download - Sync -- FAB & Action Bar # QA diff --git a/doc/en/mobilizer.md b/doc/en/mobilizer.md index 780a97c..a4b74c4 100644 --- a/doc/en/mobilizer.md +++ b/doc/en/mobilizer.md @@ -1,4 +1,4 @@ -## Mobilizer and full text download +# 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. @@ -10,7 +10,36 @@ You can find these 2 settings below (NAV side - Subscription - category/feed): Many users asked 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 is only use for download when reading. +So, the mobilizer in the `feed settings` dialog is only use for download when reading. 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. + +# 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 tap +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`, 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. + +Once the article content uses for some cases, like `Share content` or play it, it is also following these rules. diff --git a/doc/en/podcast_tts.md b/doc/en/podcast_tts.md index 0453674..d2ea696 100644 --- a/doc/en/podcast_tts.md +++ b/doc/en/podcast_tts.md @@ -49,3 +49,8 @@ There are 3 pages in playing page. You can find a sross icon in playlist page, t There is an `Audio` tab in `Settings`, you can goto TTS setting page from here. + +# Tips +### Play feed view or web view +Q: Sometimes feed does not provide full text, and when we switch to web view and play, it still play the feed view text. How can I play the web view text? +A: You can read this section to know how it works. \ No newline at end of file diff --git a/doc/zh/README.md b/doc/zh/README.md index 2bf28f1..bc68e6e 100644 --- a/doc/zh/README.md +++ b/doc/zh/README.md @@ -8,9 +8,8 @@ This is the documentation of FeedMe. - 过滤器 - 自定义菜单 - Feed setting -- Mobilizer +- Mobilizer和全文下载 - Sync -- FAB & Action Bar # QA