add contents in mobilizer

This commit is contained in:
zhangshunjie 2017-06-02 15:26:31 +08:00
parent 97fb0bfdc7
commit 02b6b93a83
4 changed files with 89 additions and 4 deletions

View File

@ -53,4 +53,4 @@ 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 <a href="https://github.com/seazon/FeedMe/blob/master/doc/en/mobilizer.md#Switch feed/web view manually">this section</a> to know how it works.
A: You can read <a href="https://github.com/seazon/FeedMe/blob/master/doc/en/mobilizer.md#default-view">this section</a> to know how it works.

View File

@ -4,7 +4,7 @@ This is the documentation of FeedMe.
# 主题:
- <a href="https://github.com/seazon/FeedMe/blob/master/doc/en/podcast_tts.md">Podcast & TTS</a>
- <a href="https://github.com/seazon/FeedMe/blob/master/doc/zh/podcast_tts.md">播客和TTS</a>
- <a href="https://github.com/seazon/FeedMe/blob/master/doc/zh/filter.md">过滤器</a>
- <a href="https://github.com/seazon/FeedMe/blob/master/doc/zh/customize_menus.md">自定义菜单</a>
- Feed setting

View File

@ -1,4 +1,4 @@
## Mobilizer 和全文下载
# Mobilizer 和全文下载
有些 RSS 订阅源的文章只提供摘要而不是全文这样的阅读体验并不友好。FeedMe 提供了多种 Mobilizer 来进行全文下载。目前支持 `FeedMe``Mercury` 和 `Google Web Light` 3种。`FeedMe` 为 FeedMe 自带 Mobilizer另外2个是第三方 Mobilizer 服务。
在 FeedMe 中有2种情况需要用到 Mobilizer。
@ -13,4 +13,33 @@
所以,在订阅源设置中的 Mobilizer只适用于阅读时的下载。见下图。
<img src="https://github.com/seazon/FeedMe/blob/master/doc/en/imgs/mobilizer_2.png" width="25%" height="25%" />
Mobilizer去除网页上一些不重要的元素头部侧边及底部的导航或者链接并重新排版仅保留正文部分。一般 Mobilizer 得到的文章是由程序算法计算解析得出的所以不能保证百分百的正确。成熟的Mobilizer 在正确性上会做的更好,而自带的会差一些。
Mobilizer去除网页上一些不重要的元素头部侧边及底部的导航或者链接并重新排版仅保留正文部分。一般 Mobilizer 得到的文章是由程序算法计算解析得出的所以不能保证百分百的正确。成熟的Mobilizer 在正确性上会做的更好,而自带的会差一些。
# 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.
# 默认显示
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.

56
doc/zh/podcast_tts.md Normal file
View File

@ -0,0 +1,56 @@
FeedMe now supports TTS and podcast, you can read articles with your ear.
- For podcast feed, FeedMe supports manual download for offline reading.
- For normal feed, FeedMe compliances with the standard Android TTS specification, you can read with your favorite TTS engine, such as Google TTS or Ivona.
FeedMe integrates these two different forms, and you can listen all items like listening to music.
FeedMe provides play section into the playlist in the left navigation bar. To simplify the logic, FeedMe has only one playlist.
<img src="https://github.com/seazon/FeedMe/blob/master/doc/en/imgs/tts_2.png" width="25%" height="25%" />
There is a new layout in article list: podcast. This layout contains a progress button, you can play a item or download the audio file if it is a podcast item.
<img src="https://github.com/seazon/FeedMe/blob/master/doc/en/imgs/tts_8.png" width="25%" height="25%" />
<img src="https://github.com/seazon/FeedMe/blob/master/doc/en/imgs/tts_9.png" width="25%" height="25%" />
# Play control
There are 4 play menus in article list long-tap dialog:
- `Single play` (add to top of playlist, mark with `Stop tag`, and play this item)
- `Play` (add to playlist and play, if playing now, stop the playing item)
- `Next play` (add after the playing item)
- `Add to playlist` (add to last of playlist)
`Stop tag`: When played a item with `Stop tag`, stop play and clear it.
<img src="https://github.com/seazon/FeedMe/blob/master/doc/en/imgs/tts_1.png" width="25%" height="25%" />
# Playlist
- The played item will be automatically removed from playlist, including podcast audio files. So no need to remove item by yourself.
- FeedMe can remember the play position automatically.
- You can remove item via swipe from right to left.
- Now FeedMe does not support podcast online playing.
- Playlist only supports order playback, no single loop, loop, random play.
- You can reorder playlist via long-tap and drag.
- It skips the played items when play the playlist.
When an item is playing, a notification adds in notification bar. And you can enter playing page via tap it.
<img src="https://github.com/seazon/FeedMe/blob/master/doc/en/imgs/tts_6.png" width="25%" height="25%" />
# Playing page
There are 3 pages in playing page. You can find a sross icon in playlist page, that is `Stop tag`.
<img src="https://github.com/seazon/FeedMe/blob/master/doc/en/imgs/tts_3.png" width="25%" height="25%" />
<img src="https://github.com/seazon/FeedMe/blob/master/doc/en/imgs/tts_4.png" width="25%" height="25%" />
<img src="https://github.com/seazon/FeedMe/blob/master/doc/en/imgs/tts_5.png" width="25%" height="25%" />
# TTS setting
There is an `Audio` tab in `Settings`, you can goto TTS setting page from here.
<img src="https://github.com/seazon/FeedMe/blob/master/doc/en/imgs/tts_7.png" width="25%" height="25%" />
# 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 <a href="https://github.com/seazon/FeedMe/blob/master/doc/zh/mobilizer.md#默认显示">this section</a> to know how it works.