cleanups

[ikiwiki.git] / doc / tags.mdwn

diff --git a/doc/tags.mdwn b/doc/tags.mdwn
index 8d3a85cef0ecd54fbfef86bac015fb6c85663602..a210df09c563cecd94322e33dc6a513d8e5d3433 100644 (file)
--- a/doc/tags.mdwn
+++ b/doc/tags.mdwn
@@ -1,19 +1,23 @@
 While ikiwiki supports hierarchically categorising pages by creating
 While ikiwiki supports hierarchically categorising pages by creating

-[[SubPage]]s, that's often not flexible enough, and it can also be useful
-to tag pages in various non-hierarchical ways.
+[[SubPages|ikiwiki/SubPage]], that's often not flexible enough, and it can also be
+useful to tag pages in various non-hierarchical ways.

 
 

-Since this is a wiki, tagging is just a form of linking. For example, since
-this page links to [[features]], it can be considered to have something to
-do with ikiwiki's features. If you want to put pages into a category, the
-typical wiki way to do so is to create a "CategoryFoo" page and link pages
-in the category to it. That is just another form of tagging.
+Since this is a wiki, tagging is just a form of linking. The general rule
+is that all tags are links, but not all links are tags. So a tag is a
+special link that ikiwiki knows is intended to be used as a tag.

 
 

-Sometimes you may want to tag a page without putting a visible link on it.
+Generally you will tag a page without putting a visible link on it.

 The [[tag_plugin|plugins/tag]] allows you to do so, like this:
 
        \[[tag mytag othertag thirdtag]]
 
 The [[tag_plugin|plugins/tag]] allows you to do so, like this:
 
        \[[tag mytag othertag thirdtag]]
 

-One way to use these tags is to create a [[blog]] of pages that have a
+You can also tag a page with a visible link:
+
+       \[[taglink mytag]]
+
+This tag will be displayed just like a regular [[ikiwiki/WikiLink]].
+
+One way to use these tags is to create a [[ikiwiki/blog]] of pages that have a

 particular set of tags. Or just look at the [[BackLinks]] to a tag page to
 see all the pages that are tagged with it. [[Plugins]] can be written to do
 anything else with tags that you might desire.
 particular set of tags. Or just look at the [[BackLinks]] to a tag page to
 see all the pages that are tagged with it. [[Plugins]] can be written to do
 anything else with tags that you might desire.