<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	>
<channel>
	<title>Comments on: Wiki Syntax Considered Harmful</title>
	<atom:link href="http://www.symphonious.net/2005/07/19/wiki-syntax-considered-harmful/feed/" rel="self" type="application/rss+xml" />
	<link>http://www.symphonious.net/2005/07/19/wiki-syntax-considered-harmful/</link>
	<description>Living in a state of accord.</description>
	<pubDate>Thu, 04 Dec 2008 07:08:41 +0000</pubDate>
	<generator>http://wordpress.org/?v=2.6.5</generator>
		<item>
		<title>By: Symphonious &#187; Need a Standard Wiki Syntax? Try HTML</title>
		<link>http://www.symphonious.net/2005/07/19/wiki-syntax-considered-harmful/#comment-54825</link>
		<dc:creator>Symphonious &#187; Need a Standard Wiki Syntax? Try HTML</dc:creator>
		<pubDate>Sat, 27 Jan 2007 06:23:46 +0000</pubDate>
		<guid isPermaLink="false">http://www.symphonious.net/2005/07/19/wiki-syntax-considered-harmful/#comment-54825</guid>
		<description>[...] I&#39;ve said it before, and I&#39;ll say it again - the best syntax you can use for your wiki is HTML, or probably better XHTML. It&#39;s a defined standard with a wide range of excellent WYSIWYG&#160;editors, it&#39;s well known, very portable and saves you from having to write a converter to display your wiki pages. [...]</description>
		<content:encoded><![CDATA[<p>[...] I&#39;ve said it before, and I&#39;ll say it again - the best syntax you can use for your wiki is HTML, or probably better XHTML. It&#39;s a defined standard with a wide range of excellent WYSIWYG&#160;editors, it&#39;s well known, very portable and saves you from having to write a converter to display your wiki pages. [...]</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Symphonious &#187; Scoble Wants a Wiki</title>
		<link>http://www.symphonious.net/2005/07/19/wiki-syntax-considered-harmful/#comment-26788</link>
		<dc:creator>Symphonious &#187; Scoble Wants a Wiki</dc:creator>
		<pubDate>Sun, 23 Jul 2006 07:31:32 +0000</pubDate>
		<guid isPermaLink="false">http://www.symphonious.net/2005/07/19/wiki-syntax-considered-harmful/#comment-26788</guid>
		<description>[...] So Scoble&#39;s looking for a wiki, seems to have gotten a few popular suggestions. Since he wants it hosted I can&#39;t really offer anything - I don&#39;t have the server space or sysadmin knowledge to handle something of Scoble&#39;s popularity. Despite that, can I recommend that you make the quality of the editor your most important criteria? It will make a huge difference to the adoption rate of the wiki. I&#39;ve discussed this before:&#160;Wiki Syntax Considered Harmful and Making Wikis Work. [...]</description>
		<content:encoded><![CDATA[<p>[...] So Scoble&#39;s looking for a wiki, seems to have gotten a few popular suggestions. Since he wants it hosted I can&#39;t really offer anything - I don&#39;t have the server space or sysadmin knowledge to handle something of Scoble&#39;s popularity. Despite that, can I recommend that you make the quality of the editor your most important criteria? It will make a huge difference to the adoption rate of the wiki. I&#39;ve discussed this before:&#160;Wiki Syntax Considered Harmful and Making Wikis Work. [...]</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: &#8230;. &#187; links for 2006-05-08</title>
		<link>http://www.symphonious.net/2005/07/19/wiki-syntax-considered-harmful/#comment-19608</link>
		<dc:creator>&#8230;. &#187; links for 2006-05-08</dc:creator>
		<pubDate>Sat, 03 Jun 2006 16:41:39 +0000</pubDate>
		<guid isPermaLink="false">http://www.symphonious.net/2005/07/19/wiki-syntax-considered-harmful/#comment-19608</guid>
		<description>[...] Symphonious » Wiki Syntax Considered Harmful (tags: wiki) [...]</description>
		<content:encoded><![CDATA[<p>[...] Symphonious » Wiki Syntax Considered Harmful (tags: wiki) [...]</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: &#8230;. &#187; Blog Archive &#187; Wiki in Companies</title>
		<link>http://www.symphonious.net/2005/07/19/wiki-syntax-considered-harmful/#comment-16384</link>
		<dc:creator>&#8230;. &#187; Blog Archive &#187; Wiki in Companies</dc:creator>
		<pubDate>Mon, 15 May 2006 06:27:22 +0000</pubDate>
		<guid isPermaLink="false">http://www.symphonious.net/2005/07/19/wiki-syntax-considered-harmful/#comment-16384</guid>
		<description>[...] Wiki 在商業上的應用 Symphonious &#187; Wiki Syntax Considered Harmful Exploiting the power of enterprise wikis What makes an enterprise wiki? [...]</description>
		<content:encoded><![CDATA[<p>[...] Wiki 在商業上的應用 Symphonious &raquo; Wiki Syntax Considered Harmful Exploiting the power of enterprise wikis What makes an enterprise wiki? [...]</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: aj</title>
		<link>http://www.symphonious.net/2005/07/19/wiki-syntax-considered-harmful/#comment-7082</link>
		<dc:creator>aj</dc:creator>
		<pubDate>Wed, 20 Jul 2005 04:20:27 +0000</pubDate>
		<guid isPermaLink="false">http://www.symphonious.net/2005/07/19/wiki-syntax-considered-harmful/#comment-7082</guid>
		<description>Firefox on OS X is the bane of my existence.  The Java support in FireFox is generally woeful but on OS X is just absolutely abysmal.  Fortunately, enterprise isn't currently using OS X much nor are they using FireFox much so it's pretty rare that we run into that particular problem. 

Falling back to HTML markup really isn't much worse than falling back to wiki syntax in a few rare cases, and if it were really a problem you could fallback to a FireFox specific WYSIWYG editor (ie: the built-in features that FireFox has).  Yes that would take more effort, but the benefit to users and the improved adoption of the system should justify it for a heck of a lot of cases.  Of course it probably pays to run the content through Tidy to clean it up if it's come in from hand-editing so that it's cleaner for users to see (apparently unlike with our demos).</description>
		<content:encoded><![CDATA[<p>Firefox on OS X is the bane of my existence.  The Java support in FireFox is generally woeful but on OS X is just absolutely abysmal.  Fortunately, enterprise isn&#8217;t currently using OS X much nor are they using FireFox much so it&#8217;s pretty rare that we run into that particular problem. </p>
<p>Falling back to HTML markup really isn&#8217;t much worse than falling back to wiki syntax in a few rare cases, and if it were really a problem you could fallback to a FireFox specific WYSIWYG editor (ie: the built-in features that FireFox has).  Yes that would take more effort, but the benefit to users and the improved adoption of the system should justify it for a heck of a lot of cases.  Of course it probably pays to run the content through Tidy to clean it up if it&#8217;s come in from hand-editing so that it&#8217;s cleaner for users to see (apparently unlike with our demos).</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Byron Ellacott</title>
		<link>http://www.symphonious.net/2005/07/19/wiki-syntax-considered-harmful/#comment-7081</link>
		<dc:creator>Byron Ellacott</dc:creator>
		<pubDate>Wed, 20 Jul 2005 03:35:27 +0000</pubDate>
		<guid isPermaLink="false">http://www.symphonious.net/2005/07/19/wiki-syntax-considered-harmful/#comment-7081</guid>
		<description>I'm using Firefox on OS X.  I would expect that I don't have whatever particular java toy is needed.  By and large I agree with you, the point I poorly attempted to raise is that WYSIWYG tools aren't guaranteed to run on even reasonably modern systems, and a good fallback is essential.  The Ephox demo I tried out certainly didn't have that: the contents of the textarea was jumbled up HTML.</description>
		<content:encoded><![CDATA[<p>I&#8217;m using Firefox on OS X.  I would expect that I don&#8217;t have whatever particular java toy is needed.  By and large I agree with you, the point I poorly attempted to raise is that WYSIWYG tools aren&#8217;t guaranteed to run on even reasonably modern systems, and a good fallback is essential.  The Ephox demo I tried out certainly didn&#8217;t have that: the contents of the textarea was jumbled up HTML.</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: aj</title>
		<link>http://www.symphonious.net/2005/07/19/wiki-syntax-considered-harmful/#comment-7080</link>
		<dc:creator>aj</dc:creator>
		<pubDate>Wed, 20 Jul 2005 01:07:01 +0000</pubDate>
		<guid isPermaLink="false">http://www.symphonious.net/2005/07/19/wiki-syntax-considered-harmful/#comment-7080</guid>
		<description>Generated HTML from Ephox editors and many other modern WYSIWYG editors is exceptionally readable.  In fact, it's usually more readable than handwritten code.  Take a look at the source code for this page - the entry was created in EditLive! for Java.  It's indented cleanly and contains the bare minimum tags required to markup the content.  You can paste in content from Word and have it come out nearly that clean even though the HTML Word generates is the most awful mess you've ever seen.

Also, I'm not sure what browser you're using, we support the widest range of browsers and OSs of any WYSIWYG editor that I know of so it's unfortunate that you don't use a supported browser.  For our particular market that's not an issue because we tend to sell to the enterprise where they use a standardized browser or a small number of browsers and platforms.

It's really important to stress that users should never have to see raw markup in any form.  If they do you have a problem with your system.  It should be displayed and edited as WYSIWYG, so being harder or easier to read is totally irrelevant.

You're right that Wiki syntax is easier to clean of cross site scripting attacks, but there are existing tools to strip JavaScript from HTML so it's not that big a deal.  It also depends on your target market - JavaScript is explicitly allowed on our internal wiki and used to great effect but that's with a controlled set of users who get fired if they try to break our systems - social control rather than technical.  If you have a publicly available wiki you need to be more concerned about it but it's still not that difficult.  I'm sure the Daisy developers have already confronted this problem, just take a look at their code.

By the way, while a WYSIWYG editor can probably be configured to prevent a user entering JavaScript you shouldn't rely on this because I could POST a JavaScript containing document directly to the server and by-pass the inherently client-side editor.  Never rely on client side validation.

Finally, there are a lot of crap WYSIWYG editors out there but for non-geek users (ie: not you and probably not any of the readers of this site) they are almost all better than having to edit any syntax by hand.  Besides which there's so much choice out there that you should be able to find one that suits your users.  Don't forget to spend the time configuring them too!</description>
		<content:encoded><![CDATA[<p>Generated HTML from Ephox editors and many other modern WYSIWYG editors is exceptionally readable.  In fact, it&#8217;s usually more readable than handwritten code.  Take a look at the source code for this page - the entry was created in EditLive! for Java.  It&#8217;s indented cleanly and contains the bare minimum tags required to markup the content.  You can paste in content from Word and have it come out nearly that clean even though the HTML Word generates is the most awful mess you&#8217;ve ever seen.</p>
<p>Also, I&#8217;m not sure what browser you&#8217;re using, we support the widest range of browsers and OSs of any WYSIWYG editor that I know of so it&#8217;s unfortunate that you don&#8217;t use a supported browser.  For our particular market that&#8217;s not an issue because we tend to sell to the enterprise where they use a standardized browser or a small number of browsers and platforms.</p>
<p>It&#8217;s really important to stress that users should never have to see raw markup in any form.  If they do you have a problem with your system.  It should be displayed and edited as WYSIWYG, so being harder or easier to read is totally irrelevant.</p>
<p>You&#8217;re right that Wiki syntax is easier to clean of cross site scripting attacks, but there are existing tools to strip JavaScript from HTML so it&#8217;s not that big a deal.  It also depends on your target market - JavaScript is explicitly allowed on our internal wiki and used to great effect but that&#8217;s with a controlled set of users who get fired if they try to break our systems - social control rather than technical.  If you have a publicly available wiki you need to be more concerned about it but it&#8217;s still not that difficult.  I&#8217;m sure the Daisy developers have already confronted this problem, just take a look at their code.</p>
<p>By the way, while a WYSIWYG editor can probably be configured to prevent a user entering JavaScript you shouldn&#8217;t rely on this because I could POST a JavaScript containing document directly to the server and by-pass the inherently client-side editor.  Never rely on client side validation.</p>
<p>Finally, there are a lot of crap WYSIWYG editors out there but for non-geek users (ie: not you and probably not any of the readers of this site) they are almost all better than having to edit any syntax by hand.  Besides which there&#8217;s so much choice out there that you should be able to find one that suits your users.  Don&#8217;t forget to spend the time configuring them too!</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Byron Ellacott</title>
		<link>http://www.symphonious.net/2005/07/19/wiki-syntax-considered-harmful/#comment-7079</link>
		<dc:creator>Byron Ellacott</dc:creator>
		<pubDate>Tue, 19 Jul 2005 23:27:02 +0000</pubDate>
		<guid isPermaLink="false">http://www.symphonious.net/2005/07/19/wiki-syntax-considered-harmful/#comment-7079</guid>
		<description>One of the key points of a Wiki syntax is not that it's easier to create than HTML, rather that it's easier to read than HTML.  WYSIWYG solves both problems, of course, but it's important to remember that when saying HTML isn't that much harder to learn.  It's substantially harder to read, unless the author is being meticulous about layout and correct use of tags.

Also, it's worth noting that a Wiki syntax doesn't have anywhere close to the same level of complexity for preventing cross site scripting.  Simply escape the three evil characters anywhere they occur in the text, and you're done.  No need to worry about whether the user is trying to indicate that something is less than another thing or if they're trying to open an HTML element, or which tags and attributes are OK and which are not.  Again, a WYSIWYG editor can take care of this for you, I expect.

WYSIWYG editors have plenty of upsides, but the downside is, frankly, most of 'em suck to use.  Maybe the ones Ephox creates are better... but "This system does not meet the minimum requirements to run EditLive! for Java. Now using a textarea instead."  The fallback position for a WYSIWYG editor is generally substantially worse than any Wiki syntax, or even hand edited HTML, because generated HTML is rarely readable.</description>
		<content:encoded><![CDATA[<p>One of the key points of a Wiki syntax is not that it&#8217;s easier to create than HTML, rather that it&#8217;s easier to read than HTML.  WYSIWYG solves both problems, of course, but it&#8217;s important to remember that when saying HTML isn&#8217;t that much harder to learn.  It&#8217;s substantially harder to read, unless the author is being meticulous about layout and correct use of tags.</p>
<p>Also, it&#8217;s worth noting that a Wiki syntax doesn&#8217;t have anywhere close to the same level of complexity for preventing cross site scripting.  Simply escape the three evil characters anywhere they occur in the text, and you&#8217;re done.  No need to worry about whether the user is trying to indicate that something is less than another thing or if they&#8217;re trying to open an HTML element, or which tags and attributes are OK and which are not.  Again, a WYSIWYG editor can take care of this for you, I expect.</p>
<p>WYSIWYG editors have plenty of upsides, but the downside is, frankly, most of &#8216;em suck to use.  Maybe the ones Ephox creates are better&#8230; but &#8220;This system does not meet the minimum requirements to run EditLive! for Java. Now using a textarea instead.&#8221;  The fallback position for a WYSIWYG editor is generally substantially worse than any Wiki syntax, or even hand edited HTML, because generated HTML is rarely readable.</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: aj</title>
		<link>http://www.symphonious.net/2005/07/19/wiki-syntax-considered-harmful/#comment-7078</link>
		<dc:creator>aj</dc:creator>
		<pubDate>Tue, 19 Jul 2005 22:11:48 +0000</pubDate>
		<guid isPermaLink="false">http://www.symphonious.net/2005/07/19/wiki-syntax-considered-harmful/#comment-7078</guid>
		<description>Wow, that looks great!  I've been meaning to implement a better diff for our internal wiki for a while now so I may well base it off of the Daisy diff tools.  It could also be useful in our test scripts....

Thanks!</description>
		<content:encoded><![CDATA[<p>Wow, that looks great!  I&#8217;ve been meaning to implement a better diff for our internal wiki for a while now so I may well base it off of the Daisy diff tools.  It could also be useful in our test scripts&#8230;.</p>
<p>Thanks!</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Bruno Dumon</title>
		<link>http://www.symphonious.net/2005/07/19/wiki-syntax-considered-harmful/#comment-7077</link>
		<dc:creator>Bruno Dumon</dc:creator>
		<pubDate>Tue, 19 Jul 2005 12:34:19 +0000</pubDate>
		<guid isPermaLink="false">http://www.symphonious.net/2005/07/19/wiki-syntax-considered-harmful/#comment-7077</guid>
		<description>Can't resist to mention our (open-source) Daisy content management system (see http://cocoondev.org/daisy/index.html), in which we've also opted for HTML-editing since our target users include non-technical types (and besides, it's just much more comfortable). We're using the editors available in IE/Firefox since depending on commercial components isn't an option. These editors are not perfect but mostly good enough.

We solved the problem of text-based diffing using a custom (server-side) "HTML cleaner" component which gives a byte-for-byte equal result whether editing happend in IE or Firefox (the HTML these produce can be quite different) or as source. This includes doing things like switching to a new paragraph when encountering two br's etc. See for example here:
http://cocoondev.org/daisy/index/version/6/diff?otherVersion=7</description>
		<content:encoded><![CDATA[<p>Can&#8217;t resist to mention our (open-source) Daisy content management system (see <a href="http://cocoondev.org/daisy/index.html" rel="nofollow">http://cocoondev.org/daisy/index.html</a>), in which we&#8217;ve also opted for HTML-editing since our target users include non-technical types (and besides, it&#8217;s just much more comfortable). We&#8217;re using the editors available in IE/Firefox since depending on commercial components isn&#8217;t an option. These editors are not perfect but mostly good enough.</p>
<p>We solved the problem of text-based diffing using a custom (server-side) &#8220;HTML cleaner&#8221; component which gives a byte-for-byte equal result whether editing happend in IE or Firefox (the HTML these produce can be quite different) or as source. This includes doing things like switching to a new paragraph when encountering two br&#8217;s etc. See for example here:<br />
<a href="http://cocoondev.org/daisy/index/version/6/diff?otherVersion=7" rel="nofollow">http://cocoondev.org/daisy/index/version/6/diff?otherVersion=7</a></p>
]]></content:encoded>
	</item>
</channel>
</rss>
