aboutsummaryrefslogtreecommitdiff
path: root/doc/plugins/tag.mdwn
blob: caffaa6924380dfdfcccbed97ad867a524105bd7 (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
25
26
27
28
29
[[template id=plugin name=tag author="[[Joey]]"]]
[[tag type/tags type/link]]

This plugin allows tagging pages. List tags as follows:

	\[[tag tech life linux]]

The tags work the same as if you had put a (hidden) [[WikiLink]] on the page
for each tag, so you can use a [[PageSpec]] match all pages that are
tagged with a given tag, for example. The tags will also show up on blog
entries and at the bottom of the tagged pages, as well as in RSS and Atom
feeds.

If you want a visible [[WikiLink]] along with the tag, use taglink instead:

	\[[taglink foo]]
	\[[taglink tagged_as_foo|foo]]

This plugin has a configuration option. Set --tagbase=tags and links to tags
will be located under the specified base page. If ikiwiki is configured
this way, then the example above actually tags the page with the tags
tags/tech, tags/life, and tags/linux. This is a useful way to avoid
having to write the full path to tags, if you want to keep them grouped
together out of the way.

[[if test="enabled(tag)" then="""
This wiki has the tag plugin enabled, so you'll see a note below that this
page is tagged with the "tags" tag.
"""]]