Created Sorting criteria (markdown)

cactux 2013-04-22 08:33:14 -07:00
parent 730b75ef52
commit 12c77d35de
1 changed files with 41 additions and 0 deletions

41
Sorting-criteria.md Normal file

@ -0,0 +1,41 @@
**This text is only a draft, opened for discussion. It is written as if it were the final user documentation, but its first use will be for specifications in order to develop these features.**
# AntennaPod sorting criteria
When AntennaPod puts the episodes in the queue, they have to be sorted. There are several ways to do this, they are explained below:
## Basic (default)
The default way to sort episodes is by date: from oldest to newest. It means that old episodes will be played before newer ones. Each time AntennaPod downloads an episode, it will usually be added at the end of the queue.
The date used is the _publication date_ of the episode. This means that if you download an episode which has been published a long time ago, it may land at the top of the queue and not at the end.
## Advanced
With the advanced sort, you can select the sorting criterion and eventually invert list. Available sorting criteria are:
* By date: older episodes first (this is actually the basic way sorting way)
* By length: shorter episodes first
* By name: from A to Z (actually from 0 to 9 then A to Z), case insensitive.
* By feed priority: according to the priority you gave to the feed, highest first.
A switch is available to invert the chosen criterion. For example, if you choose to sort by date and invert the sort, you'll have newer episodes first.
## Expert
With the expert mode, you can apply one or several sorting criteria, and order them. With the expert mode, you can for example:
* Play episodes by date (newer first) then by size (shortest first).
## Manual sorting
Once AntennaPod sorted the list according to these criteria, it is possible to manually change the order. To do this, tap the zone at the right of the main list name, you'll have a small menu appear. Then you can drag and drop episodes individually to make the perfect list.
## Feed priority
Each feed has a priority, which is a number from 0 to 100. By default it is set at 50, but you can adjust it.
A high number gives a high priority. Priority is used for 2 things:
* Downloading: for both feed update and episode download, AntennaPod will first treat high priority feeds, then process lower ones.
* Episodes sorting: in the advanced or expert sort mode, AntennaPod can use this priority.
A feed with a priority of 0 is disabled: AntennaPod will not update it, and will not download any episode. This is a way to temporarily disable or unsubscribe.