web commit by madmax
[ikiwiki] / doc / tags.mdwn
1 While ikiwiki supports hierarchically categorising pages by creating
2 [[SubPage]]s, that's often not flexible enough, and it can also be useful
3 to tag pages in various non-hierarchical ways.
4
5 Since this is a wiki, tagging is just a form of linking. For example, since
6 this page links to [[features]], it can be considered to have something to
7 do with ikiwiki's features. If you want to put pages into a category, the
8 typical wiki way to do so is to create a "CategoryFoo" page and link pages
9 in the category to it. That is just another form of tagging.
10
11 Sometimes you may want to tag a page without putting a visible link on it.
12 The [[tag_plugin|plugins/tag]] allows you to do so, like this:
13
14         \[[tag mytag othertag thirdtag]]
15
16 One way to use these tags is to create a [[blog]] of pages that have a
17 particular set of tags. Or just look at the [[BackLinks]] to a tag page to
18 see all the pages that are tagged with it. [[Plugins]] can be written to do
19 anything else with tags that you might desire.
20
21 Once you have tags, you can use the [[plugins/pagestats]] plugin to
22 generate tag clouds.