aboutsummaryrefslogtreecommitdiff
path: root/doc/tags.mdwn
blob: c8f31423df7dbcfb760c854ec689f00afbc9a53d (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
While ikiwiki supports hierarchically categorising pages by creating
[[SubPages|ikiwiki/SubPage]], that's often not flexible enough, and it can also be
useful to tag pages in various non-hierarchical ways.

Since this is a wiki, tagging is just a form of linking. The general rule
is that all tags are links, but not all links are tags. So a tag is a
special link that ikiwiki knows is intended to be used as a tag.

Generally you will tag a page without putting a visible link on it.
The [[tag_plugin|plugins/tag]] allows you to do so, like this:

	\[[!tag mytag othertag thirdtag]]

You can also tag a page with a visible link:

	\[[!taglink mytag]]

This tag will be displayed just like a regular [[ikiwiki/WikiLink]].

One way to use these tags is to create a [[blog]] of pages that have a
particular set of tags. Or just look at the [[BackLinks]] to a tag page to
see all the pages that are tagged with it. [[Plugins]] can be written to do
anything else with tags that you might desire.

Once you have tags, you can use the [[plugins/pagestats]], [[plugins/inline]] or [[plugins/map]] plugins to
generate tag clouds and lists.