]> git.vanrenterghem.biz Git - git.ikiwiki.info.git/blob - doc/tags.mdwn
f16aa619b9247ad5d7c9329892e948fa86259ce8
[git.ikiwiki.info.git] / doc / tags.mdwn
1 While ikiwiki supports hierarchically categorising pages by creating
2 [[SubPages|ikiwiki/SubPage]], that's often not flexible enough, and it can also be
3 useful to tag pages in various non-hierarchical ways.
5 Since this is a wiki, tagging is just a form of linking. The general rule
6 is that all tags are links, but not all links are tags. So a tag is a
7 special link that ikiwiki knows is intended to be used as a tag.
9 Generally you will tag a page without putting a visible link on it.
10 The [[tag_plugin|plugins/tag]] allows you to do so, like this:
12         \[[!tag mytag othertag thirdtag]]
14 You can also tag a page with a visible link:
16         \[[!taglink mytag]]
18 This tag will be displayed just like a regular [[ikiwiki/WikiLink]].
20 One way to use these tags is to create a [[blog]] of pages that have a
21 particular set of tags. Or just look at the [[BackLinks]] to a tag page to
22 see all the pages that are tagged with it. [[Plugins]] can be written to do
23 anything else with tags that you might desire.
25 Once you have tags, you can use the [[plugins/pagestats]] or [[plugins/map]] plugins to
26 generate tag clouds and lists.