[xwiki-devs] [Proposal] Consider Wiki Syntax to be advanced and working in the Nested Spaces paradigm
29 Jul
2015
29 Jul
'15
5:09 p.m.
Hi devs,
I had created JIRA issue http://jira.xwiki.org/browse/XWIKI-12304 entitled "Make
wanted wiki links create Nested Documents” but I’ve brainstormed with Edy and we don’t
agree about it anymore :)
We’d like to propose that when the user edits a document using the wiki editor then he’s
using the Nested Spaces paradigm (and thus uses “WebHome” to create links to Space homes)
and when he edits using the WYSIWYG editor he uses the Nested Document paradigm (no Space
concept, only create WebHome documents unless he’s an advanced user).
The rationale for this is that a lot of macros accept a reference parameter and I don’t
think we should change them to support hiding “WebHome” and do an automatic redirect. That
would be too complex. In addition, if you use a script macro, then you’ll also see WebHome
mentions.
Note that when editing a macro in WYSIWYG editor we’ll need to have a macro parameter
displayer for Reference-type parameters to display a tree, so that the non-technical
doesn’t have to enter “WebHome”.
WDYT?
Thanks
-Vincent
30 Jul
30 Jul
3:57 p.m.
Hi,
I'd like to make sure I'm understanding things correctly before commenting
further. Please see below.
On Wed, Jul 29, 2015 at 5:09 PM, vincent(a)massol.net <vincent(a)massol.net>
wrote:
Hi devs,
I had created JIRA issue http://jira.xwiki.org/browse/XWIKI-12304 entitled
"Make wanted wiki links create Nested Documents” but I’ve brainstormed with
Edy and we don’t agree about it anymore :)
We’d like to propose that when the user edits a document using the wiki
editor then he’s using the Nested Spaces paradigm (and thus uses “WebHome”
to create links to Space homes) and when he edits using the WYSIWYG editor
he uses the Nested Document paradigm (no Space concept, only create WebHome
documents unless he’s an advanced user).
Let's take an example. Say I'm on page .../A/B/C/ (so that's
"A.B.C.WebHome") and I want to create "D". What would happen with your
proposal is this:
- In WYSIWYG mode, I'll create a link to a new page called "D" and it
will automatically create a link to "A.B.C.D.WebHome"
- In Wiki mode, several possibilities:
- I create a link to [[D]] => it becomes a link to [[A.B.C.D]] (new
terminal document)
- I create a link to [[A.B.C.D]] (new terminal document)
- I create a link to [[A.B.C.D.WebHome]] (new nested space)
Is my understanding correct?
Thanks,
Guillaume
The rationale for this is that a lot of macros accept
a reference
parameter and I don’t think we should change them to support hiding
“WebHome” and do an automatic redirect. That would be too complex. In
addition, if you use a script macro, then you’ll also see WebHome mentions.
Note that when editing a macro in WYSIWYG editor we’ll need to have a
macro parameter displayer for Reference-type parameters to display a tree,
so that the non-technical doesn’t have to enter “WebHome”.
WDYT?
Thanks
-Vincent
_______________________________________________
devs mailing list
devs(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs
4:20 p.m.
Hi Guillaume,
On 30 Jul 2015 at 15:57:21, Guillaume Lerouge
(guillaume@xwiki.com(mailto:guillaume@xwiki.com)) wrote:
Hi,
I'd like to make sure I'm understanding things correctly before commenting
further. Please see below.
On Wed, Jul 29, 2015 at 5:09 PM, vincent(a)massol.net
wrote:
correct
Hi devs,
I had created JIRA issue http://jira.xwiki.org/browse/XWIKI-12304 entitled
"Make wanted wiki links create Nested Documents” but I’ve brainstormed with
Edy and we don’t agree about it anymore :)
We’d like to propose that when the user edits a document using the wiki
editor then he’s using the Nested Spaces paradigm (and thus uses “WebHome”
to create links to Space homes) and when he edits using the WYSIWYG editor
he uses the Nested Document paradigm (no Space concept, only create WebHome
documents unless he’s an advanced user).
Let's take an example. Say I'm on page .../A/B/C/ (so that's
"A.B.C.WebHome") and I want to create "D". What would happen with
your
proposal is this:
- In WYSIWYG mode, I'll create a link to a new page called "D" and it
will automatically create a link to “A.B.C.D.WebHome" - In Wiki mode, several possibilities:
- I create a link to [[D]] => it becomes a link to [[A.B.C.D]] (new
terminal document)
Almost. I’ll create a page [[D]] in the current space.
- I create a link to [[A.B.C.D]] (new terminal
document)
correct
- I create a link to [[A.B.C.D.WebHome]] (new nested
space)
correct
Is my understanding correct?
yes. Please take into account the fact that there are plenty of macros that accept a
reference as input (include macro, display macro, context macro, etc). When used in
WYSIWYG we would use some special displayer to let the user user a tree to select the
document but in wiki mode, the idea of the proposal is to let the user fill the exact
reference (including WebHome).
Thanks
-Vincent
Thanks,
Guillaume
> The rationale for this is that a lot of macros accept a reference
> parameter and I don’t think we should change them to support hiding
> “WebHome” and do an automatic redirect. That would be too complex. In
> addition, if you use a script macro, then you’ll also see WebHome mentions.
>
> Note that when editing a macro in WYSIWYG editor we’ll need to have a
> macro parameter displayer for Reference-type parameters to display a tree,
> so that the non-technical doesn’t have to enter “WebHome”.
>
> WDYT?
>
> Thanks
> -Vincent
4:38 p.m.
Yep, it goes along the lines of what we are doing with displaying Nested
Documents in the UI (view mode + wysiwyg and maybe inline for edit mode),
but doing Nested Spaces in the platform (java, actions other than view,
wiki syntax edit mode, etc.).
And it also has the added bonus of allowing us to preserve our sanity :)
Thanks,
Eduard
On Thu, Jul 30, 2015 at 5:20 PM, vincent(a)massol.net <vincent(a)massol.net>
wrote:
Hi Guillaume,
On 30 Jul 2015 at 15:57:21, Guillaume Lerouge (guillaume(a)xwiki.com(mailto:
guillaume(a)xwiki.com)) wrote:
correct
Hi,
I'd like to make sure I'm understanding things correctly before
commenting
further. Please see below.
On Wed, Jul 29, 2015 at 5:09 PM, vincent(a)massol.net
wrote:
> Hi devs,
>
> I had created JIRA issue http://jira.xwiki.org/browse/XWIKI-12304
entitled
> "Make wanted wiki links create Nested
Documents” but I’ve brainstormed
with
> Edy and we don’t agree about it anymore :)
>
> We’d like to propose that when the user edits a document using the wiki
> editor then he’s using the Nested Spaces paradigm (and thus uses
“WebHome”
> to create links to Space homes) and when he
edits using the WYSIWYG
editor
> he uses the Nested Document paradigm (no
Space concept, only create
WebHome
documents
unless he’s an advanced user).
Let's take an example. Say I'm on page .../A/B/C/ (so that's
"A.B.C.WebHome") and I want to create "D". What would happen with
your
proposal is this:
- In WYSIWYG mode, I'll create a link to a new page called "D" and it
will automatically create a link to “A.B.C.D.WebHome" - In Wiki mode, several possibilities:
- I create a link to [[D]] => it becomes a link to [[A.B.C.D]] (new
terminal document)
Almost. I’ll create a page [[D]] in the current space.
- I create a link to [[A.B.C.D]] (new terminal
document)
correct
- I create a link to [[A.B.C.D.WebHome]] (new
nested space)
correct
Is my understanding correct?
yes. Please take into account the fact that there are plenty of macros
that accept a reference as input (include macro, display macro, context
macro, etc). When used in WYSIWYG we would use some special displayer to
let the user user a tree to select the document but in wiki mode, the idea
of the proposal is to let the user fill the exact reference (including
WebHome).
Thanks
-Vincent
Thanks,
Guillaume
> The rationale for this is that a lot of macros accept a reference
> parameter and I don’t think we should change them to support hiding
> “WebHome” and do an automatic redirect. That would be too complex. In
> addition, if you use a script macro, then you’ll also see WebHome
mentions.
>
> Note that when editing a macro in WYSIWYG editor we’ll need to have a
> macro parameter displayer for Reference-type parameters to display a
tree,
> so that the non-technical doesn’t have to
enter “WebHome”.
>
> WDYT?
>
> Thanks
> -Vincent
_______________________________________________
devs mailing list
devs(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs
5:56 p.m.
Hi,
see below.
On Thu, Jul 30, 2015 at 4:38 PM, Eduard Moraru <enygma2002(a)gmail.com> wrote:
idea
I understand the rationale and I agree it's probably the best course of
action, though it hurts the "clean & consistent" part of my brain a bit...
But anyway, short of rewriting the model I'm not sure what else we could do.
In other words I'd be +0, were I to have a binding vote (which I did use to
have in the not-so-long-ago past!).
Thanks,
Guillaume
_______________________________________________
devs mailing list
devs(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs
<https://mailtrack.io/trace/link/b6f3c9c8621f0e0805fbfd3ee3112a233db2b112?url=http%3A%2F%2Flists.xwiki.org%2Fmailman%2Flistinfo%2Fdevs&signature=4e2f8e346f2a8c65>
Yep, it goes along the lines of what we are doing with
displaying Nested
Documents in the UI (view mode + wysiwyg and maybe inline for edit mode),
but doing Nested Spaces in the platform (java, actions other than view,
wiki syntax edit mode, etc.).
And it also has the added bonus of allowing us to preserve our sanity :)
Indeed :-)
Thanks,
Eduard
On Thu, Jul 30, 2015 at 5:20 PM, vincent(a)massol.net <vincent(a)massol.net>
wrote:
correct
And [[D]] will be a terminal document in that space (that was my main
question).
Hi Guillaume,
On 30 Jul 2015 at 15:57:21, Guillaume Lerouge (guillaume(a)xwiki.com
(mailto:
guillaume(a)xwiki.com)) wrote:
<https://mailtrack.io/trace/link/c2e95277c8709891c3d945a49529d8627406d6f9?url=http%3A%2F%2Fjira.xwiki.org%2Fbrowse%2FXWIKI-12304&signature=4434606d9f0c3a83>
Hi,
I'd like to make sure I'm understanding things correctly before
commenting
> further. Please see below.
>
> On Wed, Jul 29, 2015 at 5:09 PM, vincent(a)massol.net
> wrote:
>
> > Hi devs,
> >
> > I had created JIRA issue http://jira.xwiki.org/browse/XWIKI-12304 entitled
> > "Make wanted wiki links create Nested Documents” but I’ve
brainstormed
with
> > Edy and we don’t agree about it anymore :)
> >
> > We’d like to propose that when the user edits a document using the
wiki
>
editor then he’s using the Nested Spaces paradigm (and thus uses
“WebHome”
> to create links to Space homes) and when he
edits using the WYSIWYG
editor
> he uses the Nested Document paradigm (no
Space concept, only create
WebHome
documents
unless he’s an advanced user).
Let's take an example. Say I'm on page .../A/B/C/ (so that's
"A.B.C.WebHome") and I want to create "D". What would happen with
your
proposal is this:
- In WYSIWYG mode, I'll create a link to a new page called "D" and it
will automatically create a link to “A.B.C.D.WebHome" - In Wiki mode, several possibilities:
- I create a link to [[D]] => it becomes a link to [[A.B.C.D]] (new
terminal document)
Almost. I’ll create a page [[D]] in the current space. - I create a link to [[A.B.C.D]] (new terminal
document)
correct
- I create a link to [[A.B.C.D.WebHome]] (new
nested space)
correct
Is my understanding correct?
yes. Please take into account the fact that there are plenty of macros
that accept a reference as input (include macro, display macro, context
macro, etc). When used in WYSIWYG we would use some special displayer to
let the user user a tree to select the document but in wiki mode, the of the proposal is to let the user fill the exact
reference (including
WebHome).
Thanks
-Vincent
> Note that when editing a macro in WYSIWYG editor we’ll need to have a
> macro parameter displayer for Reference-type parameters to display a tree,
<https://mailtrack.io/trace/link/b6f3c9c8621f0e0805fbfd3ee3112a233db2b112?url=http%3A%2F%2Flists.xwiki.org%2Fmailman%2Flistinfo%2Fdevs&signature=4e2f8e346f2a8c65>
Thanks,
Guillaume
> The rationale for this is that a lot of macros accept a reference
> parameter and I don’t think we should change them to support hiding
> “WebHome” and do an automatic redirect. That would be too complex. In
> addition, if you use a script macro, then you’ll also see WebHome
mentions.
> so that the non-technical doesn’t have to
enter “WebHome”.
> WDYT?
> Thanks
> -Vincent
_______________________________________________
devs mailing list
devs(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs
24 Aug
24 Aug
4:11 p.m.
Hi guys,
Could I have more opinions on this?
Thanks
-Vincent
On 29 Jul 2015 at 17:09:23, vincent(a)massol.net (vincent(a)massol.net) wrote:
Hi devs,
I had created JIRA issue http://jira.xwiki.org/browse/XWIKI-12304 entitled "Make
wanted wiki links create Nested Documents” but I’ve brainstormed with Edy and we don’t
agree about it anymore :)
We’d like to propose that when the user edits a document using the wiki editor then he’s
using the Nested Spaces paradigm (and thus uses “WebHome” to create links to Space homes)
and when he edits using the WYSIWYG editor he uses the Nested Document paradigm (no Space
concept, only create WebHome documents unless he’s an advanced user).
The rationale for this is that a lot of macros accept a reference parameter and I don’t
think we should change them to support hiding “WebHome” and do an automatic redirect. That
would be too complex. In addition, if you use a script macro, then you’ll also see WebHome
mentions.
Note that when editing a macro in WYSIWYG editor we’ll need to have a macro parameter
displayer for Reference-type parameters to display a tree, so that the non-technical
doesn’t have to enter “WebHome”.
WDYT?
Thanks
-Vincent
2 Sep
2 Sep
1:25 p.m.
+1
Thanks,
Marius
On Mon, Aug 24, 2015 at 5:11 PM, vincent(a)massol.net <vincent(a)massol.net> wrote:
Hi guys,
Could I have more opinions on this?
Thanks
-Vincent
On 29 Jul 2015 at 17:09:23, vincent(a)massol.net (vincent(a)massol.net) wrote:
Hi devs,
I had created JIRA issue http://jira.xwiki.org/browse/XWIKI-12304 entitled "Make
wanted wiki links create Nested Documents” but I’ve brainstormed with Edy and we don’t
agree about it anymore :)
We’d like to propose that when the user edits a document using the wiki editor then he’s
using the Nested Spaces paradigm (and thus uses “WebHome” to create links to Space homes)
and when he edits using the WYSIWYG editor he uses the Nested Document paradigm (no Space
concept, only create WebHome documents unless he’s an advanced user).
The rationale for this is that a lot of macros accept a reference parameter and I don’t
think we should change them to support hiding “WebHome” and do an automatic redirect. That
would be too complex. In addition, if you use a script macro, then you’ll also see WebHome
mentions.
Note that when editing a macro in WYSIWYG editor we’ll need to have a macro parameter
displayer for Reference-type parameters to display a tree, so that the non-technical
doesn’t have to enter “WebHome”.
WDYT?
Thanks
-Vincent
_______________________________________________
devs mailing list
devs(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs
3712
days inactive
3747
days old
6 comments
4 participants
participants (4)
-
Eduard Moraru -
Guillaume Lerouge -
Marius Dumitru Florea -
vincent＠massol.net