|
Size: 2408
Comment:
|
Size: 3137
Comment: Some observations.
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 20: | Line 20: |
Well, it's a shame about the pipe character, but the other arguments about why Moin syntax "sucks" aren't convincing: you can't apparently have non-!WikiName links in Google Code or Trac (unless "no need" means that Trac figures it out), Trac still uses the baroque `wiki:WikiName` stuff when making a labelled link. And the full URL for attachments? It's exactly this kind of stuff which either confuses the Wiki when trying to label links (a problem I've seen with !MediaWiki) or just breaks when any aspect of the Wiki configuration changes (a problem that also comes with !MediaWiki). You should definitely argue with the Moin folks about that pipe character, though. -- PaulBoddie <<DateTime(2010-09-30T15:24:39+0100)>> |
Wiki Syntax Comparison
Courtesy of RadomirDopieralski...
MoinMoin 1.5 and earlier |
MoinMoin 1.6 and later |
Google Code |
Trac |
WikiName |
WikiName |
WikiName |
WikiName |
http://example.com |
http://example.com |
http://example.com |
http://example.com |
["page name"] |
[[page name]] |
-no requests to add- |
-no need- |
[http://example.com link text] |
[[http://example.com|link text]] |
[http://example.com link text] |
[http://example.com link text] |
[:WikiName:link text] |
[[WikiName|link text]] |
[WikiName link text] |
[wiki:WikiName link text] |
[:page name:link text] |
[[page name|link text]] |
-no need- |
-no need- |
attachment:something.zip |
[[attachment:something.zip]] |
-no attachments- |
-full URL- |
image:something.png |
{{attachment:something.png}} |
-URL ending in .gif, .png, .jpg- |
[[Image(something.png)]] |
|
[[page name|link text|additional parameters]] |
|
|
|
{{page name|link text|additional parameters}} |
|
|
The rationale for the change is that links, apart from those in the WikiName and bare URL styles, end up with a uniform syntax, and the embedding of an object in the page is done by modifying the bracketing style. Previously, linking to a page in the same Wiki and using a label instead of the page name involved a relatively arcane syntax; this common case now fits in much better.
The drawback of 1.6 syntax is that you need to type more and press Shift key more than necessary. Links become less readable, because of excessive decoration and lack of whitespace between logical parts. Another big problem with this syntax is that there is no pipe symbol on Russian keyboard layout, and even if don't need to switch layouts to copy/paste a link - you definitely need to switch it twice for the pipe to comment it. -- techtonik 2010-09-30 13:09:49
Well, it's a shame about the pipe character, but the other arguments about why Moin syntax "sucks" aren't convincing: you can't apparently have non-WikiName links in Google Code or Trac (unless "no need" means that Trac figures it out), Trac still uses the baroque wiki:WikiName stuff when making a labelled link. And the full URL for attachments? It's exactly this kind of stuff which either confuses the Wiki when trying to label links (a problem I've seen with MediaWiki) or just breaks when any aspect of the Wiki configuration changes (a problem that also comes with MediaWiki). You should definitely argue with the Moin folks about that pipe character, though. -- PaulBoddie 2010-09-30 14:24:39