add note to consider tagbase when trying to match tagged pages

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

diff --git a/doc/ikiwiki/directive/tag.mdwn b/doc/ikiwiki/directive/tag.mdwn
index 267aee660d52d0c53f68aeb1cf63cbc2379c753a..64736f8cddfd0ec31ad05231a19f01e7df28dfc6 100644 (file)
--- a/doc/ikiwiki/directive/tag.mdwn
+++ b/doc/ikiwiki/directive/tag.mdwn
@@ -21,6 +21,10 @@ 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.
 
 avoid having to write the full path to tags, if you want to keep them
 grouped together out of the way.
 

+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:
 
 If you want to override the tagbase for a particular tag, you can use
 something like this: