20 Sep
2010
20 Sep
'10
6:14 p.m.
On Sep 20, 2010, at 3:10 PM, Vincent Massol wrote:
Hi,
The discussion started in http://xwiki.markmail.org/thread/hqvmy34jfknb2waa but since
it's an important decision I'm making it a full thread here.
The idea is to know how we want to represent query string and anchors in links to
documents in XWiki Syntax 2.1.
In 2.0 we were using: [[label>>whatever?queryString#anchor]]
The proposal is to move query string and anchor to a link parameter.
It be done like this:
[[label>>doc:mypage||parameters="a=b&c=d" anchor="..."]]
We could decide to use another syntax for parameters (ie query string) such as:
[[label>>doc:mypage||parameters="a=b,c=d" anchor="..."]]
Actually I think we have 2 options only:
1) [[label>>doc:mypage||queryString="a=b&c=d"
anchor="..."]]
2) [[label>>doc:mypage||parameters="a=b,c=d" anchor="..."]]
1) means we consider that all renderers will only deal with URLs, which is probably true
in practice but not 100% sure...
2) is more neutral and doesn't imply URL but may be less natural to users used to
HTML/HTTP.
WDYT?
Thanks
-Vincent
This would make it a little bit less URL-specific.
The pros of this approach are:
- no need for the user to escape the ? and # characters in document names
- makes the syntax a little bit less "magic" and more formal
The cons:
- Takes a bit longer to write
- A new syntax to learn
WDYT?
Thanks
-Vincent