Hello, Where is the best space to put macros? I check in some macro from code.xwiki.org, and find that macros are commonly put in XWiki, Macros or Macro space. I've a preference for Macros as it self explanatory and I think XWiki space more dedicated to XE pages. What do you think? Regards, Arnaud. _______________________________________________ users mailing list users(a)xwiki.org http://lists.xwiki.org/mailman/listinfo/users

In your own wiki I think you want to put macros in a space where you will be able to find them easily. The XWiki space is full of important internals and I wouldn't recommend putting any macros in there. "Macros" sounds like a fine choice.

Caleb On 11/02/2010 04:40 AM, Arnaud bourree wrote: _______________________________________________ users mailing list users(a)xwiki.org http://lists.xwiki.org/mailman/listinfo/users

If you're contributing a macro then just log in and fgo to this page. http://code.xwiki.org/xwiki/bin/view/Macros/CreateMacro It will put the macro in the Macros space and automatically add it to the index. Thanks for contributing to code.xwiki.org ;)

Caleb On 11/02/2010 04:57 AM, Arnaud bourree wrote: _______________________________________________ users mailing list users(a)xwiki.org http://lists.xwiki.org/mailman/listinfo/users

On Tue, Nov 2, 2010 at 10:14, Caleb James DeLisle <calebdelisle(a)lavabit.com> wrote: I think Thomas was talking about his how macro space, not where to put contributed macro documentation.

-- Thomas Mortagne _______________________________________________ users mailing list users(a)xwiki.org http://lists.xwiki.org/mailman/listinfo/users

2010/11/2 Thomas Mortagne <thomas.mortagne(a)xwiki.com>om>: Yes, thanks Thomas, I decided to used Macros space. Arnaud. _______________________________________________ users mailing list users(a)xwiki.org http://lists.xwiki.org/mailman/listinfo/users

2010/11/2 Thomas Mortagne <thomas.mortagne(a)xwiki.com>om>: > On Tue, Nov 2, 2010 at 10:14, Caleb James DeLisle > <calebdelisle(a)lavabit.com> wrote: >> If you're contributing a macro then just log in and fgo to this page. >> http://code.xwiki.org/xwiki/bin/view/Macros/CreateMacro >> It will put the macro in the Macros space and automatically add it to

Yes, thanks Thomas, I decided to used Macros space. Arnaud. >> >> Caleb >> >> On 11/02/2010 04:57 AM, Arnaud bourree wrote: >>> 2010/11/2 Caleb James DeLisle <calebdelisle(a)lavabit.com>om>: >>>> In your own wiki I think you want to put macros in a space where you

>>>> easily. The XWiki space is full of important internals and I wouldn't

>>>> in there. >>>> "Macros" sounds like a fine choice. >>> >>> I ask question more for macro we contribute to >>> >>> Arnaud. >>> >>>> >>>> Caleb >>>> >>>> On 11/02/2010 04:40 AM, Arnaud bourree wrote: >>>>> Hello, >>>>> >>>>> Where is the best space to put macros? >>>>> I check in some macro from code.xwiki.org, and find that macros are >>>>> commonly put in XWiki, Macros or Macro space. >>>>> I've a preference for Macros as it self explanatory and I think

_______________________________________________ users mailing list users(a)xwiki.org http://lists.xwiki.org/mailman/listinfo/users

On Tue, Nov 2, 2010 at 3:05 PM, Jerome Velociter <jerome(a)xwiki.com> wrote: This polishing would empower a standard user to use this XWiki advanced feature.

