On Tue, Apr 30, 2013 at 5:29 PM, Marius Dumitru Florea <
mariusdumitru.florea(a)xwiki.com> wrote:
On Tue, Apr 30, 2013 at 2:26 PM, Denis Gervalle
<dgl(a)softec.lu> 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).
Are you referring to URI? because URN and URL are complementary. An
URL is not a URN.
My bad, obviously, I was thinking URI and not URN (which is what we could
mainly use for URI of our internal ressource however).
+1 for proposal 2, but as Thomas, I'm not fully
decided.
Thanks,
Marius
Proposal 1: +0
Proposal 2: +1
Proposal 3: -1
Thanks,
On Tue, Apr 30, 2013 at 12:30 PM, Vincent Massol <vincent(a)massol.net>
wrote:
> Typos below.
>
> On Apr 30, 2013, at 11:02 AM, Vincent Massol <vincent(a)massol.net>
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:space.page@image.png]]
> > * [[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:space.page@image.png]]
* [[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"]]
||type="url"]]
Should be [[
label>>http://xwiki.org]] or [[
label>>http://xwiki.org
||type="url"]]
Thanks
-Vincent
*
[[label>>evalica||type="user"]]
* [[image:wiki:space.page@image.png]] or
[[image:wiki:space.page@image.png||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
devs(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs
--
Denis Gervalle
SOFTEC sa - CEO
eGuilde sarl - CTO
_______________________________________________
devs mailing list
devs(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs
_______________________________________________
devs mailing list
devs(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs