Monthly Archive for November, 2005

Page 2 of 4

Wiki markup languages: syntax confusion


In the last couple of months I have been working with Twiki, PhpWiki, MediaWiki, WordPress and PBwiki (oh, the joys of being a freelancer). They all have their own pros and cons, but unfortunately also almost all have their own markup dialect. With markup I mean: the way you should indicate in regular text which parts should be bold/ italic/ heading/ code/ links/ …

The original C2 Wiki (1995) started with CamelCase keywords and ”’bold”’ (that’s three single quotes) for bold, but quite some variants (sometimes improvements) have been created. The problem is that for each wiki system you use (admitted, I might be a heavier user than the average Joe) you have to reprogram your habits: how do I put a link, an image, a bullet list, a piece of code? It’s like switching between VBScript, VB.Net and C#, or QWERTY and AZERTY all the time.

Standard markup dialects

My suggestion:

  • create a limited number of standard wiki markup syntaxes (let’s say 4),
  • let every wiki system offer their users a choice between them.

I’m used to working on Wikipedia? I use the WikiText syntax everywhere. Or Textile, or Markdown. That way I just have to get used to one way of doing things.

Lightweight Markup languages

Wikimedia syntax
As used by Wikipedia: also called WikiText

Internal link [[keyword]] or [[keyword][text to show]]
External link [http://www.example.com text to show]
Image [[Image:example.jpg|Text to show]]
Bold/Italic '''bold'''/''italic''
Heading 1 =HEADING1=
Heading 2 ==HEADING==

Twiki syntax

Internal link CamelCase or [[keyword][text to show]]
External link http://www.example.com or [[http://xml.org XML]]
Image http://www.example.com/image.jpg
Bold/Italic *bold*/_italic_
Heading 1 ---+HEADING1
Heading 2 ---++HEADING

PBWiki syntax
Used on pbwiki hosted wikis.

Internal link CamelCase
External link http://www.example.com or [http://www.example.com|text to show]
Image http://www.example.com/image.jpg
Bold/Italic **bold**/''italic''
Heading 1 !HEADING1
Heading 2 !!HEADING

Textile syntax
Available as a plug-in for WordPress and some wiki systems

Internal link -
External link "This is a link ":http://www.example.com
Image !http://www.example.com/image.jpg!
Bold/Italic *bold*/_italic_
Heading 1 h1. HEADING1
Heading 2 h2. HEADING

Markdown syntax

Internal link [text to show][id]
External link [This link](http://example.net/)
Image ![text to show](http://www.example.com/image.jpg)
Bold/Italic **bold**/_italic_
Heading 1 # HEADING1
Heading 2 ## HEADING

BBCode syntax
Used on lots of forums

Internal link -
External link [URL=http://example.net/]Text to show[/URL]
Image [IMG]http://www.example.com/image.jpg[/IMG]
Bold/Italic [b]bold[/b]/[i]italic[/i]
Heading 1 -
Heading 2 -

And some more examples on List of lightweight markup languages.

Add yourself to the Belgian Bloggers map!

(Post in Dutch)
Een leuk initiatief van Gaetano Palermo: een kaart waar elke Belgische blogger zijn coordinaten kan op mappen. Misschien een leuke vervanging van de kaart op blogium.be.

Beste collega-bloggers, chèrs co-bloggeurs, ajoutez-vous aan de kaart en ajouttant uw naam, stad en blog URL op frappr.com!


via expressions.be

Technorati:

Consumers digital rights

Consumer Digital Rights
The BEUC (“Bureau Européen des Unions de consommateurs” or European Consumers Organisation) has set up a web site to inform consumers on which rights they still DO have on their digital content:
www.consumersdigitalrights.org

Consumers are not pirates!
P2P is like stealing a CD in a shop!“, “We have to protect artists who are being robbed by consumers on the Internet!“.
We are being fed this type of “truth” thanks to the efforts of certain major music and film industry interests.
For this reason, we are launching today with a press conference in the European Parliament and with the support of Mrs Zuzana Roithová MEP, a Campaign supported by a “Declaration of Consumers’ Digital Rights“.
from consumersdigitalrights.org

They put the following 6 basic consumer rights forward:

The BEUC tries to give a voice to a large group of consumers and individuals that have a hard time to counter the lobbying power of record and movie companies. If you want to support the action, put a logo on your own page!

  • 240 x 61 pixels:
    <a href="http://www.consumersdigitalrights.org" target="_blank"><img src="http://static.flickr.com/32/63355147_3827f27158_m.jpg" title="BEUC Consumer Digital Rights" border="0" /></a>
  • 500 x 127 pixels:
    <a href="http://www.consumersdigitalrights.org" target="_blank"><img src="http://static.flickr.com/32/63355147_3827f27158.jpg" title="BEUC Consumer Digital Rights" border="0" /></a>

And, yes, that’s me on the interview page.

Technorati:

It’s so cool to be anti-Web 2.0

Not only that, the very 2.0 in Web 2.0 seems carefully crafted as a way to denegrate the clueless “Web 1.0″ idiots, poor children, in the same way the first round of teenagers starting dotcoms in 1999 dissed their elders with the decade’s mantra, “They just don’t get it!”
I’ll do my part. I hereby pledge never again to use the term “Web 2.0″ on this blog, or to link to any article that mentions it. You’re welcome.
(from joelonsoftware.com)

I was really bothered by this statement for 2 reasons:

  • Why does something have to be either the answer to all questions or completely irrelevant? Isn’t there like a really interesting grey zone in the middle? Web 2.0 is not gonna make everyone rich, it is not gonna change every aspect of our lives, but that’s doesn’t mean it is to be dismissed and never talked about. Because it is a collection of technologies and principles and ways-of-working, and as such not trivial to grasp, it might not be clear from the first instant if it might have implications on the way you do business or not (see Dvorak quotes below).
  • It’s so easy to be completely negative about something. If you’re positive, it might come over as kissing *ss, but dissing something really makes you look cool (sometimes “teenager cool” with rude language like Go Flock Yourself). If you’re wrong, no one bothers coming back to say “told you so”. I even feel Joel is doing the exact thing he claims to hate: distancing himself from the rest, so they feel silly. “Web 2.0? Oh, that is só summer of 2005!”


Why do I like Web 2.0? I see people enthusiastic again. I see brains working, creativity being appreciated and people setting up new initiatives. These are not people walking round with $$ in their eyes and an “I ♥ I.P.O.” tattoo on their shoulder. But I can tell you it’s more fun to work in IT now than it was 5 years ago.

I predict that people like Joel, who intentionally distance themselves from a bottom-up movement like Web 2.0 because it is fuzzy and incomplete, are in fact labeling themselves as out of touch with the new segment for whom such terms make sense, if only as a means of self-identity. The fact that they don’t make sense to other, older people and outsiders is part of the appeal. It worries me that Joel sounds like a troll here, like PC Magazine’s Dvorak, howling at whatever newfangled stuff is coming down the pike. The message from curmudgeons like that is that everything important has already been invented, catalogued, and understood.
(from corante.com)

Me too, I was reminded of the difference between two posts of John Dvorak in PCMag:

This is followed by a manic period where the new idea is extolled as the next big thing, and nutjobs run around like dogs released from the kennel yapping about how great it is. In this fashion, we have been introduced to podcasting-the next big thing. Too bad it’s a kludge that doesn’t work as advertised unless you have a Macintosh and an iPod.
from Podcasting: Not Ready for Prime Time (Oct 2004)

and

There is no doubt in my mind that podcasting is not only here to stay but will also shortly threaten established media broadcast systems. It’s not so much that they will all be destroyed by homebrew networks, but podcasts will be taking away just enough listeners to be a major concern
from Podcasting: The Next Big Thing (Jun 2005)

That sounds a lot like: “I dont get it, so it’s crap” and “Oh, now I get it, it’s brilliant!”.

Technorati: