ikiwiki (3.20130711) unstable; urgency=low
[ikiwiki.git] / doc / ikiwiki / directive / trailitems.mdwn
1 The `trailitems` directive is supplied by the
2 [[!iki plugins/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`: if used instead of `pages`, this is interpreted as a
16   space-separated list of absolute page names
17   ([[SubPage/LinkingRules]] are not taken into account)
18   to add to the trail
19
20 * `sort`: add the pages matched by `pages` to the trail in this
21   [[ikiwiki/pagespec/sorting]] order (cannot be used with `pagenames`)
22
23 * `reverse`: reverse the order of `sort` (cannot be used with `pagenames`)
24
25 [[!meta robots="noindex, follow"]]