[Proposal] XWiki "2.0" Syntax

[vmassol]

Hi,

Since I'm rewriting the new Rendering component
(see http://dev.xwiki.org/xwiki/bin/view/Design/NewRenderingArchitecture)
, we need to finalize the new syntax we want to have.

Right now I'v planned to use the same wiki syntax as now
(http://platform.xwiki.org/xwiki/bin/view/Main/ 
XWikiSyntax#HTextStyles) with only one change: all macros now need to  
be closed.
For example: {macro}...{/macro} and {macro:text|param=value|.../}

Is that ok with everyone or do we want to make changes?

Thanks
-Vincent

_______________________________________________
devs mailing list
[hidden email]
http://lists.xwiki.org/mailman/listinfo/devs

[Ludovic Dubost-2]

There might be a few changes interesting.

Deprecate {link} and make sure we can use [] for outside links
Deprecate # which is one of the ways to do numbered links but is a pb
with velocity

+1 for closing the macros.

If we make more changes we should look into getting closer with WikiCreole

Ludovic

Vincent Massol wrote:

> Hi,
>
> Since I'm rewriting the new Rendering component
> (see http://dev.xwiki.org/xwiki/bin/view/Design/NewRenderingArchitecture)
> , we need to finalize the new syntax we want to have.
>
> Right now I'v planned to use the same wiki syntax as now
> (http://platform.xwiki.org/xwiki/bin/view/Main/ 
> XWikiSyntax#HTextStyles) with only one change: all macros now need to  
> be closed.
> For example: {macro}...{/macro} and {macro:text|param=value|.../}
>
> Is that ok with everyone or do we want to make changes?
>
> Thanks
> -Vincent
>
> _______________________________________________
> devs mailing list
> [hidden email]
> http://lists.xwiki.org/mailman/listinfo/devs
>
>  

--
Ludovic Dubost
Blog: http://blog.ludovic.org/
XWiki: http://www.xwiki.com
Skype: ldubost GTalk: ldubost

_______________________________________________
devs mailing list
[hidden email]
http://lists.xwiki.org/mailman/listinfo/devs

[vmassol]

On Mar 20, 2008, at 10:48 AM, Ludovic Dubost wrote:

>
> There might be a few changes interesting.
>
> Deprecate {link} and make sure we can use [] for outside links

For link that's a macro so we just need not to add it.
For [], that's already supported in the current syntax AFAIK.

>
> Deprecate # which is one of the ways to do numbered links but is a pb
> with velocity

I agree.

> +1 for closing the macros.
>
> If we make more changes we should look into getting closer with  
> WikiCreole

The idea is to keep the xwiki syntax here. Other syntaxes support are  
done by other Parsers.

Thanks
-Vincent

> Vincent Massol wrote:
>> Hi,
>>
>> Since I'm rewriting the new Rendering component
>> (see http://dev.xwiki.org/xwiki/bin/view/Design/NewRenderingArchitecture)
>> , we need to finalize the new syntax we want to have.
>>
>> Right now I'v planned to use the same wiki syntax as now
>> (http://platform.xwiki.org/xwiki/bin/view/Main/
>> XWikiSyntax#HTextStyles) with only one change: all macros now need to
>> be closed.
>> For example: {macro}...{/macro} and {macro:text|param=value|.../}
>>
>> Is that ok with everyone or do we want to make changes?
>>
>> Thanks
>> -Vincent
>>
>> _______________________________________________
>> devs mailing list
>> [hidden email]
>> http://lists.xwiki.org/mailman/listinfo/devs
>>
>>
>
>
> --
> Ludovic Dubost
> Blog: http://blog.ludovic.org/
> XWiki: http://www.xwiki.com
> Skype: ldubost GTalk: ldubost
>
> _______________________________________________
> devs mailing list
> [hidden email]
> http://lists.xwiki.org/mailman/listinfo/devs

_______________________________________________
devs mailing list
[hidden email]
http://lists.xwiki.org/mailman/listinfo/devs

[Sergiu Dumitriu-2]

Vincent Massol wrote:

> Hi,
>
> Since I'm rewriting the new Rendering component
> (see http://dev.xwiki.org/xwiki/bin/view/Design/NewRenderingArchitecture)
> , we need to finalize the new syntax we want to have.
>
> Right now I'v planned to use the same wiki syntax as now
> (http://platform.xwiki.org/xwiki/bin/view/Main/ 
> XWikiSyntax#HTextStyles) with only one change: all macros now need to  
> be closed.
> For example: {macro}...{/macro} and {macro:text|param=value|.../}
>
> Is that ok with everyone or do we want to make changes?

OK for me.

Do we want to be more XML-like and suggest the following syntax?

{macro:table firstRowAsHeader="true" oddEvenRows="false"}
...
{/macro:table}

- use spaces as separators
- use macro: as a kind of namespace (or wiki: ?)
- require "" around attribute values
- require named parameters, as right now there is an implicit order, so
if the first parameter does not have a name, it is considered to be the
value for "that" parameter.

But with fallbacks:
- also allow | as separators
- if the macro name does not start with macro:, and does not match
another kind of block element (like groovy or html), then consider it a
wiki macro
- also works without "" around values
- Print a warning in the log when a deprecated syntax is used

WDYT?

--
Sergiu Dumitriu
http://purl.org/net/sergiu/
_______________________________________________
devs mailing list
[hidden email]
http://lists.xwiki.org/mailman/listinfo/devs

[Mikhail Kotelnikov]

On Thu, Mar 20, 2008 at 1:09 PM, Sergiu Dumitriu <[hidden email]> wrote:

> Vincent Massol wrote:
> > Hi,
> >
> > Since I'm rewriting the new Rendering component
> > (see http://dev.xwiki.org/xwiki/bin/view/Design/NewRenderingArchitecture
> )
> > , we need to finalize the new syntax we want to have.
> >
> > Right now I'v planned to use the same wiki syntax as now
> > (http://platform.xwiki.org/xwiki/bin/view/Main/
> > XWikiSyntax#HTextStyles) with only one change: all macros now need to
> > be closed.
> > For example: {macro}...{/macro} and {macro:text|param=value|.../}
> >
> > Is that ok with everyone or do we want to make changes?
>
> OK for me.
>
> Do we want to be more XML-like and suggest the following syntax?
>
> {macro:table firstRowAsHeader="true" oddEvenRows="false"}
> ...
> {/macro:table}
>
> - use spaces as separators
> - use macro: as a kind of namespace (or wiki: ?)
> - require "" around attribute values
> - require named parameters, as right now there is an implicit order, so
> if the first parameter does not have a name, it is considered to be the
> value for "that" parameter.
>
> But with fallbacks:
> - also allow | as separators
> - if the macro name does not start with macro:, and does not match
> another kind of block element (like groovy or html), then consider it a
> wiki macro
> - also works without "" around values
> - Print a warning in the log when a deprecated syntax is used
>
> WDYT?
>
> --
> Sergiu Dumitriu
> http://purl.org/net/sergiu/
> _______________________________________________
> devs mailing list
> [hidden email]
> http://lists.xwiki.org/mailman/listinfo/devs
>

_______________________________________________
devs mailing list
[hidden email]
http://lists.xwiki.org/mailman/listinfo/devs