+1 for Proposal 2 Thanks, Caty
On Tue, Apr 30, 2013 at 2:26 PM, Denis Gervalle <[email protected]> wrote: > Hi devs, > > I have a very bad feeling with proposal 3, since it split the identifier, > which makes its main part to loose its meaning when taken alone. So you > cannot comunicate the whole information easily on different channels (think > about copy/pasting such reference ?). This is also really verbose, sometime > it looks odd, and I found it to be complex from a user view point. > Moreover, it could not be easily applied in other situation than links, > while ressource identification is not limited to links (think about a macro > arguments ?, see MotionComposer macro that imitate image: for an example). > I know it is hard, but I am currently -1 for this proposal. > > If we look at large, what we really need and intend to achieve is to have > an extensible syntax to identify ressources in XWiki. There is obviously a > ready made standardized syntax for such purpose: URN. Proposal 1 is really > near that specification (but too verbose for URL), but I agree with Thomas > that users will complains to be forced to use doc: everywhere. This is > precisely why I made proposal 2, which will fully avoid that constrains for > user of single wikis (a lot of our user since XE was our mostly downloaded > distribution until now). > > So my vote are (sorry Vincent, but your request to have a truly single vote > is far too restrictive for this matter) > +1 to really conform with a URN syntax as much as possible (remove the > useless verbosity for URL). > Proposal 1: +0 > Proposal 2: +1 > Proposal 3: -1 > > Thanks, > > > > On Tue, Apr 30, 2013 at 12:30 PM, Vincent Massol <[email protected]> > wrote: > > > Typos below. > > > > On Apr 30, 2013, at 11:02 AM, Vincent Massol <[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]] > > > > Should be [[label>>path:/some/path]] > > > > > * [[label>>http://xwiki.org]] or [[label>>>url:http://xwiki.org]] > > > > Should be [[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"]] > > > > Should be [[label>>/some/path||type="path"]] > > > > > * [[label>>http://xwiki.org]] or [[label>>>http://xwiki.org > > ||type="url"]] > > > > Should be [[label>>http://xwiki.org]] or [[label>>http://xwiki.org > > ||type="url"]] > > > > Thanks > > -Vincent > > > > > * [[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 > > > > > > -- > Denis Gervalle > SOFTEC sa - CEO > eGuilde sarl - CTO > _______________________________________________ > devs mailing list > [email protected] > http://lists.xwiki.org/mailman/listinfo/devs > _______________________________________________ devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
