Merge tag '3.20120202' into trail3-integrated
[ikiwiki.git] / doc / plugins / contrib / ikiwiki / directive / trailitems.mdwn
1 The `trailitems` directive is supplied by the
2 [[!iki plugins/contrib/trail desc=trail]] plugin. It adds pages
3 to the trail represented by the current page, without producing any output
4 on that page.
5
6     \[[!trailitems pages="posts/*" sort="age"]]
7
8     \[[!trailitems pagenames="a b c"]]
9
10 Options are similar to [[!iki ikiwiki/directive/inline desc=inline]]:
11
12 * `pages`: adds pages that match a [[ikiwiki/PageSpec]] to the trail
13   (cannot be used with `pagenames`)
14
15 * `pagenames`: adds a space-separated list of pages to the trail,
16   with the same [[ikiwiki/SubPage/LinkingRules]] as for a [[ikiwiki/WikiLink]]
17   (cannot be used with `pages`)
18
19 * `sort`: add the pages matched by `pages` to the trail in this
20   [[ikiwiki/pagespec/sorting]] order (cannot be used with `pagenames`)
21
22 * `reverse`: reverse the order of `sort` (cannot be used with `pagenames`)
23
24 [[!meta robots="noindex, follow"]]