aboutsummaryrefslogtreecommitdiff
path: root/doc/plugins/contrib/ikiwiki/directive/trailitems.mdwn
blob: 4106ed33bf0783835f7a78bccca339a105478f39 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
The `trailitems` directive is supplied by the
[[!iki plugins/contrib/trail desc=trail]] plugin. It adds pages
to the trail represented by the current page, without producing any output
on that page.

    \[[!trailitems pages="posts/*" sort="age"]]

    \[[!trailitems pagenames="a b c"]]

Options are similar to [[!iki ikiwiki/directive/inline desc=inline]]:

* `pages`: adds pages that match a [[ikiwiki/PageSpec]] to the trail
  (cannot be used with `pagenames`)

* `pagenames`: adds a space-separated list of pages to the trail,
  with the same [[ikiwiki/SubPage/LinkingRules]] as for a [[ikiwiki/WikiLink]]
  (cannot be used with `pages`)

* `sort`: add the pages matched by `pages` to the trail in this
  [[ikiwiki/pagespec/sorting]] order (cannot be used with `pagenames`)

* `reverse`: reverse the order of `sort` (cannot be used with `pagenames`)

[[!meta robots="noindex, follow"]]