bluecloth 2.0.0

data/spec/bluecloth/101_changes_spec.rb

@@ -0,0 +1,141 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+BEGIN {
+	require 'pathname'
+	basedir = Pathname.new( __FILE__ ).dirname.parent.parent
+	
+	libdir = basedir + 'lib'
+	extdir = basedir + 'ext'
+	
+	$LOAD_PATH.unshift( libdir ) unless $LOAD_PATH.include?( libdir )
+	$LOAD_PATH.unshift( extdir ) unless $LOAD_PATH.include?( extdir )
+}
+
+require 'spec'
+require 'bluecloth'
+
+require 'spec/lib/helpers'
+require 'spec/lib/constants'
+require 'spec/lib/matchers'
+
+
+#####################################################################
+###	C O N T E X T S
+#####################################################################
+
+describe BlueCloth, "1.0.1 changes" do
+	include BlueCloth::TestConstants,
+	        BlueCloth::Matchers
+
+	it "doesn't touch escapes in code blocks" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		Markdown allows you to use backslash escapes to generate literal
+		characters which would otherwise have special meaning in Markdown's
+		formatting syntax. For example, if you wanted to surround a word with
+		literal asterisks (instead of an HTML `<em>` tag), you can backslashes
+		before the asterisks, like this:
+		
+			\\*literal asterisks\\*
+		
+		---
+		<p>Markdown allows you to use backslash escapes to generate literal
+		characters which would otherwise have special meaning in Markdown's
+		formatting syntax. For example, if you wanted to surround a word with
+		literal asterisks (instead of an HTML <code>&lt;em&gt;</code> tag), you can backslashes
+		before the asterisks, like this:</p>
+		
+		<pre><code>\\*literal asterisks\\*
+		</code></pre>
+		---
+	end
+
+	it "shouldn't touched escapes in code spans" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		You can escape the splat operator by backslashing it like this: `/foo\\*/`.
+		---
+		<p>You can escape the splat operator by backslashing it like this: <code>/foo\\*/</code>.</p>
+		---
+	end
+
+
+	it "converts reference-style links at or deeper than tab width to code blocks" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		An [example][ex] reference-style link.
+		
+			[ex]: http://www.bluefi.com/
+		---
+		<p>An [example][ex] reference-style link.</p>
+		
+		<pre><code>[ex]: http://www.bluefi.com/
+		</code></pre>
+		---
+	end
+
+	it "fixes inline links using < and > URL delimiters, which weren't working" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		like [this](<http://example.com/>)
+		---
+		<p>like <a href="http://example.com/">this</a></p>
+		---
+	end
+
+	it "keeps HTML comment blocks as-is" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		<!-- This is a comment -->
+		---
+		<!-- This is a comment -->
+		---
+	end
+
+	it "doesn't auto-link inside code spans" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		like this: `<http://example.com/>`
+		---
+		<p>like this: <code>&lt;http://example.com/&gt;</code></p>
+		---
+	end
+
+
+	it "no longer creates a list when lines in the middle of hard-wrapped paragraphs look " +
+	   "like the start of a list item" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		I recommend upgrading to version
+		8. Oops, now this line is treated
+		as a sub-list.
+		---
+		<p>I recommend upgrading to version
+		8. Oops, now this line is treated
+		as a sub-list.</p>
+		---
+	end
+
+
+	it "correctly marks up header + list + code" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		## This is a header.
+		
+		1.   This is the first list item.
+		2.   This is the second list item.
+		
+		Here's some example code:
+		
+			return shell_exec("echo $input | $markdown_script");
+		---
+		<h2>This is a header.</h2>
+		
+		<ol>
+		<li>This is the first list item.</li>
+		<li>This is the second list item.</li>
+		</ol>
+		
+		<p>Here's some example code:</p>
+		
+		<pre><code>return shell_exec("echo $input | $markdown_script");
+		</code></pre>
+		---
+	end
+
+end
+
+

data/spec/bluecloth/autolinks_spec.rb

@@ -0,0 +1,49 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+BEGIN {
+	require 'pathname'
+	basedir = Pathname.new( __FILE__ ).dirname.parent.parent
+	
+	libdir = basedir + 'lib'
+	extdir = basedir + 'ext'
+	
+	$LOAD_PATH.unshift( libdir ) unless $LOAD_PATH.include?( libdir )
+	$LOAD_PATH.unshift( extdir ) unless $LOAD_PATH.include?( extdir )
+}
+
+require 'spec'
+require 'bluecloth'
+
+require 'spec/lib/helpers'
+require 'spec/lib/constants'
+require 'spec/lib/matchers'
+
+
+#####################################################################
+###	C O N T E X T S
+#####################################################################
+
+describe BlueCloth, "auto-links" do
+	include BlueCloth::TestConstants,
+	        BlueCloth::Matchers
+
+	it "supports HTTP auto-links" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		This is a reference to <http://www.FaerieMUD.org/>. You should follow it.
+		---
+		<p>This is a reference to <a href="http://www.FaerieMUD.org/">http://www.FaerieMUD.org/</a>. You should follow it.</p>
+		---
+	end
+
+	it "supports FTP auto-link" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		Why not download your very own chandelier from <ftp://ftp.usuc.edu/pub/foof/mir/>?
+		---
+		<p>Why not download your very own chandelier from <a href="ftp://ftp.usuc.edu/pub/foof/mir/">ftp://ftp.usuc.edu/pub/foof/mir/</a>?</p>
+		---
+	end
+
+end
+
+

data/spec/bluecloth/blockquotes_spec.rb

@@ -0,0 +1,143 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+BEGIN {
+	require 'pathname'
+	basedir = Pathname.new( __FILE__ ).dirname.parent.parent
+	
+	libdir = basedir + 'lib'
+	extdir = basedir + 'ext'
+	
+	$LOAD_PATH.unshift( libdir ) unless $LOAD_PATH.include?( libdir )
+	$LOAD_PATH.unshift( extdir ) unless $LOAD_PATH.include?( extdir )
+}
+
+require 'spec'
+require 'bluecloth'
+
+require 'spec/lib/helpers'
+require 'spec/lib/constants'
+require 'spec/lib/matchers'
+
+
+#####################################################################
+###	C O N T E X T S
+#####################################################################
+
+describe BlueCloth, "blockquotes" do
+	include BlueCloth::TestConstants,
+	        BlueCloth::Matchers
+
+	### [Blockquotes]
+
+	# Regular 1-level blockquotes
+	it "wraps sections with an angle-bracket left margin in a blockquote" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		> Email-style angle brackets
+		> are used for blockquotes.
+		---
+		<blockquote><p>Email-style angle brackets
+		are used for blockquotes.</p></blockquote>
+		---
+	end
+
+	# Nested blockquotes
+	it "supports nested blockquote sections" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		> Email-style angle brackets
+		> are used for blockquotes.
+
+		> > And, they can be nested.
+		---
+		<blockquote><p>Email-style angle brackets
+		are used for blockquotes.</p>
+
+		<blockquote><p>And, they can be nested.</p></blockquote></blockquote>
+		---
+	end
+
+	# Doubled blockquotes
+	it "supports nested blockquote sections even if there's only one multi-level section" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		> > And, they can be nested.
+		---
+		<blockquote><blockquote><p>And, they can be nested.</p></blockquote></blockquote>
+		---
+	end
+
+	# Lazy blockquotes
+	it "wraps sections preceded by an angle-bracket in a blockquote" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
+		consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
+		Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
+		
+		> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
+		id sem consectetuer libero luctus adipiscing.
+		---
+		<blockquote><p>This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
+		consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
+		Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.</p>
+		
+		<p>Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
+		id sem consectetuer libero luctus adipiscing.</p></blockquote>
+		---
+	end
+
+
+	# Blockquotes containing other markdown elements
+	it "supports other Markdown elements in blockquote sections" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		> ## This is a header.
+		> 
+		> 1.   This is the first list item.
+		> 2.   This is the second list item.
+		> 
+		> Here's some example code:
+		> 
+		>     return shell_exec("echo $input | $markdown_script");
+		---
+		<blockquote><h2>This is a header.</h2>
+		
+		<ol>
+		<li>This is the first list item.</li>
+		<li>This is the second list item.</li>
+		</ol>
+		
+		<p>Here's some example code:</p>
+		
+		<pre><code>return shell_exec("echo $input | $markdown_script");
+		</code></pre></blockquote>
+		---
+	end
+
+	# Blockquotes with a <pre> section
+	it "supports block-level HTML inside of blockquotes" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		> The best approximation of the problem is the following code:
+		>
+		> <pre>
+		> foo + bar; foo.factorize; foo.display
+		> </pre>
+		> 
+		> This should result in an error on any little-endian platform.
+		> 
+		> <div>- Garrick Mettronne</div>
+		---
+		<blockquote><p>The best approximation of the problem is the following code:</p>
+		
+		<pre>
+		foo + bar; foo.factorize; foo.display
+		</pre>
+		
+		<p>This should result in an error on any little-endian platform.</p>
+		
+		<div>- Garrick Mettronne</div>
+		</blockquote>
+		---
+	end
+
+
+end
+
+

data/spec/bluecloth/code_spans_spec.rb

@@ -0,0 +1,164 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+BEGIN {
+	require 'pathname'
+	basedir = Pathname.new( __FILE__ ).dirname.parent.parent
+	
+	libdir = basedir + 'lib'
+	extdir = basedir + 'ext'
+	
+	$LOAD_PATH.unshift( libdir ) unless $LOAD_PATH.include?( libdir )
+	$LOAD_PATH.unshift( extdir ) unless $LOAD_PATH.include?( extdir )
+}
+
+require 'spec'
+require 'bluecloth'
+
+require 'spec/lib/helpers'
+require 'spec/lib/constants'
+require 'spec/lib/matchers'
+
+
+#####################################################################
+###	C O N T E X T S
+#####################################################################
+
+describe BlueCloth, "that contains code blocks or spans" do
+	include BlueCloth::TestConstants,
+	        BlueCloth::Matchers
+
+	it "wraps CODE tags around backticked spans" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		Making `code` work for you
+		---
+		<p>Making <code>code</code> work for you</p>
+		---
+	end
+
+	it "allows you to place literal backtick characters at the beginning or end of a code span " +
+	   "by padding the inner string with spaces" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		Making `` `code` `` work for you
+		---
+		<p>Making <code>`code`</code> work for you</p>
+		---
+	end
+
+	it "wraps CODE tags around doubled backtick spans with a single literal backtick inside them" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		``There is a literal backtick (`) here.``
+		---
+		<p><code>There is a literal backtick (`) here.</code></p>
+		---
+	end
+
+	it "correctly transforms two literal spans in one line" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		This `thing` should be `two` spans.
+		---
+		<p>This <code>thing</code> should be <code>two</code> spans.</p>
+		---
+	end
+
+	it "correctly transforms literal spans at the beginning of a line" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		I should think that the
+		`tar` command would be universal.
+		---
+		<p>I should think that the
+		<code>tar</code> command would be universal.</p>
+		---
+	end
+
+	it "encodes ampersands and angle brackets within code spans as HTML entities" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		The left angle-bracket (`&lt;`) can also be written as a decimal-encoded
+		(`&#060;`) or hex-encoded (`&#x3c;`) entity. This
+		also works with `<div>` elements.
+		---
+		<p>The left angle-bracket (<code>&amp;lt;</code>) can also be written as a decimal-encoded
+		(<code>&amp;#060;</code>) or hex-encoded (<code>&amp;#x3c;</code>) entity. This
+		also works with <code>&lt;div&gt;</code> elements.</p>
+		---
+	end
+
+	# At the beginning of a document (Bug #525)
+	it "correctly transforms code spans at the beginning of paragraphs (bug #525)" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		`world` views
+		---
+		<p><code>world</code> views</p>
+		---
+	end
+
+
+
+
+	### [Code blocks]
+
+	# Para plus code block (literal tab, no colon)
+	it "wraps sections indented with a literal tab in a code block" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		This is a chunk of code
+
+			some.code > some.other_code
+
+		Some stuff.
+		---
+		<p>This is a chunk of code</p>
+
+		<pre><code>some.code &gt; some.other_code
+		</code></pre>
+
+		<p>Some stuff.</p>
+		---
+	end
+
+	# Para plus code block (tab-width spaces)
+	it "wraps sections indented with at least 4 spaces in a code block" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		This is a chunk of code:
+
+		    some.code > some.other_code
+
+		Some stuff.
+		---
+		<p>This is a chunk of code:</p>
+
+		<pre><code>some.code &gt; some.other_code
+		</code></pre>
+
+		<p>Some stuff.</p>
+		---
+	end
+
+	# Preserve leading whitespace (Bug #541)
+	it "removes one level of indentation (and no more) from code blocks" do
+		the_indented_markdown( <<-"---" ).should be_transformed_into(<<-"---").without_indentation
+		Examples:
+
+		          # (Waste character because first line is flush left !!!)
+		          # Example script1
+		          x = 1
+		          x += 1
+		          puts x
+
+		Some stuff.
+		---
+		<p>Examples:</p>
+
+		<pre><code>      # (Waste character because first line is flush left !!!)
+		      # Example script1
+		      x = 1
+		      x += 1
+		      puts x
+		</code></pre>
+
+		<p>Some stuff.</p>
+		---
+	end
+
+end
+
+