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@xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs
