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.