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 * `mtime` - List pages with the most recently modified first.
   8 * `title` - Order by title (page name).
   9 * `title_natural` - Only available if [[!cpan Sort::Naturally]] is
  10   installed. Orders by title, but numbers in the title are treated
  11   as such, ("1 2 9 10 20" instead of "1 10 2 20 9")
  12 [[!if test="enabled(meta)" then="""
  13 * `meta_title` - Order according to the `\[[!meta title="foo" sort="bar"]]`
  14   or `\[[!meta title="foo"]]` [[ikiwiki/directive]], or the page name if no
  15   full title was set.
  16 """]]
  17
  18 In addition, you can combine several sort orders and/or reverse the order of
  19 sorting, with a string like `age -title` (which would sort by age, then by
  20 title in reverse order if two pages have the same age).
  21
  22 Plugins can add additional sort orders, so more might be available on this
  23 wiki.
  24
  25 [[!meta robots="noindex, follow"]]