Changes between Version 6 and Version 7 of 0.12/TracLinks

Timestamp:

Apr 10, 2010, 2:12:35 PM (14 years ago)

Author:

Christian Boos

Comment:

discuss #sibling links

0.12/TracLinks

@@ -130 +130 @@
   [..] or [[..]]
 }}}
-   [..] or [[..]]
-
-To link from a [trac:SubWiki SubWiki] page to a sibling page, use a '../':
+  [..] or [[..]]
+
+To link from a [trac:SubWiki SubWiki] page to a [=#sibling sibling] page, use a '../':
 {{{
   [../Sibling see next sibling] or [[../Sibling|see next sibling]]
 }}}
- [../Sibling see next sibling] or [[../Sibling|see next sibling]]
-
-''(Changed in 0.11)'' Note that in Trac 0.10, using e.g. `[../newticket]`  may have worked for linking to the /newticket top-level URL, but now in 0.11 it will stay in the wiki namespace and link to a sibling page. See [#Server-relativelinks] for the new syntax.
+  [../Sibling see next sibling] or [[../Sibling|see next sibling]]
+
+But in practice you often won't need to add the `../` prefix to link to a sibling page.
+For resolving the location of a wiki link, it's the target page closest in the hierarchy
+to the page where the link is written which will be selected. So for example, within 
+a sub-hierarchy, a sibling page will be targeted in preference to a toplevel page.
+This makes it easy to copy or move pages to a sub-hierarchy by [[WikiNewPage#renaming|renaming]] without having to adapt the links.
+
+In order to link explicitly to a [=#toplevel toplevel] Wiki page,
+use the `wiki:/` prefix.
+Be careful **not** to use the `/` prefix alone, as this corresponds to the
+[#Server-relativelinks] syntax and with such a link you will lack the `/wiki/` 
+part in the resulting URL.
+
+''(Changed in 0.11)'' Note that in Trac 0.10, using e.g. `[../newticket]`  may have worked for linking to the `/newticket` top-level URL, but since 0.11, such a link will stay in the wiki namespace and therefore link to a sibling page. 
+See [#Server-relativelinks] for the new syntax.
 
 === InterWiki links ===