added toc

[ikiwiki.git] / doc / ikiwiki / directive / tag.mdwn

diff --git a/doc/ikiwiki/directive/tag.mdwn b/doc/ikiwiki/directive/tag.mdwn
index a6e1833a44baa14df10c20868800e62d58a3f53e..c8d9b98169fd7055b71a785786f747fea2ebc7c7 100644 (file)
--- a/doc/ikiwiki/directive/tag.mdwn
+++ b/doc/ikiwiki/directive/tag.mdwn
@@ -1,4 +1,4 @@
-The `tag` and `taglink` directives are supplied by the [[!iki plugins/tag]] plugin.
+The `tag` and `taglink` directives are supplied by the [[!iki plugins/tag desc=tag]] plugin.
 
 These directives allow tagging pages. List tags as follows:
 
@@ -19,12 +19,17 @@ instead:
 Note that if the wiki is configured to use a tagbase, then the tags will be
 located under a base directory, such as "tags/". This is a useful way to
 avoid having to write the full path to tags, if you want to keep them
-grouped together out of the way.
+grouped together out of the way. Also, since ikiwiki then knows where to put
+tags, it will automatically create tag pages when new tags are used.
+
+Bear in mind that specifying a tagbase means you will need to incorporate it
+into the `link()` [[ikiwiki/PageSpec]] you use: e.g., if your tagbase is
+`tag`, you would match pages tagged "foo" with `link(tag/foo)`.
 
 If you want to override the tagbase for a particular tag, you can use
 something like this:
 
-       \[[!tag ./foo]]
+       \[[!tag /foo]]
        \[[!taglink /foo]]
 
 [[!meta robots="noindex, follow"]]