]> sipb.mit.edu Git - ikiwiki.git/blob - doc/ikiwiki/pagespec/sorting.mdwn
use trailinline for the example blog so it gets next/prev links
[ikiwiki.git] / doc / ikiwiki / pagespec / sorting.mdwn
1 Some [[directives|ikiwiki/directive]] that use
2 [[PageSpecs|ikiwiki/pagespec]] allow
3 specifying the order that matching pages are shown in. The following sort
4 orders can be specified.
5
6 * `age` - List pages from the most recently created to the oldest.
7
8 * `mtime` - List pages with the most recently modified first.
9
10 * `title` - Order by title (page name).
11 [[!if test="enabled(sortnaturally)" then="""
12 * `title_natural` - Orders by title, but numbers in the title are treated
13   as such, ("1 2 9 10 20" instead of "1 10 2 20 9")
14 """]]
15 [[!if test="enabled(meta)" then="""
16 * `meta(title)` - Order according to the `\[[!meta title="foo" sortas="bar"]]`
17   or `\[[!meta title="foo"]]` [[ikiwiki/directive]], or the page name if no
18   full title was set. `meta(author)`, `meta(date)`, `meta(updated)`, etc.
19   also work.
20 """]]
21
22 In addition, you can combine several sort orders and/or reverse the order of
23 sorting, with a string like `age -title` (which would sort by age, then by
24 title in reverse order if two pages have the same age).
25
26 [[!meta robots="noindex, follow"]]