Differences between revisions 4 and 5
Revision 4 as of 2010-09-30 14:24:42
Size: 3137
Editor: PaulBoddie
Comment: Some observations.
Revision 5 as of 2011-01-15 14:25:47
Size: 3887
Editor: techtonik
Comment: added spaced syntax for Trac
Deletions are marked like this. Additions are marked like this.
Line 8: Line 8:
|| `["page name"]` || `[[page name]]` || -no requests to add- || -no need- || || `["page name"]` || `[[page name]]` || -no requests to add- || wiki:"page name" ||
Line 22: Line 22:

  pipe character alone is enough to keep off a 80% of users. You '''can''' have non-!WikiName links in both Trac and Google Code. What Google Code doesn't allow is to name your pages with non-!WikiNames. Trac allows arbitrary page name and I've just added Trac syntax for it. Trac supports non-baroque syntax of Google Code, and I specifically added `wiki:WikiName` syntax, becase explicit is better than implicit, especially if you want to illustrate how convenient are Trac namespaces for various links. As for attachments, I don't link them so often as to understand the underlying problem. Nor I have time to argue with authors of products I don't use (this wiki just forces me to it). -- [[techtonik]] <<DateTime(2011-01-15T14:25:45Z)>>

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-

wiki:"page name"

[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

    • pipe character alone is enough to keep off a 80% of users. You can have non-WikiName links in both Trac and Google Code. What Google Code doesn't allow is to name your pages with non-WikiNames. Trac allows arbitrary page name and I've just added Trac syntax for it. Trac supports non-baroque syntax of Google Code, and I specifically added wiki:WikiName syntax, becase explicit is better than implicit, especially if you want to illustrate how convenient are Trac namespaces for various links. As for attachments, I don't link them so often as to understand the underlying problem. Nor I have time to argue with authors of products I don't use (this wiki just forces me to it). -- techtonik 2011-01-15 14:25:45

SiteImprovements/WikiSyntaxComparison (last edited 2011-01-15 14:28:15 by techtonik)

Unable to edit the page? See the FrontPage for instructions.