Re: [xwiki-devs] [Proposal] XWiki 2.0 syntax : going further on the syntax overhaul

Hi XWikiers, Those last months we've discussed a lot about precise elements of the new XWiki 2.0 syntax : - usage of 2 chars for **bold** and [[links]] - {{macro/}} syntax - Linebreaks on carriage returns - Linking to attachments/Insert link to image - |table| syntax - styling syntax - emoticons So far the idea was to keep the xwiki/2.0 syntax as close as possible from xwiki/1.0. IMHO we've reached a point where xwiki/2.0 is so different from xwiki/1.0 that it could be the occasion to go further and replace our few radeox leftovers by their widespread equivalent. That's the first thing I'd like to discuss, do we all agree to make other substantial modifications to xwiki/2.0 ? Here's my +1.

Being completely in line with Creole [1] or WikiSyntaxCommon [2] is not an option since we've already made some incompatible choices (like linebreaks on carriage returns) and it would imply a big amount of work now that the new rendering is approaching a stable state. That's the reason why this proposal is about 2 basic (and important) wiki syntax elements, those 2 modifications would make xwiki syntax familiar to wikiPowerUsers. 1) Usage of // instead of ~~ for italic Creole rationale : A slash (/) looks like slanted italics, so it is intuitive and thus easier to remember. See http://www.wikicreole.org/wiki/BoldAndItalicsReasoning Note : on all the keyboard mappings I know slashes are more easily reachable than ~. Here's my +1.

2) Usage of equal signs instead of 1./1.1/etc for Headings Creole rationale : Using equal signs (=) is the most popular wiki header markup. Since there are more equal signs for smaller headers, subheaders will become more indented making it easier to get a visual overview from the markup alone. See http://www.wikicreole.org/wiki/HeadingsReasoning

Note : We've experienced problems in the past with the 1/1.1 syntax (bad document section computation, problems with table cells starting with 1, etc) but those problems are addressed in the new rendering. Anyway I think users are more likely to unintentionaly start a line with a 1 than a = (like in "1 is more than 2" in the middle of a paragraph). What I personnaly like with this syntax is that it makes sections very visible when editing a page in wiki mode. About unclosed titles : === Also level 3 === Also level 3 = === Also level 3 == a) Don't interpret them +0. b) Interpret them but make closed title our default (generated by wysiwyg) +1, as I wrote above I think that having clear sections in a page helps to navigate in edit mode. c) Interpret them and make it our default -0.

[1] : http://www.wikicreole.org/wiki/Creole1.0 [2] : http://code.google.com/p/wikimodel/wiki/WikiSyntaxCommon Thanks, JV. _______________________________________________ devs mailing list devs(a)xwiki.org http://lists.xwiki.org/mailman/listinfo/devs