aboutsummaryrefslogtreecommitdiff
path: root/doc/plugins/testpagespec.mdwn
blob: 36043cae82e989093c0988011928a4035fb6b20e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
[[!template id=plugin name=testpagespec author="[[Joey]]"]]
[[!tag type/useful]]

This plugin allows testing a [[ikiwiki/PageSpec]] to see if it matches a
page, and to see the part that matches, or causes the match to fail.

Example uses:

	\[[testpagespec pagespec="foopage and barpage" match="foopage"]]

This will print out something like "no match: barpage does not match
foopage", highlighting which part of the [[ikiwiki/PageSpec]] is causing
the match to fail.
	
	\[[testpagespec pagespec="foopage or !bar*" match="barpage"]]

This will print out something like "no match: bar* matches barpage", since
the part of the [[ikiwiki/PageSpec]] that fails is this negated match.
	
	\[[testpagespec pagespec="foopage or barpage" match="barpage"]]

This will print out something like "match: barpage matches barpage",
indicating the part of the [[ikiwiki/PageSpec]] that caused it to match.