<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>mattdorn.com &#187; markup</title>
	<atom:link href="http://www.mattdorn.com/content/tag/markup/feed/" rel="self" type="application/rss+xml" />
	<link>http://www.mattdorn.com</link>
	<description>Generously funded by Matt Dorn</description>
	<lastBuildDate>Sun, 07 Feb 2010 00:07:14 +0000</lastBuildDate>
	<generator>http://wordpress.org/?v=2.9</generator>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
			<item>
		<title>Kill Your Word Processor: Popularizing Lightweight Markup</title>
		<link>http://www.mattdorn.com/content/kill-your-word-processor-popularizing-lightweight-markup/</link>
		<comments>http://www.mattdorn.com/content/kill-your-word-processor-popularizing-lightweight-markup/#comments</comments>
		<pubDate>Thu, 22 Dec 2005 15:33:17 +0000</pubDate>
		<dc:creator>mdorn</dc:creator>
				<category><![CDATA[technology]]></category>
		<category><![CDATA[markup]]></category>
		<category><![CDATA[tools]]></category>

		<guid isPermaLink="false">http://67.207.132.145/wordpress/?p=25</guid>
		<description><![CDATA[


As a part of my tentatively titled Kill Your Word Processor project, I&#8217;ve been trying to think of ways to expand the audience for it, particularly because I&#8217;ve more than once been frustrated by collaborators&#8217; insistence on the use of clunky word processors and browser-based WYSIWYG editors which I&#8217;ve long since given up on.
I even [...]]]></description>
			<content:encoded><![CDATA[
<div class="document">
<!-- -*- mode: rst -*- -->
<p>As a part of my tentatively titled <a class="reference" href="/content/kill-your-word-processor">Kill Your Word Processor</a> project, I&#8217;ve been trying to think of ways to expand the audience for it, particularly because I&#8217;ve more than once been frustrated by collaborators&#8217; insistence on the use of clunky word processors and browser-based WYSIWYG editors which I&#8217;ve long since given up on.</p>
<p>I even posted a <a class="reference" href="http://backpackit.com/forum/viewtopic.php?id=1044">note</a> on the <a class="reference" href="http://backpackit.com/">Backpack</a> forum, where users have been exposed to the Textile lightweight markup syntax, trying to get others&#8217; opinions on the matter, but it seems I&#8217;m preaching to the choir over there.</p>
<p>I have, however, been encouraged by what appears to be an <a class="reference" href="/content/lightweight-markup-and-web-2.0">increased interest in lightweight markup</a> that seems to be part of a broader paradigm shift led by the spread of &quot;Web 2.0.&quot;</p>
<p>But ultimately tangible results will be the most effective means of persuasion&#8211;e.g., a beautifully formatted LaTeX document converted to PDF, and a crisp, clean Web page springing from the same source; a demonstration of the tools that make such results effortless, etc.  Still, I wanted to at least lay out some of the rational arguments here, hopefully with the end result of compiling a concise list of the benefits of the moving to lightweight markup.</p>
<p>There are at least two technologies that have preceded the current wave of interest in alternatives to bloated word processing software&#8211;one rooted in the requirements of collaboration on document composition, the other in the benefits of separating the production of content from its presentation.</p>
<p>Wikis emerged on the strength of their usefulness for collaboration on documents.  The limited utility of passing Word documents back and forth as attachments via email should be apparent to most by now to anyone with enough familiarity with the Internet to know that there are tools (e.g., Wikis) that make that technique unnecessary.  Among other benefits, most Wiki software packages have built-in versioning features as well as warning features to deal with simultaneous edits.</p>
<p>Wikis in fact sprang from the &quot;Extreme Programming&quot; (XP) community and from one of the guiding principles of that community: &quot;Use the simplest thing that could possibly work.&quot;  For that reason, Wikis did in fact incorporate and promote the concept of separation of content from presentation through the use of exactly the kind of simplified markup languages that are under discussion here.  From <a class="reference" href="http://c2.com/cgi/wiki?WhyDoesntWikiDoHtml">c2.com</a>, the site of the original Wiki:</p>
<blockquote>
Wiki&#8217;s emphasis is on content, not presentation. The simple markup rules make people focus on expressing their ideas, not making them pretty. Some people have found that working in this minimal medium improves their writing.</blockquote>
<p>Unfortunately, in many cases, more technically inclined users demanded the ability to include HTML formatting by typing angle brackets which make the raw input of a document difficult to read, while the less technically inclined demanded the inclusion of word processor-esque WYSIWYG editors.  The degree of accommodation of such requests varies from package to package, but clearly not all Wiki users were convinced of the benefits of simplified markup.  This may be because those markup languages were not particularly well thought-through.</p>
<p>The concept of separating content from presentation has a more venerable heritage, however: It&#8217;s embodied in the LaTeX typesetting system, which was derived from TeX, which in turn was developed by Donald Knuth in the 1970s.  Ubergeek protestations notwithstanding, composing a document in LaTeX&#8217;s own syntax is far more painful than composing in a word processor, but the content/presentation concept is firmly embedded here, as is the benefit of being able to compose in any text editor.</p>
<p><a class="reference" href="http://www.lyx.org/">LyX</a> is an editor that takes a lot of the pain out of composing LaTeX documents.  While I don&#8217;t consider it very useful for my purposes, its documentation does make some interesting points about the importance of content/presentation separation:</p>
<blockquote>
<p>Part of the initial challenge of using LyX comes from the change in thinking that you, the user, must make. At one time, all we had for creating documents were typewriters, so we all learned certain tricks to get around their limitations. Underlining, which is little more than overstriking with the &quot;_&quot; character, became a way to emphasize text. You were forced to figure out column sizes and tab stops, and set them, before creating a table. The same applied for letters and other right justified text. Hyphenation at the end of a line required a careful eye and a lot of foresight.</p>
<p>In other words, we&#8217;ve all been trained to worry about the little details of which character goes where. Consequently, almost all word processors have this mentality. They still use tab stops for adding whitespace. You still need to worry about exactly where on the page something will appear. Emphasizing text means changing a font, similar to changing the typewriter wheel. This is the underlying philosophy of a WYSIWYG word processor: &quot;What You See Is What You Get&quot;. Unfortunately, that paradigm often results in &quot;What You See Is All You Get&quot;.</p>
<p>This is where LyX differs from an ordinary word processor. You don&#8217;t concern yourself with what character goes where. You tell LyX what you&#8217;re doing and LyX takes care of the rest, following a set of rules called a style. &#8230;</p>
<p>So, the basic idea behind LyX is: specify what you&#8217;re doing, not how to do it. Instead of &quot;What You See Is What You Get,&quot; the LyX model is &quot;What You See Is What You Mean&quot; or &quot;WYSIWYM.&quot; It&#8217;s a powerful idea that greatly simplifies the mechanics of writing documents. This is also why LyX isn&#8217;t so good for creating posters and flyers&#8212;in this case, you do want to specify exactly where everything goes, because there are no functional units like paragraphs, sections, etc.</p>
</blockquote>
<p>(To be fair, most word processors do in fact have a similar &quot;style&quot; feature to help you concentrate more on the content and impose a uniform look on your documents, but almost nobody uses it, probably because the nature of the word processor discourages its use.)</p>
<p>In spite of the fact that LyX is an application and not a markup syntax, you could easily replace the word &quot;LyX&quot; in several parts of this passage with &quot;lightweight markup&quot; and gain a firmer understanding of the benefits of the approach I&#8217;m describing.  This passage is also interesting for indicating the circumstances under which this approach is not appropriate (e.g., posters and flyers).</p>
<p>Finally, in a recent thread on David Heinemeier Hansson&#8217;s site titled &quot;<a class="reference" href="http://www.loudthinking.com/arc/000295.html">Why do people still use word processors?</a>&quot;, Hansson responds to a challenge to his rhetorical question and makes us aware of the false dichotomy between &quot;technical&quot; and &quot;nontechnical&quot; users vis-a-vis the difficulty of using a lightweight markup like Textile:</p>
<blockquote>
<p><strong>Reader</strong>: &quot;People&quot; are generally not IT professionals. It&#8217;s hard enough for some to even understand the concept of a table. It&#8217;s very hard for quite a few to understand the simple concepts of HTML. LaTeX is harder still to learn and use. &#8230; Textile is a good start and leverages some users, but probably not my mother, anyone else in her generation, or a significant part of the entire private sector.</p>
<p><strong>Hansson</strong>: I was puzzled that students attending HA.dat (computer science and business administration) would suffer to Word when there were plenty of alternatives that didn&#8217;t require a bachelor&#8217;s degree in CS. &#8230; Your mother is excused, they were not.</p>
</blockquote>
<p>I.e., there&#8217;s no reason why lightweight markup shouldn&#8217;t be appealing at least to computer literate users, even if non-computer literate can&#8217;t reasonably be expected to live without the word processor&#8217;s conceptual link back to the pre-digital world of typewriters.</p>
</div>
]]></content:encoded>
			<wfw:commentRss>http://www.mattdorn.com/content/kill-your-word-processor-popularizing-lightweight-markup/feed/</wfw:commentRss>
		<slash:comments>1</slash:comments>
		</item>
		<item>
		<title>Lightweight markup and Web 2.0</title>
		<link>http://www.mattdorn.com/content/lightweight-markup-and-web-20/</link>
		<comments>http://www.mattdorn.com/content/lightweight-markup-and-web-20/#comments</comments>
		<pubDate>Thu, 22 Dec 2005 10:56:33 +0000</pubDate>
		<dc:creator>mdorn</dc:creator>
				<category><![CDATA[technology]]></category>
		<category><![CDATA[markup]]></category>
		<category><![CDATA[tools]]></category>
		<category><![CDATA[Web2.0]]></category>

		<guid isPermaLink="false">http://67.207.132.145/wordpress/?p=24</guid>
		<description><![CDATA[


In a lengthy post earlier this month, I took a first stab at describing a word processor-less approach to document composition and formatting.  A key component of that approach is the use of what has variously been referred to as &#34;humane text,&#34;  WYSIWYM (What You See Is What You Mean), and &#34;lightweight markup&#34;&#8211;formatting [...]]]></description>
			<content:encoded><![CDATA[
<div class="document">
<!-- -*- mode: rst -*- -->
<p>In a <a class="reference" href="http://www.mattdorn.com/content/kill-your-word-processor">lengthy post</a> earlier this month, I took a first stab at describing a word processor-less approach to document composition and formatting.  A key component of that approach is the use of what has variously been referred to as &quot;<a class="reference" href="http://bluebones.net/news/default.asp?action=view_story&amp;story_id=94">humane text</a>,&quot;  WYSIWYM (What You See Is What You Mean), and &quot;<a class="reference" href="http://docutils.sourceforge.net/rst.html">lightweight markup</a>&quot;&#8211;formatting syntax that allows you to compose a document&#8211;in a completely human-readable manner, without angle brackets&#8211;in plain text in any text editor, browser text field, or <a class="reference" href="http://www1.alphasmart.com/products/neo.html">device</a>, and run it through a parser to turn it into a format more suitable for your audience, such as HTML or PDF.</p>
<p>Searching the Web for those who have gone before me&#8211;particularly on the matter of convincing the technologically disinclined of the benefits of weaning themselves off of their dependency on Microsoft Word (or any other word processor or even browser-based WYSIWYG editor for that matter)&#8211;I began to discern the emergence of an eerie pattern: Interest in lightweight markup seems to correspond with the rise of the so-called <a class="reference" href="http://www.oreillynet.com/lpt/a/6228">Web 2.0</a> technologies.</p>
<p>First, I (re)discovered the existence of other lightweight markup languages besides the one I&#8217;m used to working with, <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a>; the principal ones are <a class="reference" href="http://daringfireball.net/projects/markdown/">Markdown</a> and <a class="reference" href="http://textism.com/tools/textile/">Textile</a>.  (I should note here that various Wiki software packages have long provided their own markup formats.)  Later, I learned that Textile (or some variation of it) is used as the default formatting syntax for <a class="reference" href="http://37signals.com/">37signals</a>&#8216; excellent personal information management tool, <a class="reference" href="http://backpackit.com/">Backpack</a>.  37signals had previously created the <a class="reference" href="http://basecamphq.com/">application</a> that made <a class="reference" href="http://rubyonrails.org/">Ruby on Rails</a> famous, and in fact employ the creator of this Web framework, <a class="reference" href="http://www.loudthinking.com/">David Heinemeier Hansson</a>.  Ruby on Rails&#8217; exploitation of the <a class="reference" href="http://www.adaptivepath.com/publications/essays/archives/000385.php">Ajax</a> technologies in large measure has marked it as a kind of technological standard bearer of Web 2.0, as suggested by the first product offering from <a class="reference" href="http://www.adaptivepath.com/">Adaptive Path</a> (a key promoter of the Web 2.0 idea), <a class="reference" href="http://www.measuremap.com/">Measure Map</a>, also created on Ruby on Rails.</p>
<p>As if that weren&#8217;t enough, the other major lightweight syntax project, Markdown, was created by Mac-oriented blogger John Gruber, who is employed by <a class="reference" href="http://www.joyent.com/">Joyent</a>, a company whose work appears heavily to leverage Ruby on Rails and Ajax, and which had previously acquired <a class="reference" href="http://www.textdrive.com/">TextDrive</a>, the company whose founder is responsible for Textile.  The circle seems complete.</p>
<p>So where does lightweight markup fit into Web 2.0 conceptually speaking?  It might be worth explaining what I mean by Web 2.0, since there seems to be no commonly accepted definition of this relatively new industry buzzword.  One intriguing definition I came across (I forget where): &quot;Web applications that don&#8217;t suck.&quot;  For those inclined to a more formal explanation, I recommend Tim O&#8217;Reilly&#8217;s (his company coined the phrase) <a class="reference" href="http://www.oreillynet.com/lpt/a/6228">treatment</a> of it, as well as Paul Graham&#8217;s <a class="reference" href="http://www.paulgraham.com/web20.html">reflections</a> (though in light of the present topic, I can&#8217;t help but think that his suggestion to create a Web-based version of Microsoft Office is misguided).</p>
<p>Aside from noting that it was made possible in part by the mainstreaming of broadband Internet access (Ajax-laden applications tend to take a long time to load otherwise), maybe the best way to gain an understanding is to list a few of the more prominent examples:</p>
<ul class="simple">
<li><a class="reference" href="http://maps.google.com/">Google Maps</a>, but especially the so-called &quot;mashups&quot; like chicagocrime.org and housingmaps.com, which use the Google Maps open API map data from a third source onto Google Maps&#8217; super-responsive, desktop app-like interface, which popularized Ajax overnight</li>
<li><a class="reference" href="http://del.icio.us/">del.icio.us</a>, the &quot;social bookmarks&quot; manager, which aggregates the &quot;tags&quot; that users apply to their favorite sites and makes the results of that tagging available to all other users, allowing them to take advantage of the network effects that redound as a result of mass use of the site.</li>
<li><a class="reference" href="http://www.wikipedia.org/">Wikipedia</a>, the collaborative encyclopedia, which until recently was open to editing by all Internet users, even without requiring registration of a username.  As Graham notes, &quot;experts have given Wikipedia middling reviews, but they miss the critical point: it&#8217;s good enough.&quot;</li>
</ul>
<p>One of the common threads of these applications is their embrace of openness.  In many cases this means using Open Source software and participating in Open Source projects, in recognition of the effectiveness of that approach in creating quality software in a short period of time.  But perhaps more importantly it means open standards, including Web standards like XHTML and CSS, as well various XML dialects for sharing data between applications via Web services.</p>
<p>It is probably this fundamental quality of openness which has motivated the interest in lightweight markup among the Web 2.0 cognoscenti.  Plain text is among the most platform-neutral technologies imaginable, requiring no special software to use, no special browser plugins, very minimal hardware requirements.  It&#8217;s agile; when used with appropriate parsers, input can be repurposed for any number of uses, &quot;decoupling&quot; it, so to speak, from dependency on any particular application, just as Web 2.0 technologies tend to do with their functionality.</p>
</div>
]]></content:encoded>
			<wfw:commentRss>http://www.mattdorn.com/content/lightweight-markup-and-web-20/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
	</channel>
</rss>