Here is my +1. > > Jerome > > On Tue, Nov 2, 2010 at 2:03 PM, Arnaud bourree <arnaud.bourree(a)gmail.com> > wrote: >> 2010/11/2 Thomas Mortagne <thomas.mortagne(a)xwiki.com>om>: >>> On Tue, Nov 2, 2010 at 10:14, Caleb James DeLisle >>> <calebdelisle(a)lavabit.com> wrote: >>>> If you're contributing a macro then just log in and fgo to this page. >>>> http://code.xwiki.org/xwiki/bin/view/Macros/CreateMacro >>>> It will put the macro in the Macros space and automatically add it to > the index. >>>> Thanks for contributing to code.xwiki.org ;) >>> >>> I think Thomas was talking about his how macro space, not where to put >>> contributed macro documentation. >>> >> >> Yes, thanks Thomas, >> I decided to used Macros space. >> >> Arnaud. >> >>>> >>>> Caleb >>>> >>>> On 11/02/2010 04:57 AM, Arnaud bourree wrote: >>>>> 2010/11/2 Caleb James DeLisle <calebdelisle(a)lavabit.com>om>: >>>>>> In your own wiki I think you want to put macros in a space where you > will be able to find them >>>>>> easily. The XWiki space is full of important internals and I wouldn't > recommend putting any macros >>>>>> in there. >>>>>> "Macros" sounds like a fine choice. >>>>> >>>>> I ask question more for macro we contribute to >>>>> >>>>> Arnaud. >>>>> >>>>>> >>>>>> Caleb >>>>>> >>>>>> On 11/02/2010 04:40 AM, Arnaud bourree wrote: >>>>>>> Hello, >>>>>>> >>>>>>> Where is the best space to put macros? >>>>>>> I check in some macro from code.xwiki.org, and find that macros are >>>>>>> commonly put in XWiki, Macros or Macro space. >>>>>>> I've a preference for Macros as it self explanatory and I think > XWiki >>>>>>> space more dedicated to XE pages. >>>>>>> >>>>>>> What do you think? >>>>>>> >>>>>>> Regards, >>>>>>> >>>>>>> Arnaud.

Hi Vincent, all, See below On Tue, Nov 2, 2010 at 10:46 PM, Vincent Massol <vincent(a)massol.net> wrote: Then we should probably hide them from the WYSIWYG tooIbar too, I guess ;) Seriously, the space could be blacklisted, but it should be discussed, I'm not sure we want to have only admins seing it (personally I see that space as being "documentation on macros existing in the wiki" before being "a place to create new macros" - so not so technical in the end).

Maybe in some distant future we should have an intermediary level between "Normal users" and "Admins". BTW do users that chose to be "Advanced Users" in their profile see the blacklisted spaces ?

Maybe the intermediary level could be this one.

Well it's not a proposal yet, rather an idea. If you ask me some should be moved already (like {{spaces}} and {{tags}}), since they are located in documents that already have another purpose, and thus can not benefit from a potential WikiMacroClassSheet (that for example could display the usage of the macro and its parameters ; thus becoming a sort of self-contained documentation for the held macro)

Yes they should. Right now we don't even have a rule for where to put applications documents (in their own space ? with a Code suffix ? in the XWiki space ? somewhere else ?)

I think the (not existing) UI at Macros.WebHome should retrieve and list documents from the entire wiki, not just the Macros space.

