2014-10-20 10:52 GMT+02:00 [email protected] <[email protected]>:
>
>
>
>
>
> On 20 Oct 2014 at 10:37:32, Jeremie BOUSQUET ([email protected]
> (mailto:[email protected])) wrote:
>
> > Hi,
> >
> > Just an idea - sorry if it's stupid :)
> >
> > So roughly current syntax, but adding in syntax a way to escape a
> reserved
> > keyword ?
> > For example:
> > [[label>>user:evalica]]
> > ... is a reference to user profile of evalica, even if wiki "user"
> exists.
> > While:
> > [[label>>'user':evalica]] or [[label>>"user":evalica]]
> > ... is a non ambigüous reference to space "evalica" in wiki "user".
> > Or to reference a page in a wiki named "doc" :
> [[label>>"doc":space.page]]
> > (instead of [[label>>doc:doc:space.page]] )
> > So everytime I put something between quotes, it means that I consider it
> a
> > real entity name.
> >
>
>
> That doesn't work unfortunately ;) Remember that the goal was to be
> backward-compatible:
> - users will use "somewiki:somespace.somepage" all the time. They wouldn't
> use the quoted form everywhere as otherwise it would mean a new syntax per
> see
> - when an extension (or a new syntax version) adds support for a new
> resource type, all existing links that conflict with it are broken.
>
> Example:
>
> - a user has a "user" subwiki and creates link to it:
> [[label>>user:space.page]]
> - the admin installs a new extension that registers a new resource type
> for "user"
> - existing links to the "user" wiki are broken.
>
You're right, I thought only about migrations of syntax 2.1 to 2.2 or
further, that could escape existing links, but I didn't think about this
use-case of dynamic registering of new resource types ...
In this case I feel that "::" is closer to the ":" used currently and
avoids adding a different separator character ... It also goes in the
direction of doubling everything in wiki syntaxes :D ( "[[", ">>", "**" ...)
'=' and '#' seem too meaningful already ('=' for assignments, macros
properties, ...; '#' for anchors).
>
> Thanks
> -Vincent
>
>
> > BR,
> > Jeremie
> >
> >
> > 2014-10-20 10:03 GMT+02:00 Guillaume "Louis-Marie" Delhumeau <
> > [email protected]>:
> >
> > > 2014-10-17 17:36 GMT+02:00 [email protected] :
> > >
> > > > I’ve read again both threads. Not an easy decision...
> > > >
> > > > Some thoughts:
> > > >
> > > > * I don't like any of the proposed solutions so far because they all
> make
> > > > it harder to create links than what user already do in XWiki Syntax
> 2.0
> > > or
> > > > 2.1
> > > > * Solution 2 (forcing using the "doc" prefix when creating links to
> > > > subwikis) is the solution that gathered the most votes. However when
> I
> > > > think about solution 2 I think about xwiki.org and all the links I
> > > create
> > > > every week from one wiki to another and I can't refrain from thinking
> > > that
> > > > it's going to make more complex to create them.
> > > > * I can understand why some didn't like my proposal to have a
> shortcut
> > > > syntax for links and a canonical one for typed references. Basically
> it's
> > > > too complex for users.
> > > >
> > > > In order to be complete, there's another possibility which is to
> change
> > > > the delimiter for wikis or for reference types. Obviously it
> wouldn't be
> > > > possible to change the delimiter for wikis (i.e. the ":" in
> > > > "wiki:space.page") so remains the option to change the delimiter for
> > > > reference types.
> > > >
> > > > Here are some ideas for exploring this direction:
> > > >
> > > > Solution 10
> > > > ===========
> > > >
> > > > * [[label>>wiki:space.page]]
> > > > * [[label>>doc::wiki:space.page]]
> > > > * [[label>>path::/some/path]]
> > > > * [[label>>http://xwiki.org]]
> > > > * [[label>>url::http://xwiki.org]]
> > > > * [[label>>user::evalica]]
> > > > * [[image:wiki:[email protected]]]
> > > > * [[image:doc::wiki:[email protected]]]
> > > > * [[image:icon::someicon.png]]
> > > >
> > > > PROs:
> > > > * Syntax remains the shorter possible for links to docs and URLs
> > > > * Adding a new reference type doesn't break existing links/images
> > > >
> > > > CONs:
> > > > * When using typed links/images, it's bit longer to type ("::"
> instead of
> > > > ":")
> > > > * Small change of syntax for users but the majority of users use the
> > > > shorthand notation
> > > > * Still a URI! (even if a weird one)
> > > > * Force to escape the ":" (with "~:") for spaces or documents
> starting
> > > > with ":"
> > > >
> > > > Solution 11
> > > > ===========
> > > >
> > > > Using URL-like notation:
> > > >
> > > > * [[label>>wiki:space.page]]
> > > > * [[label>>doc://wiki:space.page]]
> > > > * [[label>>path:///some/path]]
> > > > * [[label>>http://xwiki.org]]
> > > > * [[label>>https://xwiki.org]]
> > > > * [[label>>url://http://xwiki.org]]
> > > > * [[label>>user://evalica]]
> > > > * [[image:wiki:[email protected]]]
> > > > * [[image:doc://wiki:[email protected]]]
> > > > * [[image:icon://someicon.png]]
> > > >
> > > > Compared to solution 10:
> > > >
> > > > PROs:
> > > > * Uses a notation closer to a URL (could be a CONs too!)
> > > >
> > > > CONs:
> > > > * One more character to type "://" vs "::"
> > > > * A bit strange when linking to URLs using the typed syntax ("url://
> > > > http://xwiki.org";)
> > > > * Need to use the typed syntax for URLs other than "http" and "https"
> > > > (e.g. for specific URL schemes, like "ftp": "url://ftp://192.168.0.1
> ")
> > > >
> > > > Solution 12
> > > > ===========
> > > >
> > > > Then there are other possible notations such as:
> > > >
> > > > * [[label>>wiki:space.page]]
> > > > * [[label>>doc#wiki:space.page]]
> > > > * [[label>>path#/some/path]]
> > > > * [[label>>http://xwiki.org]]
> > > > * [[label>>url#http://xwiki.org]]
> > > > * [[label>>user#evalica]]
> > > > * [[image:wiki:[email protected]]]
> > > > * [[image:doc#wiki:[email protected]]]
> > > > * [[image:icon#someicon.png]]
> > > >
> > > > Solution 13
> > > > ===========
> > > >
> > > > Or:
> > > >
> > > > * [[label>>wiki:space.page]]
> > > > * [[label>>doc=wiki:space.page]]
> > > > * [[label>>path=/some/path]]
> > > > * [[label>>http://xwiki.org]]
> > > > * [[label>>url=http://xwiki.org]]
> > > > * [[label>>user=evalica]]
> > > > * [[image:wiki:[email protected]]]
> > > > * [[image:doc=wiki:[email protected]]]
> > > > * [[image:icon=someicon.png]]
> > > >
> > > > Personally I'm still hesitating but seen that the majority of use
> cases
> > > > are for links to documents,
> > > >
> > > I think I'd like a solution that doesn't change the shorthand syntax
> for
> > > > linking to documents.
> > > >
> > >
> > > +1
> > >
> > >
> > > >
> > > > So I'm still ok with Solution A (i.e. don't do anything) and baring
> that,
> > > > solution 10 also seems acceptable to me, seen that we don't use the
> typed
> > > > syntax that often so simple users won't see their habits changed.
> > > >
> > > > WDYT?
> > > >
> > >
> > > I feel that the solution 13 (with "=") is more natural to me that the
> "::"
> > > notation.
> > >
> > >
> > > >
> > > > Thanks
> > > > -Vincent
> > > >
> > > >
> > > > On 30 Apr 2013 at 11:02:46, Vincent Massol ([email protected]
> (mailto:
> > > > [email protected])) wrote:
> > > >
> > > > > Hi devs,
> > > > >
> > > > > Following this thread http://markmail.org/thread/vw3derowozijqalr
> it
> > > > seems clear that we need to introduce a better syntax for links and
> > > images
> > > > in XWiki Syntax 2.2 (in order to cope with use cases such as
> > > > http://jira.xwiki.org/jira/browse/XRENDERING-290).
> > > > >
> > > > > The need is to be able to plug new reference type handlers without
> > > > breaking backward compatibility in XWiki Syntax 2.2 (since right now
> with
> > > > XWiki Syntax 2.0 and 2.1 adding a new type reference handler would
> break
> > > > backward compatibility).
> > > > >
> > > > > So here are various proposals to that effect for XWiki Syntax 2.2
> (I've
> > > > only kept the interesting proposals from the previous thread). Please
> > > vote
> > > > for the one you prefer or add new solutions if you have other better
> > > ideas.
> > > > >
> > > > > Proposal 1
> > > > > =========
> > > > >
> > > > > Force XWiki Syntax 2.2 to *ALWAYS* use the full form when creating
> a
> > > > link or image, i.e. all links would need to be written:
> > > > [[label>>type:reference]]
> > > > >
> > > > > Examples:
> > > > > * [[label>>doc:space.page]]
> > > > > * [[label>>doc:wiki:space.page]]
> > > > > * [[label>>path:/some/path]]
> > > > > * [[label>>url:http://xwiki.org]]
> > > > > * [[label>>user:evalica]]
> > > > > * [[image:doc:wiki:[email protected]]]
> > > > > * [[image:icon:someicon.png]]
> > > > >
> > > > > CONS:
> > > > > * Harder to write links to documents which is the main use case
> > > > >
> > > > > Proposal 2
> > > > > =========
> > > > >
> > > > > Same as with XWiki Syntax 2.1 but for links or images to subwikis
> force
> > > > the user to use the "doc:" notation
> > > > >
> > > > > Examples:
> > > > > * [[label>>space.page]] or [[label>>doc:space.page]]
> > > > > * [[label>>doc:wiki:space.page]]
> > > > > * [[label>>>path:/some/path]]
> > > > > * [[label>>http://xwiki.org]] or [[label>>>url:http://xwiki.org]]
> > > > > * [[label>>user:evalica]]
> > > > > * [[image:doc:wiki:[email protected]]]
> > > > > * [[image:icon:someicon.png]]
> > > > >
> > > > > PRO:
> > > > > * Still easy to reference docs and images in the current wiki
> > > > > * Close to current XWiki Syntax 2.1
> > > > >
> > > > > CONS:
> > > > > * Harder to write links to documents in subwikis (for workspaces
> users
> > > > for example, see example of xwiki.org)
> > > > >
> > > > > Proposal 3
> > > > > =========
> > > > >
> > > > > Always define the type as a link or image parameter, i.e. separate
> > > > subwiki notation from type.
> > > > >
> > > > > Examples:
> > > > > * [[label>>space.page]] or [[label>>space.page||type="doc"]]
> > > > > * [[label>>wiki:space.page]] or
> [[label>>wiki:space.page||type="doc"]]
> > > > > * [[label>>>/some/path||type="path"]]
> > > > > * [[label>>http://xwiki.org]] or [[label>>>http://xwiki.org
> > > > ||type="url"]]
> > > > > * [[label>>evalica||type="user"]]
> > > > > * [[image:wiki:[email protected]]] or
> > > > [[image:wiki:[email protected]||type="doc"]]
> > > > > * [[image:someicon.png||type="icon"]]
> > > > >
> > > > > PRO:
> > > > > * Still easy to reference docs
> > > > > * Clear separation between subwiki and types
> > > > >
> > > > > CONS:
> > > > > * Harder to write typed links
> > > > > * Harder to write references in non xwiki/2.x syntax that would not
> > > > support link parameters
> > > > >
> > > > > Thanks
> > > > > -Vincent
> > > > >
> > > > >
> > > > _______________________________________________
> > > > devs mailing list
> > > > [email protected]
> > > > http://lists.xwiki.org/mailman/listinfo/devs
> > > >
> > >
> > >
> > >
> > > --
> > > Guillaume Delhumeau ([email protected])
> > > Research & Development Engineer at XWiki SAS
> > > Committer on the XWiki.org project
> > > _______________________________________________
> > > devs mailing list
> > > [email protected]
> > > http://lists.xwiki.org/mailman/listinfo/devs
> > >
> > _______________________________________________
> > devs mailing list
> > [email protected]
> > http://lists.xwiki.org/mailman/listinfo/devs
> _______________________________________________
> devs mailing list
> [email protected]
> http://lists.xwiki.org/mailman/listinfo/devs
>
_______________________________________________
devs mailing list
[email protected]
http://lists.xwiki.org/mailman/listinfo/devs
