[xwiki-devs] [Rendering] Final syntax decisions and remaining issues
Hi, I've updated this page http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20 which describes both XWiki syntax 1.0 and XWiki Syntax 2.0. I want to make sure we agree with the following syntax decisions and especially with regards to Creole since we want to be close to it. One disclaimer though: the creole specification is badly done and is not strict enough. There are lots of ambiguities in their descriptions of the syntax elements so it's almost impossible to ensure to be fully compatible with some element syntaxes. 1) New lines Right now we honor new lines (we've all already voted to have this). I just wanted to point out that this is different from Creole. 2) Horizontal lines We accept 4 or more dashes. Creole says it's 4 dashes only. However if you try it on their test page at http://www.wikicreole.org/EditX.jsp?page=JSPWikiTestCases if works fine with more than 4 dashes too. 3) Special numbered lists Is it ok to have this syntax: (% class="roman" %) 1. item1 1. item2 Or do we introduce new syntax elements as it's done in XWiki Syntax 1.0: i. item1 i. item2 See http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20#HLists for more examples. I have the feeling it would be better to use our 1.0 syntax for this (note that this requires some heavy changes to wikimodel - Will need to discuss it with Mikhail). 4) Images There's currently no special support for images in wikimodel. The solution wikimodel proposes is to implement its support through linline links. For example: This is an image:my.png image. As you can see the image is specified as a URI. Ok with everyone? Thanks -Vincent
I forgot to mention: Please all review http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20 and raise any issue you may have. Thanks -Vincent On Sep 17, 2008, at 10:30 AM, Vincent Massol wrote:
Hi,
I've updated this page http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20 which describes both XWiki syntax 1.0 and XWiki Syntax 2.0.
I want to make sure we agree with the following syntax decisions and especially with regards to Creole since we want to be close to it.
One disclaimer though: the creole specification is badly done and is not strict enough. There are lots of ambiguities in their descriptions of the syntax elements so it's almost impossible to ensure to be fully compatible with some element syntaxes.
1) New lines
Right now we honor new lines (we've all already voted to have this). I just wanted to point out that this is different from Creole.
2) Horizontal lines
We accept 4 or more dashes. Creole says it's 4 dashes only. However if you try it on their test page at http://www.wikicreole.org/EditX.jsp?page=JSPWikiTestCases if works fine with more than 4 dashes too.
3) Special numbered lists
Is it ok to have this syntax:
(% class="roman" %) 1. item1 1. item2
Or do we introduce new syntax elements as it's done in XWiki Syntax 1.0:
i. item1 i. item2
See http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20#HLists for more examples.
I have the feeling it would be better to use our 1.0 syntax for this (note that this requires some heavy changes to wikimodel - Will need to discuss it with Mikhail).
4) Images
There's currently no special support for images in wikimodel. The solution wikimodel proposes is to implement its support through linline links. For example:
This is an image:my.png image.
As you can see the image is specified as a URI.
Ok with everyone?
Thanks -Vincent
On Wed, Sep 17, 2008 at 10:30 AM, Vincent Massol <[email protected]> wrote:
Hi,
I've updated this page http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20 which describes both XWiki syntax 1.0 and XWiki Syntax 2.0.
I want to make sure we agree with the following syntax decisions and especially with regards to Creole since we want to be close to it.
One disclaimer though: the creole specification is badly done and is not strict enough. There are lots of ambiguities in their descriptions of the syntax elements so it's almost impossible to ensure to be fully compatible with some element syntaxes.
1) New lines
Right now we honor new lines (we've all already voted to have this). I just wanted to point out that this is different from Creole.
2) Horizontal lines
We accept 4 or more dashes. Creole says it's 4 dashes only. However if you try it on their test page at http://www.wikicreole.org/EditX.jsp?page=JSPWikiTestCases if works fine with more than 4 dashes too.
3) Special numbered lists
Is it ok to have this syntax:
(% class="roman" %) 1. item1 1. item2
I prefer this one but...
Or do we introduce new syntax elements as it's done in XWiki Syntax 1.0:
i. item1 i. item2
I think this is the best for user.
See http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20#HLists for more examples.
I have the feeling it would be better to use our 1.0 syntax for this (note that this requires some heavy changes to wikimodel - Will need to discuss it with Mikhail).
What about support both ? Given the fact that support the version with parameter is not a lot of work anyway if we decide to support the second.
4) Images
There's currently no special support for images in wikimodel. The solution wikimodel proposes is to implement its support through linline links. For example:
This is an image:my.png image.
As you can see the image is specified as a URI.
Ok with everyone?
Thanks -Vincent
_______________________________________________ devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
-- Thomas Mortagne
Hi, [snip]
3) Special numbered lists
Is it ok to have this syntax:
(% class="roman" %) 1. item1 1. item2
I prefer this one but...
If we use this syntax no user will ever use a roman list.
Or do we introduce new syntax elements as it's done in XWiki Syntax 1.0:
i. item1 i. item2
I think this is the best for user.
+1 if we want users to actually use this feature.
See http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20#HLists for more examples.
I have the feeling it would be better to use our 1.0 syntax for this (note that this requires some heavy changes to wikimodel - Will need to discuss it with Mikhail).
What about support both ? Given the fact that support the version with parameter is not a lot of work anyway if we decide to support the second.
+1 if it's easy to do
4) Images
There's currently no special support for images in wikimodel. The solution wikimodel proposes is to implement its support through linline links. For example:
This is an image:my.png image.
As you can see the image is specified as a URI.
Ok with everyone?
The current macro image gets people confused (among "people" I count myself -> I hardly ever used the parameters available in the macro image). Here again, if we use the "% %" model we need to be aware that most users won't ever input parameters to their images, unless they use the WYSIWYG editor. Since we expect it to work great, that's fine with me, but I simply want us to be aware that doing this we make the XWiki syntax at least as complex as HTML, which basically removes its interest as a simplified markup.
[snip]
Guillaume -- Guillaume Lerouge Product Manager - XWiki Skype ID : wikibc http://blog.xwiki.com/
On Sep 19, 2008, at 5:40 PM, Guillaume Lerouge wrote:
Hi,
[snip]
3) Special numbered lists
Is it ok to have this syntax:
(% class="roman" %) 1. item1 1. item2
I prefer this one but...
If we use this syntax no user will ever use a roman list.
Or do we introduce new syntax elements as it's done in XWiki Syntax 1.0:
i. item1 i. item2
I think this is the best for user.
+1 if we want users to actually use this feature.
See http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20#HLists for more examples.
I have the feeling it would be better to use our 1.0 syntax for this (note that this requires some heavy changes to wikimodel - Will need to discuss it with Mikhail).
What about support both ? Given the fact that support the version with parameter is not a lot of work anyway if we decide to support the second.
+1 if it's easy to do
4) Images
There's currently no special support for images in wikimodel. The solution wikimodel proposes is to implement its support through linline links. For example:
This is an image:my.png image.
As you can see the image is specified as a URI.
Ok with everyone?
The current macro image gets people confused (among "people" I count myself -> I hardly ever used the parameters available in the macro image). Here again, if we use the "% %" model we need to be aware that most users won't ever input parameters to their images, unless they use the WYSIWYG editor. Since we expect it to work great, that's fine with me, but I simply want us to be aware that doing this we make the XWiki syntax at least as complex as HTML, which basically removes its interest as a simplified markup.
And this is good! Wiki markup should focus on simple things. If it were easy people would put colors and styles everywhere which is bad. It's good that's it's not easy. It's just an extension since we MUST have it for the wysiwyg to work and be able to style documents without incurring the penalty of using the {{html}} macro which would provide visual garbage in wiki edition mode. Thanks -Vincent
Vincent Massol wrote:
On Sep 19, 2008, at 5:40 PM, Guillaume Lerouge wrote:
The current macro image gets people confused (among "people" I count myself -> I hardly ever used the parameters available in the macro image). Here again, if we use the "% %" model we need to be aware that most users won't ever input parameters to their images, unless they use the WYSIWYG editor. Since we expect it to work great, that's fine with me, but I simply want us to be aware that doing this we make the XWiki syntax at least as complex as HTML, which basically removes its interest as a simplified markup.
And this is good! Wiki markup should focus on simple things. If it were easy people would put colors and styles everywhere which is bad. It's good that's it's not easy.
It's just an extension since we MUST have it for the wysiwyg to work and be able to style documents without incurring the penalty of using the {{html}} macro which would provide visual garbage in wiki edition mode.
+1, people should learn that "the content is king", providing good content is much more important than coloring it nicely. If it is not simple to do, then don't do it, unless you really have to. -- Sergiu Dumitriu http://purl.org/net/sergiu/
On Fri, Sep 19, 2008 at 6:08 PM, Sergiu Dumitriu <[email protected]> wrote:
Vincent Massol wrote:
On Sep 19, 2008, at 5:40 PM, Guillaume Lerouge wrote:
The current macro image gets people confused (among "people" I count myself -> I hardly ever used the parameters available in the macro image). Here again, if we use the "% %" model we need to be aware that most users won't ever input parameters to their images, unless they use the WYSIWYG editor. Since we expect it to work great, that's fine with me, but I simply want us to be aware that doing this we make the XWiki syntax at least as complex as HTML, which basically removes its interest as a simplified markup.
And this is good! Wiki markup should focus on simple things. If it were easy people would put colors and styles everywhere which is bad. It's good that's it's not easy.
It's just an extension since we MUST have it for the wysiwyg to work and be able to style documents without incurring the penalty of using the {{html}} macro which would provide visual garbage in wiki edition mode.
+1, people should learn that "the content is king", providing good content is much more important than coloring it nicely. If it is not simple to do, then don't do it, unless you really have to.
-1, we shouldn't decide what users want to do instead of them :-) What if I came and told you that you're using your IDE the wrong way and that from now on it's gonna be hard to do "Find & Replace" because people *should* name their variables correctly in the first place ? Guillaume
-- Sergiu Dumitriu http://purl.org/net/sergiu/ _______________________________________________ devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
-- Guillaume Lerouge Product Manager - XWiki Skype ID : wikibc http://blog.xwiki.com/
On Sep 19, 2008, at 6:24 PM, Guillaume Lerouge wrote:
On Fri, Sep 19, 2008 at 6:08 PM, Sergiu Dumitriu <[email protected]> wrote:
Vincent Massol wrote:
On Sep 19, 2008, at 5:40 PM, Guillaume Lerouge wrote:
The current macro image gets people confused (among "people" I count myself -> I hardly ever used the parameters available in the macro image). Here again, if we use the "% %" model we need to be aware that most users won't ever input parameters to their images, unless they use the WYSIWYG editor. Since we expect it to work great, that's fine with me, but I simply want us to be aware that doing this we make the XWiki syntax at least as complex as HTML, which basically removes its interest as a simplified markup.
And this is good! Wiki markup should focus on simple things. If it were easy people would put colors and styles everywhere which is bad. It's good that's it's not easy.
It's just an extension since we MUST have it for the wysiwyg to work and be able to style documents without incurring the penalty of using the {{html}} macro which would provide visual garbage in wiki edition mode.
+1, people should learn that "the content is king", providing good content is much more important than coloring it nicely. If it is not simple to do, then don't do it, unless you really have to.
-1, we shouldn't decide what users want to do instead of them :-)
ok let's take the problem differently then... What do you suggest? Thanks -Vincent
What if I came and told you that you're using your IDE the wrong way and that from now on it's gonna be hard to do "Find & Replace" because people *should* name their variables correctly in the first place ?
Guillaume
Guillaume Lerouge wrote:
On Fri, Sep 19, 2008 at 6:08 PM, Sergiu Dumitriu <[email protected]> wrote:
Vincent Massol wrote:
On Sep 19, 2008, at 5:40 PM, Guillaume Lerouge wrote:
The current macro image gets people confused (among "people" I count myself -> I hardly ever used the parameters available in the macro image). Here again, if we use the "% %" model we need to be aware that most users won't ever input parameters to their images, unless they use the WYSIWYG editor. Since we expect it to work great, that's fine with me, but I simply want us to be aware that doing this we make the XWiki syntax at least as complex as HTML, which basically removes its interest as a simplified markup. And this is good! Wiki markup should focus on simple things. If it were easy people would put colors and styles everywhere which is bad. It's good that's it's not easy.
It's just an extension since we MUST have it for the wysiwyg to work and be able to style documents without incurring the penalty of using the {{html}} macro which would provide visual garbage in wiki edition mode.
+1, people should learn that "the content is king", providing good content is much more important than coloring it nicely. If it is not simple to do, then don't do it, unless you really have to.
-1, we shouldn't decide what users want to do instead of them :-)
What if I came and told you that you're using your IDE the wrong way and that from now on it's gonna be hard to do "Find & Replace" because people *should* name their variables correctly in the first place ?
In that case, Guillaume, there wouldn't actually be a problem, as for renaming variables most of us use a refactoring feature... You really *shouldn't* use find & replace for that... Anyway, I don't like the analogy, as we're not telling users not to do something, we're encouraging them to do it the right way. Just like maven does. -- Sergiu Dumitriu http://purl.org/net/sergiu/
Guillaume Lerouge wrote:
Hi,
[snip]
3) Special numbered lists
Is it ok to have this syntax:
(% class="roman" %) 1. item1 1. item2 I prefer this one but...
If we use this syntax no user will ever use a roman list.
Or do we introduce new syntax elements as it's done in XWiki Syntax 1.0:
i. item1 i. item2 I think this is the best for user.
+1 if we want users to actually use this feature.
But users should not do this manually. It will be generated by the wysiwyg, so I don't see a severe problem. -- Sergiu Dumitriu http://purl.org/net/sergiu/
On Fri, Sep 19, 2008 at 5:49 PM, Sergiu Dumitriu <[email protected]> wrote:
Guillaume Lerouge wrote:
Hi,
[snip]
3) Special numbered lists
Is it ok to have this syntax:
(% class="roman" %) 1. item1 1. item2 I prefer this one but...
If we use this syntax no user will ever use a roman list.
Or do we introduce new syntax elements as it's done in XWiki Syntax 1.0:
i. item1 i. item2 I think this is the best for user.
+1 if we want users to actually use this feature.
But users should not do this manually. It will be generated by the wysiwyg, so I don't see a severe problem.
Well, what's the point of having a wiki syntax that is different from HTML if we do not expect users to use it ? Guillaume
-- Sergiu Dumitriu http://purl.org/net/sergiu/ _______________________________________________ devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
-- Guillaume Lerouge Product Manager - XWiki Skype ID : wikibc http://blog.xwiki.com/
On Wed, Sep 17, 2008 at 10:30 AM, Vincent Massol <[email protected]> wrote:
Hi,
I've updated this page http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20 which describes both XWiki syntax 1.0 and XWiki Syntax 2.0.
I want to make sure we agree with the following syntax decisions and especially with regards to Creole since we want to be close to it.
One disclaimer though: the creole specification is badly done and is not strict enough. There are lots of ambiguities in their descriptions of the syntax elements so it's almost impossible to ensure to be fully compatible with some element syntaxes.
1) New lines
Right now we honor new lines (we've all already voted to have this). I just wanted to point out that this is different from Creole.
2) Horizontal lines
We accept 4 or more dashes. Creole says it's 4 dashes only. However if you try it on their test page at http://www.wikicreole.org/EditX.jsp?page=JSPWikiTestCases if works fine with more than 4 dashes too.
3) Special numbered lists
Is it ok to have this syntax:
(% class="roman" %) 1. item1 1. item2
Or do we introduce new syntax elements as it's done in XWiki Syntax 1.0:
i. item1 i. item2
See http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20#HLists for more examples.
I have the feeling it would be better to use our 1.0 syntax for this (note that this requires some heavy changes to wikimodel - Will need to discuss it with Mikhail).
4) Images
There's currently no special support for images in wikimodel. The solution wikimodel proposes is to implement its support through linline links. For example:
This is an image:my.png image.
Seems too basic... What about defining width, height, etc. ?
As you can see the image is specified as a URI.
Ok with everyone?
Thanks -Vincent
_______________________________________________ devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
-- Thomas Mortagne
On Sep 17, 2008, at 1:00 PM, Thomas Mortagne wrote:
On Wed, Sep 17, 2008 at 10:30 AM, Vincent Massol <[email protected]> wrote:
Hi,
I've updated this page http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20 which describes both XWiki syntax 1.0 and XWiki Syntax 2.0.
I want to make sure we agree with the following syntax decisions and especially with regards to Creole since we want to be close to it.
One disclaimer though: the creole specification is badly done and is not strict enough. There are lots of ambiguities in their descriptions of the syntax elements so it's almost impossible to ensure to be fully compatible with some element syntaxes.
1) New lines
Right now we honor new lines (we've all already voted to have this). I just wanted to point out that this is different from Creole.
2) Horizontal lines
We accept 4 or more dashes. Creole says it's 4 dashes only. However if you try it on their test page at http://www.wikicreole.org/EditX.jsp?page=JSPWikiTestCases if works fine with more than 4 dashes too.
3) Special numbered lists
Is it ok to have this syntax:
(% class="roman" %) 1. item1 1. item2
Or do we introduce new syntax elements as it's done in XWiki Syntax 1.0:
i. item1 i. item2
See http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20#HLists for more examples.
I have the feeling it would be better to use our 1.0 syntax for this (note that this requires some heavy changes to wikimodel - Will need to discuss it with Mikhail).
4) Images
There's currently no special support for images in wikimodel. The solution wikimodel proposes is to implement its support through linline links. For example:
This is an image:my.png image.
Seems too basic... What about defining width, height, etc. ?
This would be done in the same way as you'd do it for any text element, using (% ... %). Note that right now this is not supported in wikimodel inside paragraph but Mikhail has agreed to support it in the future in wikimodel. Thanks -Vincent
As you can see the image is specified as a URI.
Ok with everyone?
Thanks -Vincent
On Wed, Sep 17, 2008 at 4:32 PM, Vincent Massol <[email protected]> wrote:
On Sep 17, 2008, at 1:00 PM, Thomas Mortagne wrote:
On Wed, Sep 17, 2008 at 10:30 AM, Vincent Massol <[email protected]> wrote:
Hi,
I've updated this page http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20 which describes both XWiki syntax 1.0 and XWiki Syntax 2.0.
I want to make sure we agree with the following syntax decisions and especially with regards to Creole since we want to be close to it.
One disclaimer though: the creole specification is badly done and is not strict enough. There are lots of ambiguities in their descriptions of the syntax elements so it's almost impossible to ensure to be fully compatible with some element syntaxes.
1) New lines
Right now we honor new lines (we've all already voted to have this). I just wanted to point out that this is different from Creole.
2) Horizontal lines
We accept 4 or more dashes. Creole says it's 4 dashes only. However if you try it on their test page at http://www.wikicreole.org/EditX.jsp?page=JSPWikiTestCases if works fine with more than 4 dashes too.
3) Special numbered lists
Is it ok to have this syntax:
(% class="roman" %) 1. item1 1. item2
Or do we introduce new syntax elements as it's done in XWiki Syntax 1.0:
i. item1 i. item2
See http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20#HLists for more examples.
I have the feeling it would be better to use our 1.0 syntax for this (note that this requires some heavy changes to wikimodel - Will need to discuss it with Mikhail).
4) Images
There's currently no special support for images in wikimodel. The solution wikimodel proposes is to implement its support through linline links. For example:
This is an image:my.png image.
Seems too basic... What about defining width, height, etc. ?
This would be done in the same way as you'd do it for any text element, using (% ... %).
Note that right now this is not supported in wikimodel inside paragraph but Mikhail has agreed to support it in the future in wikimodel.
+1 for image:my.png style with (% .. %) for customizing. Thanks. - Asiri
Thanks -Vincent
As you can see the image is specified as a URI.
Ok with everyone?
Thanks -Vincent
devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
On Wed, Sep 17, 2008 at 1:08 PM, Asiri Rathnayake <[email protected]> wrote:
On Wed, Sep 17, 2008 at 4:32 PM, Vincent Massol <[email protected]> wrote:
On Sep 17, 2008, at 1:00 PM, Thomas Mortagne wrote:
On Wed, Sep 17, 2008 at 10:30 AM, Vincent Massol <[email protected]> wrote:
Hi,
I've updated this page http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20 which describes both XWiki syntax 1.0 and XWiki Syntax 2.0.
I want to make sure we agree with the following syntax decisions and especially with regards to Creole since we want to be close to it.
One disclaimer though: the creole specification is badly done and is not strict enough. There are lots of ambiguities in their descriptions of the syntax elements so it's almost impossible to ensure to be fully compatible with some element syntaxes.
1) New lines
Right now we honor new lines (we've all already voted to have this). I just wanted to point out that this is different from Creole.
2) Horizontal lines
We accept 4 or more dashes. Creole says it's 4 dashes only. However if you try it on their test page at http://www.wikicreole.org/EditX.jsp?page=JSPWikiTestCases if works fine with more than 4 dashes too.
3) Special numbered lists
Is it ok to have this syntax:
(% class="roman" %) 1. item1 1. item2
Or do we introduce new syntax elements as it's done in XWiki Syntax 1.0:
i. item1 i. item2
See http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20#HLists for more examples.
I have the feeling it would be better to use our 1.0 syntax for this (note that this requires some heavy changes to wikimodel - Will need to discuss it with Mikhail).
4) Images
There's currently no special support for images in wikimodel. The solution wikimodel proposes is to implement its support through linline links. For example:
This is an image:my.png image.
Seems too basic... What about defining width, height, etc. ?
This would be done in the same way as you'd do it for any text element, using (% ... %).
Note that right now this is not supported in wikimodel inside paragraph but Mikhail has agreed to support it in the future in wikimodel.
+1 for image:my.png style with (% .. %) for customizing.
+1 too, using (% %) is ok for me
Thanks.
- Asiri
Thanks -Vincent
As you can see the image is specified as a URI.
Ok with everyone?
Thanks -Vincent
devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
_______________________________________________ devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
-- Thomas Mortagne
Thomas Mortagne wrote:
On Wed, Sep 17, 2008 at 1:08 PM, Asiri Rathnayake <[email protected]> wrote:
On Wed, Sep 17, 2008 at 4:32 PM, Vincent Massol <[email protected]> wrote:
On Sep 17, 2008, at 1:00 PM, Thomas Mortagne wrote:
On Wed, Sep 17, 2008 at 10:30 AM, Vincent Massol <[email protected]> wrote:
Hi,
I've updated this page http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20 which describes both XWiki syntax 1.0 and XWiki Syntax 2.0.
I want to make sure we agree with the following syntax decisions and especially with regards to Creole since we want to be close to it.
One disclaimer though: the creole specification is badly done and is not strict enough. There are lots of ambiguities in their descriptions of the syntax elements so it's almost impossible to ensure to be fully compatible with some element syntaxes.
1) New lines
Right now we honor new lines (we've all already voted to have this). I just wanted to point out that this is different from Creole.
2) Horizontal lines
We accept 4 or more dashes. Creole says it's 4 dashes only. However if you try it on their test page at http://www.wikicreole.org/EditX.jsp?page=JSPWikiTestCases if works fine with more than 4 dashes too.
3) Special numbered lists
Is it ok to have this syntax:
(% class="roman" %) 1. item1 1. item2
Or do we introduce new syntax elements as it's done in XWiki Syntax 1.0:
i. item1 i. item2
See http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20#HLists for more examples.
I have the feeling it would be better to use our 1.0 syntax for this (note that this requires some heavy changes to wikimodel - Will need to discuss it with Mikhail).
4) Images
There's currently no special support for images in wikimodel. The solution wikimodel proposes is to implement its support through linline links. For example:
This is an image:my.png image. Seems too basic... What about defining width, height, etc. ? This would be done in the same way as you'd do it for any text element, using (% ... %).
Note that right now this is not supported in wikimodel inside paragraph but Mikhail has agreed to support it in the future in wikimodel.
+1 for image:my.png style with (% .. %) for customizing.
+1 too, using (% %) is ok for me
+1 too
Thanks.
- Asiri
Thanks -Vincent
As you can see the image is specified as a URI.
Ok with everyone?
Thanks -Vincent
devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
_______________________________________________ devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
On Sep 17, 2008, at 10:30 AM, Vincent Massol wrote:
Hi,
I've updated this page http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20 which describes both XWiki syntax 1.0 and XWiki Syntax 2.0.
I want to make sure we agree with the following syntax decisions and especially with regards to Creole since we want to be close to it.
One disclaimer though: the creole specification is badly done and is not strict enough. There are lots of ambiguities in their descriptions of the syntax elements so it's almost impossible to ensure to be fully compatible with some element syntaxes.
1) New lines
Right now we honor new lines (we've all already voted to have this). I just wanted to point out that this is different from Creole.
2) Horizontal lines
We accept 4 or more dashes. Creole says it's 4 dashes only. However if you try it on their test page at http://www.wikicreole.org/EditX.jsp?page=JSPWikiTestCases if works fine with more than 4 dashes too.
3) Special numbered lists
Is it ok to have this syntax:
(% class="roman" %) 1. item1 1. item2
Or do we introduce new syntax elements as it's done in XWiki Syntax 1.0:
i. item1 i. item2
See http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20#HLists for more examples.
I have the feeling it would be better to use our 1.0 syntax for this (note that this requires some heavy changes to wikimodel - Will need to discuss it with Mikhail).
4) Images
There's currently no special support for images in wikimodel. The solution wikimodel proposes is to implement its support through linline links. For example:
This is an image:my.png image.
If we're ok to use the uri notationI'm proposing to use the same syntax we've started discussing for image links. image:subwiki:Space.Page^imagename Note that ^ is temporary since we haven't fully decided yet what symbol to use. I'll reopen the discussion for that. thanks -Vincent
As you can see the image is specified as a URI.
Ok with everyone?
Thanks -Vincent
Vincent Massol wrote:
I've updated this page http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20 which describes both XWiki syntax 1.0 and XWiki Syntax 2.0.
I want to make sure we agree with the following syntax decisions and especially with regards to Creole since we want to be close to it.
One disclaimer though: the creole specification is badly done and is not strict enough. There are lots of ambiguities in their descriptions of the syntax elements so it's almost impossible to ensure to be fully compatible with some element syntaxes.
1) New lines
Right now we honor new lines (we've all already voted to have this). I just wanted to point out that this is different from Creole.
2) Horizontal lines
We accept 4 or more dashes. Creole says it's 4 dashes only. However if you try it on their test page at http://www.wikicreole.org/EditX.jsp?page=JSPWikiTestCases if works fine with more than 4 dashes too.
3) Special numbered lists
Is it ok to have this syntax:
(% class="roman" %) 1. item1 1. item2
Or do we introduce new syntax elements as it's done in XWiki Syntax 1.0:
i. item1 i. item2
See http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20#HLists for more examples.
I have the feeling it would be better to use our 1.0 syntax for this (note that this requires some heavy changes to wikimodel - Will need to discuss it with Mikhail).
+1 to support both. +0 to only 1. with (% %)
4) Images
There's currently no special support for images in wikimodel. The solution wikimodel proposes is to implement its support through linline links. For example:
This is an image:my.png image.
+1. Even prefix is not good for I18N, I don't see other acceptable ways in http://www.wikicreole.org/wiki/ImagesReasoning.
If we're ok to use the uri notationI'm proposing to use the same syntax we've started discussing for image links.
image:subwiki:Space.Page^imagename
Note that ^ is temporary since we haven't fully decided yet what symbol to use. I'll reopen the discussion for that.
+1 -- Artem Melentyev
On Wed, Sep 17, 2008 at 2:00 PM, Vincent Massol <[email protected]> wrote:
Hi,
I've updated this page http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20 which describes both XWiki syntax 1.0 and XWiki Syntax 2.0.
I want to make sure we agree with the following syntax decisions and especially with regards to Creole since we want to be close to it.
One disclaimer though: the creole specification is badly done and is not strict enough. There are lots of ambiguities in their descriptions of the syntax elements so it's almost impossible to ensure to be fully compatible with some element syntaxes.
1) New lines
Right now we honor new lines (we've all already voted to have this). I just wanted to point out that this is different from Creole.
2) Horizontal lines
We accept 4 or more dashes. Creole says it's 4 dashes only. However if you try it on their test page at http://www.wikicreole.org/EditX.jsp?page=JSPWikiTestCases if works fine with more than 4 dashes too.
3) Special numbered lists
Is it ok to have this syntax:
(% class="roman" %) 1. item1 1. item2
Or do we introduce new syntax elements as it's done in XWiki Syntax 1.0:
i. item1 i. item2
I think the first approach is more extensible, but bit confusing for the user at the first sight.
See http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiSyntax20#HLists for more examples.
I have the feeling it would be better to use our 1.0 syntax for this (note that this requires some heavy changes to wikimodel - Will need to discuss it with Mikhail).
4) Images
There's currently no special support for images in wikimodel. The solution wikimodel proposes is to implement its support through linline links. For example:
This is an image:my.png image.
As you can see the image is specified as a URI.
Ok with everyone?
Thanks -Vincent
_______________________________________________ devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
participants (7)
-
Artem Melentyev -
Asiri Rathnayake -
Guillaume Lerouge -
Marius Dumitru Florea -
Sergiu Dumitriu -
Thomas Mortagne -
Vincent Massol