Same as the scheduler (I changed that behavior just recently by the way - I wanted my application scheduler jobs in my application space, not in the Scheduler space - see http://jira.xwiki.org/jira/browse/XASCH-56)

There is already one : the "wikibridge" I think, with just one document now (the name is not correct though, I agree)

I'm quite sure you will not agree, but I would say generic (i.e. not tied to a particular application) wiki macros could go there. For example {{spaces /}} or even {{activity /}} which goes beyond just the dashboard app.

Yes they should. Maybe not under the exact same form, but they definitely should be listed and documented here Cool. I'm +1 too and +1 to have the possibility for apps to bring their own macros.

Jerome. > Thanks > -Vincent > > PS: I didn't even know about http://localhost:8080/xwiki/bin/view/XWiki/WikiMacros ;) I wonder why it's not already using a livetable.... > > >> Here is my +1. >> >> >> >>> Jerome >>> >>> On Tue, Nov 2, 2010 at 2:03 PM, Arnaud bourree <arnaud.bourree(a)gmail.com> >>> wrote: >>> >>>> 2010/11/2 Thomas Mortagne <thomas.mortagne(a)xwiki.com>om>: >>>> >>>>> On Tue, Nov 2, 2010 at 10:14, Caleb James DeLisle >>>>> <calebdelisle(a)lavabit.com> wrote: >>>>> >>>>>> If you're contributing a macro then just log in and fgo to this page. >>>>>> http://code.xwiki.org/xwiki/bin/view/Macros/CreateMacro >>>>>> It will put the macro in the Macros space and automatically add it to >>>>>> >>> the index. >>> >>>>>> Thanks for contributing to code.xwiki.org ;) >>>>>> >>>>> I think Thomas was talking about his how macro space, not where to put >>>>> contributed macro documentation. >>>>> >>>>> >>>> Yes, thanks Thomas, >>>> I decided to used Macros space. >>>> >>>> Arnaud. >>>> >>>> >>>>>> Caleb >>>>>> >>>>>> On 11/02/2010 04:57 AM, Arnaud bourree wrote: >>>>>> >>>>>>> 2010/11/2 Caleb James DeLisle <calebdelisle(a)lavabit.com>om>: >>>>>>> >>>>>>>> In your own wiki I think you want to put macros in a space where you >>>>>>>> >>> will be able to find them >>> >>>>>>>> easily. The XWiki space is full of important internals and I wouldn't >>>>>>>> >>> recommend putting any macros >>> >>>>>>>> in there. >>>>>>>> "Macros" sounds like a fine choice. >>>>>>>> >>>>>>> I ask question more for macro we contribute to >>>>>>> >>>>>>> Arnaud. >>>>>>> >>>>>>> >>>>>>>> Caleb >>>>>>>> >>>>>>>> On 11/02/2010 04:40 AM, Arnaud bourree wrote: >>>>>>>> >>>>>>>>> Hello, >>>>>>>>> >>>>>>>>> Where is the best space to put macros? >>>>>>>>> I check in some macro from code.xwiki.org, and find that macros are >>>>>>>>> commonly put in XWiki, Macros or Macro space. >>>>>>>>> I've a preference for Macros as it self explanatory and I think >>>>>>>>> >>> XWiki >>> >>>>>>>>> space more dedicated to XE pages. >>>>>>>>> >>>>>>>>> What do you think? >>>>>>>>> >>>>>>>>> Regards, >>>>>>>>> >>>>>>>>> Arnaud. >>>>>>>>>

Hi Vincent, all, See below On Tue, Nov 2, 2010 at 10:46 PM, Vincent Massol <vincent(a)massol.net>

> > On Nov 2, 2010, at 7:47 PM, Thibaut Camberlin wrote: > >> On Tue, Nov 2, 2010 at 3:05 PM, Jerome Velociter <jerome(a)xwiki.com>

>> >>> Actually I've been thinking maybe we could provide a Macros/ space >>> with XE. The home page would be a improved version of the current >>> XWiki.WikiMacros page (adding for example a ClassSheet for macros, a >>> form to create a new macro, some documentation, etc.) >>> >>> WDYT? >>> >> >> This polishing would empower a standard user to use this XWiki advanced >> feature. > > I don't quite agree. Standard users shouldn't see this space. it's

Then we should probably hide them from the WYSIWYG tooIbar too, I guess

Seriously, the space could be blacklisted, but it should be discussed, I'm not sure we want to have only admins seing it (personally I see that space as being "documentation on macros existing in the wiki" before being "a place to create new macros" - so not so technical in the end).

Maybe in some distant future we should have an intermediary level between "Normal users" and "Admins". BTW do users that chose to be "Advanced Users" in their profile see the blacklisted spaces ?

Maybe the intermediary level could be this one.

Well it's not a proposal yet, rather an idea. > Some open questions: Would the macros stay where they are currently

If you ask me some should be moved already (like {{spaces}} and {{tags}}), since they are located in documents that already have another purpose, and thus can not benefit from a potential WikiMacroClassSheet (that for example could display the usage of the macro and its parameters ; thus becoming a sort of self-contained documentation for the held macro)

Yes they should. Right now we don't even have a rule for where to put applications documents (in their own space ? with a Code suffix ? in the XWiki space ? somewhere else ?)

I think the (not existing) UI at Macros.WebHome should retrieve and list documents from the entire wiki, not just the Macros space.

Same as the scheduler (I changed that behavior just recently by the way - I wanted my application scheduler jobs in my application space, not in the Scheduler space - see http://jira.xwiki.org/jira/browse/XASCH-56)

There is already one : the "wikibridge" I think, with just one document now (the name is not correct though, I agree)

> What macros go there? When do we use wiki macros vs java macros (we

I'm quite sure you will not agree, but I would say generic (i.e. not tied to a particular application) wiki macros could go there. For example {{spaces /}} or even {{activity /}} which goes beyond just the dashboard app.

Yes they should. Maybe not under the exact same form, but they definitely should be listed and documented here > > Generally speaking I'm rather +1 (I'd like macros to stay in their apps

Cool. I'm +1 too and +1 to have the possibility for apps to bring their own macros.

Jerome. > > Thanks > -Vincent > > PS: I didn't even know about

> >> Here is my +1. >> >> >>> >>> Jerome >>> >>> On Tue, Nov 2, 2010 at 2:03 PM, Arnaud bourree <

>>> wrote: >>>> 2010/11/2 Thomas Mortagne &lt;thomas.mortagne(a)xwiki.com&gt;om>: >>>>> On Tue, Nov 2, 2010 at 10:14, Caleb James DeLisle >>>>> &lt;calebdelisle(a)lavabit.com&gt; wrote: >>>>>> If you're contributing a macro then just log in and fgo to this

>>>>>> http://code.xwiki.org/xwiki/bin/view/Macros/CreateMacro >>>>>> It will put the macro in the Macros space and automatically add it

>>> the index. >>>>>> Thanks for contributing to code.xwiki.org ;) >>>>> >>>>> I think Thomas was talking about his how macro space, not where to

>>>>> contributed macro documentation. >>>>> >>>> >>>> Yes, thanks Thomas, >>>> I decided to used Macros space. >>>> >>>> Arnaud. >>>> >>>>>> >>>>>> Caleb >>>>>> >>>>>> On 11/02/2010 04:57 AM, Arnaud bourree wrote: >>>>>>> 2010/11/2 Caleb James DeLisle &lt;calebdelisle(a)lavabit.com&gt;om>: >>>>>>>> In your own wiki I think you want to put macros in a space where

>>> will be able to find them >>>>>>>> easily. The XWiki space is full of important internals and I

>>> recommend putting any macros >>>>>>>> in there. >>>>>>>> "Macros" sounds like a fine choice. >>>>>>> >>>>>>> I ask question more for macro we contribute to >>>>>>> >>>>>>> Arnaud. >>>>>>> >>>>>>>> >>>>>>>> Caleb >>>>>>>> >>>>>>>> On 11/02/2010 04:40 AM, Arnaud bourree wrote: >>>>>>>>> Hello, >>>>>>>>> >>>>>>>>> Where is the best space to put macros? >>>>>>>>> I check in some macro from code.xwiki.org, and find that macros

>>>>>>>>> commonly put in XWiki, Macros or Macro space. >>>>>>>>> I've a preference for Macros as it self explanatory and I think >>> XWiki >>>>>>>>> space more dedicated to XE pages. >>>>>>>>> >>>>>>>>> What do you think? >>>>>>>>> >>>>>>>>> Regards, >>>>>>>>> >>>>>>>>> Arnaud.

Hi, On Wed, Nov 3, 2010 at 09:10, [Ricardo Rodriguez] eBioTIC. < ricardo.rodriguez(a)ebiotic.net&gt; wrote: +1 for a better separation as well. I regularly give demos of XWiki and landing on a first page with all the technical spaces is indeed confusing for users.

Guillaume _______________________________________________ users mailing list users(a)xwiki.org http://lists.xwiki.org/mailman/listinfo/users

On Wed, Nov 3, 2010 at 10:47 AM, Guillaume Lerouge &lt;guillaume(a)xwiki.com&gt; wrote: > > +1 for a better separation as well. I regularly give demos of XWiki and > landing on a first page with all the technical spaces is indeed confusing > for users.

I agree. Maybe it's time we thing about typed spaces. It could start with something light such as a XWiki.SpaceClass with only a "pretty name" (quite needed too if you ask me) and a "category" list

For any of you who used downloaded macros for xwiki. What do I need to do after downloading and importing a macro. I have downloaded/imported a couple of macros, and non of them are displayed in the Macro WYSIWYG editor. Please advise. -Alina.