Last modified by Thomas Mortagne on 2023/10/13

<
From version < 26.1 >
edited by Vincent Massol
on 2016/01/25
To version < 26.2 >
edited by Eduard Moraru
on 2016/01/27
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.VincentMassol
1 +XWiki.enygma
Content
... ... @@ -14,6 +14,20 @@
14 14  
15 15  <description of feature N>
16 16  
17 +== Link syntax improvements for Nested Pages ==
18 +
19 +With the addition of Nested Pages, a discrepancy appeared between the UI and the wiki syntax. The UI always talks about (nested) pages and never about spaces, but in the wiki syntax you would still have to specify both the space and the name of a page when linking to it (e.g. writing ##~[~[Some.Nested.Page.WebHome]]## if you want to create a link to the nested page ##Some.Nested.Page##). The same applies to ##~image:## or ##~attach:## syntax. The technical reason for this was that, at the wiki syntax level, untyped links were always being resolved to ##doc:## type links.
20 +
21 +To improve this, we have added a new ##space:## type link which allows you to simply write ##~[~[space:Some.Nested.Page]]## and have made this the new default type that untyped links resolve to.
22 +
23 +The outcome is that you can now simply type ##~[~[Some.Nested.Page]]## and you will create a link to the nested page ##Some.Nested.Page##.
24 +
25 +For backwards compatibility with the existing untyped links, we have implemented the same mechanism we have applied for URLs, which is to:
26 +* first try to link to a terminal page (i.e. if ##Some.Nested.Page## is actually a terminal page inside the ##Some.Nested## space; this was the previous default behavior)
27 +* if no such terminal page exists, then link to the non-terminal page (i.e. ##Some.Nested.Page.WebHome##) for both when the terminal page exists or when it does not (and should be a wanted link)
28 +
29 +The same thing applies for ##~image:## (e.g. ##~image:[email protected]## translates technically to ##~image:[email protected]##) and for ##~attach:## syntax (e.g. ##~attach:[email protected]## translates technically to ##~attach:[email protected]##).
30 +
17 17  == Miscellaneous ==
18 18  
19 19  * The WebDAV feature is [[now configured using Servlet 3.0 annotations>>||anchor="HIssuesspecifictoXWiki8.0Milestone1"]].

Get Connected