ikiwiki (3.20130711) unstable; urgency=low
[ikiwiki.git] / doc / bugs / tags_base_dir_not_used_when_creating_new_tags.mdwn
1 I'm using the tags plugin with tagbase="tags".
2
3 Already existing tags, corresponding to pages like tags/foo.html work just
4 fine.
5
6 If I add to a page a tag which is not existing (e.g. with [[!tag newtag]])
7 the just modified page will have a link which point to tags/newtag. This is
8 in theory correct, but in practice leads to creating a tags/newtag subpage
9 of the page I'm editing, while my tagbase is supposed to be relative to the
10 wiki root.
11
12 When used in a wiki which already have some tags this leads to mixing up
13 tags located in tags/ and tags located in whatever/tags/.
14
15 > When a new page is being edited, ikiwiki lets you chose where the page
16 > will be created, so you'll get a dropdown list of possible locations for
17 > the tag page. You should be able to choose between either tags/foo or
18 > page/tags/foo.
19 >
20 > The way that ikiwiki decides which location to default to in this box is
21 > fairly involved; but in general it will default to creating the page at
22 > the same level as the tagged page. So if the tag is on any toplevel page
23 > in the wiki, it will default to creating `tags/foo`; if the tag is on a
24 > page in a subdirectory, it will default to creating subdir/tags/foo.
25 >
26 > I personally like this behavior; it allows me to create a subdirectory
27 > for a particular thing and use tags that are specific to that thing,
28 > which are kept confined to that subdirectory by default. For example,
29 > this is used for ikiwiki's own plugins tags, which are all located
30 > under plugins/type/* and which apply to pages under plugins/*.
31 >
32 > It's clearly not the right default for every situation though. Explcitly
33 > setting a tagbase probably lessons the likelyhood that it's the right
34 > default for things under that tag base. I'd not be opposed to adding a
35 > special case to change the default in this case, or adding a
36 > configuration option to change the default globally. On the other hand,
37 > it is pretty simple to just check the location and select the right one
38 > from the list when creating a new page..
39
40 > --[[Joey]]
41
42 > And, this is [[done]], creating tags with tagbase will put them under the
43 > tagbase, unless the tag name starts with "/". --[[Joey]]