tags.mdwn 1.1 KB

123456789101112131415161718192021222324252627
  1. While ikiwiki supports hierarchically categorising pages by creating
  2. [[SubPages|ikiwiki/SubPage]], that's often not flexible enough, and it can also
  3. be useful to tag pages in various non-hierarchical ways.
  4. Since this is a wiki, tagging is just a form of linking. The general rule is
  5. that all tags are links, but not all links are tags. So a tag is a special link
  6. that ikiwiki knows is intended to be used as a tag.
  7. Generally you will tag a page without putting a visible link on it. The
  8. [[!iki plugins/tag desc="tag plugin"]] allows you to do so, like this:
  9. \[[!tag mytag othertag thirdtag]]
  10. You can also tag a page with a visible link:
  11. \[[!taglink mytag]]
  12. This tag will be displayed just like a regular [[ikiwiki/WikiLink]].
  13. One way to use these tags is to create a [[blog]] of pages that have a
  14. particular set of tags. Or just look at the [[BackLinks]] to a tag page to see
  15. all the pages that are tagged with it. [[Plugins]] can be written to do anything
  16. else with tags that you might desire.
  17. Once you have tags, you can use the [[!iki plugins/pagestats]] plugin to
  18. generate tag clouds.