git.oblomov.eu Git - ikiwiki/blob - doc/plugins/tag.mdwn

   1 [[template id=plugin name=tag included=1 author="[[Joey]]"]]
   2 [[tag type/tags type/link]]
   3
   4 This plugin allows tagging pages. List tags as follows:
   5
   6         \[[tag tech life linux]]
   7
   8 The tags work the same as if you had put a (hidden) [[WikiLink]] on the page
   9 for each tag, so you can use a [[PageSpec]] match all pages that are
  10 tagged with a given tag, for example. The tags will also show up on blog
  11 entries and at the bottom of the tagged pages, as well as in RSS and Atom
  12 feeds.
  13
  14 This plugin has a configuration option. Set --tagbase=tag and links to tags
  15 will be located under the specified base page. If ikiwiki is configured
  16 this way, then the example above actually tags the page with the tags
  17 tags/tech, tags/life, and tags/linux. This is a useful way to avoid
  18 having to write the full path to tags, if you want to keep them grouped
  19 together out of the way.
  20
  21 If this plugin is enabled, you'll see a note below that this page is tagged
  22 with the "tags" tag.