asciidoctor 0.0.7 → 0.0.9

data/test/document_test.rb

@@ -1,36 +1,233 @@
 require 'test_helper'
 
-class DocumentTest < Test::Unit::TestCase
-  # setup for test
-  def setup
-    @doc = example_document(:asciidoc_index)
+context 'Document' do
+
+  context 'Example document' do
+    test 'test_title' do
+      doc = example_document(:asciidoc_index)
+      assert_equal 'AsciiDoc Home Page', doc.doctitle
+      assert_equal 'AsciiDoc Home Page', doc.name
+      assert_equal 14, doc.blocks.size
+      assert_equal :preamble, doc.blocks[0].context
+      assert doc.blocks[1].is_a? ::Asciidoctor::Section
+    end
   end
 
-  def test_title
-    assert_equal "AsciiDoc Home Page", @doc.doctitle
-    assert_equal 14, @doc.elements.size
-    assert_equal :preamble, @doc.elements[0].context
-    assert @doc.elements[1].is_a? ::Asciidoctor::Section
+  context 'Default settings' do
+    test 'safe mode level set to SECURE by default' do
+      doc = Asciidoctor::Document.new
+      assert_equal Asciidoctor::SafeMode::SECURE, doc.safe
+    end
+
+    test 'safe mode level can be set in the constructor' do
+      doc = Asciidoctor::Document.new [], :safe => Asciidoctor::SafeMode::SAFE
+      assert_equal Asciidoctor::SafeMode::SAFE, doc.safe
+    end
+
+    test 'safe model level cannot be modified' do
+      doc = Asciidoctor::Document.new
+      begin
+        doc.safe = Asciidoctor::SafeMode::UNSAFE
+        flunk 'safe mode property of Asciidoctor::Document should not be writable!' 
+      rescue
+      end
+    end
   end
 
-  def test_with_no_title
-    d = Asciidoctor::Document.new(["Snorf"])
-    assert_nil d.doctitle
+  context 'Renderer' do
+    test 'built-in HTML5 views are registered by default' do
+      doc = document_from_string ''
+      assert_equal 'html5', doc.attributes['backend']
+      assert doc.attributes.has_key? 'backend-html5'
+      assert_equal 'html', doc.attributes['basebackend']
+      assert doc.attributes.has_key? 'basebackend-html'
+      renderer = doc.renderer
+      assert !renderer.nil?
+      views = renderer.views
+      assert !views.nil?
+      assert_equal 26, views.size
+      assert views.has_key? 'document'
+      assert views['document'].is_a?(Asciidoctor::HTML5::DocumentTemplate)
+      assert_equal 'ERB', views['document'].eruby.to_s
+    end
+
+    test 'built-in DocBook45 views are registered when backend is docbook45' do
+      doc = document_from_string '', :attributes => {'backend' => 'docbook45'}
+      renderer = doc.renderer
+      assert_equal 'docbook45', doc.attributes['backend']
+      assert doc.attributes.has_key? 'backend-docbook45'
+      assert_equal 'docbook', doc.attributes['basebackend']
+      assert doc.attributes.has_key? 'basebackend-docbook'
+      assert !renderer.nil?
+      views = renderer.views
+      assert !views.nil?
+      assert_equal 26, views.size
+      assert views.has_key? 'document'
+      assert views['document'].is_a?(Asciidoctor::DocBook45::DocumentTemplate)
+      assert_equal 'ERB', views['document'].eruby.to_s
+    end
+  
+    test 'can set erubis as eRuby implementation' do
+      doc = Asciidoctor::Document.new [], :eruby => 'erubis' 
+      assert $LOADED_FEATURES.detect {|p| p == 'erubis.rb' || p.end_with?('/erubis.rb') }.nil?
+      renderer = doc.renderer
+      assert $LOADED_FEATURES.detect {|p| p == 'erubis.rb' || p.end_with?('/erubis.rb') }
+      views = renderer.views
+      assert !views.nil?
+      assert views.has_key? 'document'
+      assert_equal 'Erubis::FastEruby', views['document'].eruby.to_s
+      assert_equal 'Erubis::FastEruby', views['document'].template.class.to_s
+    end
   end
 
-  def test_with_header_footer
-    result = render_string("= Title\n\npreamble")
-    assert_xpath '/html', result, 1
-    assert_xpath '//*[@id="header"]', result, 1
-    assert_xpath '//*[@id="footer"]', result, 1
-    assert_xpath '//*[@id="preamble"]', result, 1
+  context 'Structure' do
+    test 'test_with_no_title' do
+      doc = document_from_string('Snorf')
+      assert_nil doc.doctitle
+      assert_nil doc.name
+      assert !doc.has_header?
+      assert_nil doc.header
+    end
+
+    test 'test_with_explicit_title' do
+     input = <<-EOS
+= Title
+:title: Document Title
+
+preamble
+
+== First Section
+     EOS
+     doc = document_from_string input
+     assert_equal 'Document Title', doc.doctitle
+     assert_equal 'Document Title', doc.title
+     assert doc.has_header?
+     assert_equal 'Title', doc.header.title
+     assert_equal 'Title', doc.first_section.title
+    end
+
+    test 'test_empty_document' do
+      doc = document_from_string('')
+      assert doc.blocks.empty?
+      assert_nil doc.doctitle
+      assert !doc.has_header?
+      assert_nil doc.header
+    end
+
+    test 'test_with_metadata' do
+      input = <<-EOS
+= AsciiDoc
+Stuart Rackham <founder@asciidoc.org>
+v8.6.8, 2012-07-12: See changelog.
+
+== Version 8.6.8
+
+more info...
+      EOS
+      output = render_string input
+      assert_xpath '//*[@id="header"]/span[@id="author"][text() = "Stuart Rackham"]', output, 1
+      assert_xpath '//*[@id="header"]/span[@id="email"][contains(text(), "founder@asciidoc.org")]', output, 1
+      assert_xpath '//*[@id="header"]/span[@id="revnumber"][text() = "version 8.6.8,"]', output, 1
+      assert_xpath '//*[@id="header"]/span[@id="revdate"][text() = "2012-07-12"]', output, 1
+      assert_xpath '//*[@id="header"]/span[@id="revremark"][text() = "See changelog."]', output, 1
+    end
+
+    test 'test_with_header_footer' do
+      result = render_string("= Title\n\npreamble")
+      assert_xpath '/html', result, 1
+      assert_xpath '//*[@id="header"]', result, 1
+      assert_xpath '//*[@id="footer"]', result, 1
+      assert_xpath '//*[@id="preamble"]', result, 1
+    end
+
+    test 'test_with_no_header_footer' do
+      result = render_string("= Title\n\npreamble", :header_footer => false)
+      assert_xpath '/html', result, 0
+      assert_xpath '/*[@id="header"]', result, 0
+      assert_xpath '/*[@id="footer"]', result, 0
+      assert_xpath '/*[@id="preamble"]', result, 1
+    end
   end
 
-  def test_with_no_header_footer
-    result = render_string("= Title\n\npreamble", :header_footer => false)
-    assert_xpath '/html', result, 0
-    assert_xpath '/*[@id="header"]', result, 0
-    assert_xpath '/*[@id="footer"]', result, 0
-    assert_xpath '/*[@id="preamble"]', result, 1
+  context 'Backends and Doctypes' do 
+    test 'test_html5_backend_doctype_article' do
+      result = render_string("= Title\n\npreamble", :attributes => {'backend' => 'html5'})
+      assert_xpath '/html', result, 1
+      assert_xpath '/html/body[@class="article"]', result, 1
+      assert_xpath '/html//*[@id="header"]/h1[text() = "Title"]', result, 1
+      assert_xpath '/html//*[@id="preamble"]//p[text() = "preamble"]', result, 1
+    end
+
+    test 'test_html5_backend_doctype_book' do
+      result = render_string("= Title\n\npreamble", :attributes => {'backend' => 'html5', 'doctype' => 'book'})
+      assert_xpath '/html', result, 1
+      assert_xpath '/html/body[@class="book"]', result, 1
+      assert_xpath '/html//*[@id="header"]/h1[text() = "Title"]', result, 1
+      assert_xpath '/html//*[@id="preamble"]//p[text() = "preamble"]', result, 1
+    end
+
+    test 'test_docbook45_backend_doctype_article' do
+      input = <<-EOS
+= Title
+
+preamble
+
+== First Section
+
+section body
+      EOS
+      result = render_string(input, :attributes => {'backend' => 'docbook45'})
+      assert_xpath '/article', result, 1
+      assert_xpath '/article/articleinfo/title[text() = "Title"]', result, 1
+      assert_xpath '/article/simpara[text() = "preamble"]', result, 1
+      assert_xpath '/article/section', result, 1
+      assert_xpath '/article/section[@id = "_first_section"]/title[text() = "First Section"]', result, 1
+      assert_xpath '/article/section[@id = "_first_section"]/simpara[text() = "section body"]', result, 1
+    end
+
+    test 'test_docbook45_backend_doctype_article_no_title' do
+      result = render_string('text', :attributes => {'backend' => 'docbook45'})
+      assert_xpath '/article', result, 1
+      assert_xpath '/article/articleinfo/date', result, 1
+      assert_xpath '/article/simpara[text() = "text"]', result, 1
+    end
+
+    test 'test_docbook45_backend_doctype_book' do
+      input = <<-EOS
+= Title
+
+preamble
+
+== First Chapter
+
+chapter body
+      EOS
+      result = render_string(input, :attributes => {'backend' => 'docbook45', 'doctype' => 'book'})
+      assert_xpath '/book', result, 1
+      assert_xpath '/book/bookinfo/title[text() = "Title"]', result, 1
+      assert_xpath '/book/preface/simpara[text() = "preamble"]', result, 1
+      assert_xpath '/book/chapter', result, 1
+      assert_xpath '/book/chapter[@id = "_first_chapter"]/title[text() = "First Chapter"]', result, 1
+      assert_xpath '/book/chapter[@id = "_first_chapter"]/simpara[text() = "chapter body"]', result, 1
+    end
+
+    test 'test_docbook45_backend_doctype_book_no_title' do
+      result = render_string('text', :attributes => {'backend' => 'docbook45', 'doctype' => 'book'})
+      assert_xpath '/book', result, 1
+      assert_xpath '/book/bookinfo/date', result, 1
+      assert_xpath '/book/simpara[text() = "text"]', result, 1
+    end
+
+    test 'do not override explicit author initials' do
+      input = <<-EOS
+= AsciiDoc
+Stuart Rackham <founder@asciidoc.org>
+:Author Initials: SJR
+
+more info...
+      EOS
+      output = render_string input, :attributes => {'backend' => 'docbook45'}
+      assert_xpath '/article/articleinfo/authorinitials[text()="SJR"]', output, 1
+    end
   end
 end

data/test/fixtures/encoding.asciidoc

@@ -0,0 +1 @@
+Gregory Romé has written an AsciiDoc plugin for the Redmine project management application.

data/test/fixtures/include-file.asciidoc

@@ -0,0 +1 @@
+included content

data/test/headers_test.rb

@@ -1,47 +1,119 @@
+# encoding: UTF-8
 require 'test_helper'
 
-context "Headers" do
-  test "document title with multiline syntax" do
-    title = "My Title"
-    chars = "=" * title.length
-    assert_xpath "//h1[not(@id)][text() = 'My Title']", render_string(title + "\n" + chars)
-    assert_xpath "//h1[not(@id)][text() = 'My Title']", render_string(title + "\n" + chars + "\n")
-  end
+context 'Sections' do
+  context 'Ids' do
+    test 'synthetic id is generated by default' do
+      sec = block_from_string('== Section One')
+      assert_equal '_section_one', sec.id
+    end
 
-  test "document title with multiline syntax, give a char" do
-    title = "My Title"
-    chars = "=" * (title.length + 1)
-    assert_xpath "//h1[not(@id)][text() = 'My Title']", render_string(title + "\n" + chars)
-    assert_xpath "//h1[not(@id)][text() = 'My Title']", render_string(title + "\n" + chars + "\n")
-  end
+    test 'synthetic id replaces non-word characters with underscores' do
+      sec = block_from_string("== We're back!")
+      assert_equal '_we_re_back', sec.id
+    end
 
-  test "document title with multiline syntax, take a char" do
-    title = "My Title"
-    chars = "=" * (title.length - 1)
-    assert_xpath "//h1[not(@id)][text() = 'My Title']", render_string(title + "\n" + chars)
-    assert_xpath "//h1[not(@id)][text() = 'My Title']", render_string(title + "\n" + chars + "\n")
-  end
+    test 'synthetic id removes repeating underscores' do
+      sec = block_from_string('== Section $ One')
+      assert_equal '_section_one', sec.id
+    end
 
-  test "not enough chars for a multiline document title" do
-    title = "My Title"
-    chars = "=" * (title.length - 2)
-    assert_xpath '//h1', render_string(title + "\n" + chars), 0
-    assert_xpath '//h1', render_string(title + "\n" + chars + "\n"), 0
-  end
+    test 'synthetic id prefix can be customized' do
+      sec = block_from_string(":idprefix: id_\n\n== Section One")
+      assert_equal 'id_section_one', sec.id
+    end
 
-  test "too many chars for a multiline document title" do
-    title = "My Title"
-    chars = "=" * (title.length + 2)
-    assert_xpath '//h1', render_string(title + "\n" + chars), 0
-    assert_xpath '//h1', render_string(title + "\n" + chars + "\n"), 0
-  end
+    test 'synthetic id prefix can be set to blank' do
+      sec = block_from_string(":idprefix:\n\n== Section One")
+      assert_equal 'section_one', sec.id
+    end
+
+    test 'synthetic ids can be disabled' do
+      sec = block_from_string(":sectids!:\n\n== Section One\n")
+      assert sec.id.nil?
+    end
+
+    test 'explicit id in anchor above section title overrides synthetic id' do
+      sec = block_from_string("[[one]]\n== Section One")
+      assert_equal 'one', sec.id
+    end
+
+    test 'explicit id can be defined using an inline anchor' do
+      sec = block_from_string("== Section One [[one]] ==")
+      assert_equal 'one', sec.id
+      assert_equal 'Section One', sec.title
+    end
 
-  test "document title with single-line syntax" do
-    assert_xpath "//h1[not(@id)][text() = 'My Title']", render_string("= My Title")
+    test 'title substitutions are applied before generating id' do
+      sec = block_from_string("== Section{sp}One\n")
+      assert_equal '_section_one', sec.id
+    end
+
+    test 'synthetic ids are unique' do
+      input = <<-EOS
+== Some section
+
+text
+
+== Some section
+
+text
+      EOS
+      doc = document_from_string input
+      assert_equal '_some_section', doc.blocks[0].id
+      assert_equal '_some_section_2', doc.blocks[1].id
+    end
   end
 
-  test "document title with symmetric syntax" do
-    assert_xpath "//h1[not(@id)][text() = 'My Title']", render_string("= My Title =")
+  context "document title (level 0)" do
+    test "document title with multiline syntax" do
+      title = "My Title"
+      chars = "=" * title.length
+      assert_xpath "//h1[not(@id)][text() = 'My Title']", render_string(title + "\n" + chars)
+      assert_xpath "//h1[not(@id)][text() = 'My Title']", render_string(title + "\n" + chars + "\n")
+    end
+
+    test "document title with multiline syntax, give a char" do
+      title = "My Title"
+      chars = "=" * (title.length + 1)
+      assert_xpath "//h1[not(@id)][text() = 'My Title']", render_string(title + "\n" + chars)
+      assert_xpath "//h1[not(@id)][text() = 'My Title']", render_string(title + "\n" + chars + "\n")
+    end
+
+    test "document title with multiline syntax, take a char" do
+      title = "My Title"
+      chars = "=" * (title.length - 1)
+      assert_xpath "//h1[not(@id)][text() = 'My Title']", render_string(title + "\n" + chars)
+      assert_xpath "//h1[not(@id)][text() = 'My Title']", render_string(title + "\n" + chars + "\n")
+    end
+
+    test "not enough chars for a multiline document title" do
+      title = "My Title"
+      chars = "=" * (title.length - 2)
+      assert_xpath '//h1', render_string(title + "\n" + chars), 0
+      assert_xpath '//h1', render_string(title + "\n" + chars + "\n"), 0
+    end
+
+    test "too many chars for a multiline document title" do
+      title = "My Title"
+      chars = "=" * (title.length + 2)
+      assert_xpath '//h1', render_string(title + "\n" + chars), 0
+      assert_xpath '//h1', render_string(title + "\n" + chars + "\n"), 0
+    end
+
+    test "document title with multiline syntax cannot begin with a dot" do
+      title = ".My Title"
+      chars = "=" * title.length
+      assert_xpath '//h1', render_string(title + "\n" + chars), 0
+    end
+
+    test "document title with single-line syntax" do
+      assert_xpath "//h1[not(@id)][text() = 'My Title']", render_string("= My Title")
+    end
+
+    test "document title with symmetric syntax" do
+      assert_xpath "//h1[not(@id)][text() = 'My Title']", render_string("= My Title =")
+    end
   end
 
   context "level 1" do 
@@ -49,6 +121,12 @@ context "Headers" do
       assert_xpath "//h2[@id='_my_section'][text() = 'My Section']", render_string("My Section\n-----------")
     end
 
+    test "heading title with multiline syntax cannot begin with a dot" do
+      title = ".My Title"
+      chars = "-" * title.length
+      assert_xpath '//h2', render_string(title + "\n" + chars), 0
+    end
+
     test "with single-line syntax" do
       assert_xpath "//h2[@id='_my_title'][text() = 'My Title']", render_string("== My Title")
     end
@@ -62,7 +140,7 @@ context "Headers" do
     end
 
     test "with non-word character" do
-      assert_xpath "//h2[@id='_where_s_the_love'][text() = \"Where's the love?\"]", render_string("== Where's the love?")
+      assert_xpath "//h2[@id='_where_s_the_love'][text() = \"Where#{[8217].pack('U*')}s the love?\"]", render_string("== Where's the love?")
     end
 
     test "with sequential non-word characters" do
@@ -80,35 +158,325 @@ context "Headers" do
     test "with custom non-blank idprefix" do
       assert_xpath "//h2[@id='ref_my_title'][text() = 'My Title']", render_string(":idprefix: ref_\n\n== My Title ")
     end
+
+    test 'with multibyte characters' do
+      input = <<-EOS
+== Asciidoctor in 中文
+      EOS
+      output = render_string input
+      assert_xpath '//h2[@id="_asciidoctor_in"][text()="Asciidoctor in 中文"]', output
+    end
   end
 
   context "level 2" do 
     test "with multiline syntax" do
-      assert_xpath "//h3[@id='_my_section'][text() = 'My Section']", render_string("My Section\n~~~~~~~~~~~")
+      assert_xpath "//h3[@id='_my_section'][text() = 'My Section']", render_string(":fragment:\nMy Section\n~~~~~~~~~~~")
     end
 
     test "with single line syntax" do
-      assert_xpath "//h3[@id='_my_title'][text() = 'My Title']", render_string("=== My Title")
+      assert_xpath "//h3[@id='_my_title'][text() = 'My Title']", render_string(":fragment:\n=== My Title")
     end
   end  
 
   context "level 3" do 
     test "with multiline syntax" do
-      assert_xpath "//h4[@id='_my_section'][text() = 'My Section']", render_string("My Section\n^^^^^^^^^^")
+      assert_xpath "//h4[@id='_my_section'][text() = 'My Section']", render_string(":fragment:\nMy Section\n^^^^^^^^^^")
     end
 
     test "with single line syntax" do
-      assert_xpath "//h4[@id='_my_title'][text() = 'My Title']", render_string("==== My Title")
+      assert_xpath "//h4[@id='_my_title'][text() = 'My Title']", render_string(":fragment:\n==== My Title")
     end
   end
 
   context "level 4" do 
     test "with multiline syntax" do
-      assert_xpath "//h5[@id='_my_section'][text() = 'My Section']", render_string("My Section\n++++++++++")
+      assert_xpath "//h5[@id='_my_section'][text() = 'My Section']", render_string(":fragment:\nMy Section\n++++++++++")
     end
 
     test "with single line syntax" do
-      assert_xpath "//h5[@id='_my_title'][text() = 'My Title']", render_string("===== My Title")
+      assert_xpath "//h5[@id='_my_title'][text() = 'My Title']", render_string(":fragment:\n===== My Title")
     end
-  end  
+  end
+
+  context 'Section Numbering' do
+    test 'should create section number with one entry for level 1' do
+      sect1 = Asciidoctor::Section.new(nil)
+      sect1.level = 1
+      assert_equal '1.', sect1.sectnum
+    end
+
+    test 'should create section number with two entries for level 2' do
+      sect1 = Asciidoctor::Section.new(nil)
+      sect1.level = 1
+      sect1_1 = Asciidoctor::Section.new(sect1)
+      sect1 << sect1_1
+      assert_equal '1.1.', sect1_1.sectnum
+    end
+
+    test 'should create section number with three entries for level 3' do
+      sect1 = Asciidoctor::Section.new(nil)
+      sect1.level = 1
+      sect1_1 = Asciidoctor::Section.new(sect1)
+      sect1 << sect1_1
+      sect1_1_1 = Asciidoctor::Section.new(sect1_1)
+      sect1_1 << sect1_1_1
+      assert_equal '1.1.1.', sect1_1_1.sectnum
+    end
+
+    test 'should create section number for second section in level' do
+      sect1 = Asciidoctor::Section.new(nil)
+      sect1.level = 1
+      sect1_1 = Asciidoctor::Section.new(sect1)
+      sect1 << sect1_1
+      sect1_2 = Asciidoctor::Section.new(sect1)
+      sect1 << sect1_2
+      assert_equal '1.2.', sect1_2.sectnum
+    end
+
+    test 'sectnum should use specified delimiter and append string' do
+      sect1 = Asciidoctor::Section.new(nil)
+      sect1.level = 1
+      sect1_1 = Asciidoctor::Section.new(sect1)
+      sect1 << sect1_1
+      sect1_1_1 = Asciidoctor::Section.new(sect1_1)
+      sect1_1 << sect1_1_1
+      assert_equal '1,1,1,', sect1_1_1.sectnum(',')
+      assert_equal '1:1:1', sect1_1_1.sectnum(':', false)
+    end
+
+    test 'should render section numbers when numbered attribute is set' do
+      input = <<-EOS
+= Title
+:numbered:
+
+== Section_1 
+
+text
+
+=== Section_1_1
+
+text
+
+==== Section_1_1_1
+
+text
+
+== Section_2
+
+text
+
+=== Section_2_1
+
+text
+
+=== Section_2_2
+
+text
+      EOS
+    
+      output = render_string input
+      assert_xpath '//h2[@id="_section_1"][starts-with(text(), "1. ")]', output, 1
+      assert_xpath '//h3[@id="_section_1_1"][starts-with(text(), "1.1. ")]', output, 1
+      assert_xpath '//h4[@id="_section_1_1_1"][starts-with(text(), "1.1.1. ")]', output, 1
+      assert_xpath '//h2[@id="_section_2"][starts-with(text(), "2. ")]', output, 1
+      assert_xpath '//h3[@id="_section_2_1"][starts-with(text(), "2.1. ")]', output, 1
+      assert_xpath '//h3[@id="_section_2_2"][starts-with(text(), "2.2. ")]', output, 1
+    end
+
+    test 'blocks should have level' do
+      input = <<-EOS
+= Title
+
+preamble
+
+== Section 1
+
+paragraph
+
+=== Section 1.1
+
+paragraph
+      EOS
+      doc = document_from_string input
+      assert_equal 0, doc.blocks[0].level
+      assert_equal 1, doc.blocks[1].level
+      assert_equal 1, doc.blocks[1].blocks[0].level
+      assert_equal 2, doc.blocks[1].blocks[1].level
+      assert_equal 2, doc.blocks[1].blocks[1].blocks[0].level
+    end
+  end
+
+  context "heading patterns in blocks" do
+    test "should not interpret a listing block as a heading" do
+      input = <<-EOS
+Section
+-------
+
+----
+code
+----
+
+fin.
+      EOS
+      output = render_string input
+      assert_xpath "//h2", output, 1
+    end
+
+    test "should not interpret an open block as a heading" do
+      input = <<-EOS
+Section
+-------
+
+--
+ha
+--
+
+fin.
+      EOS
+      output = render_string input
+      assert_xpath "//h2", output, 1
+    end
+
+    test "should not interpret an attribute list as a heading" do
+      input = <<-EOS
+Section
+=======
+
+preamble
+
+[TIP]
+====
+This should be a tip, not a heading.
+====
+      EOS
+      output = render_string input
+      assert_xpath "//*[@class='admonitionblock']//p[text() = 'This should be a tip, not a heading.']", output, 1
+    end
+
+    test "should not match a heading in a labeled list" do
+      input = <<-EOS
+Section
+-------
+
+term1::
++
+----
+list = [1, 2, 3];
+----
+term2::
+== not a heading
+term3:: def
+
+//
+
+fin.
+      EOS
+      output = render_string input
+      assert_xpath "//h2", output, 1
+      assert_xpath "//dl", output, 1
+    end
+
+    test "should not match a heading in a bulleted list" do
+      input = <<-EOS
+Section
+-------
+
+* first
++
+----
+list = [1, 2, 3];
+----
++
+* second
+== not a heading
+* third
+
+fin.
+      EOS
+      output = render_string input
+      assert_xpath "//h2", output, 1
+      assert_xpath "//ul", output, 1
+    end
+
+    test "should not match a heading in a block" do
+      input = <<-EOS
+====
+
+== not a heading
+
+====
+      EOS
+      output = render_string input
+      assert_xpath "//h2", output, 0
+      assert_xpath "//*[@class='exampleblock']//p[text() = '== not a heading']", output, 1
+    end
+  end
+
+  context 'Table of Contents' do
+    test 'should render table of contents if toc attribute is set' do
+      input = <<-EOS
+Article
+=======
+:toc:
+
+== Section One
+
+It was a dark and stormy night...
+
+== Section Two
+
+They couldn't believe their eyes when...
+
+=== Interlude
+
+While they were waiting...
+
+== Section Three
+
+That's all she wrote!
+      EOS
+      output = render_string input
+      assert_xpath '//*[@id="toc"]', output, 1
+      assert_xpath '//*[@id="toc"]/*[@id="toctitle"][text()="Table of Contents"]', output, 1
+      assert_xpath '//*[@id="toc"]/ol', output, 1
+      assert_xpath '//*[@id="toc"]//ol', output, 2
+      assert_xpath '//*[@id="toc"]/ol/li', output, 4
+      assert_xpath '//*[@id="toc"]/ol/li[1]/a[@href="#_section_one"][text()="1. Section One"]', output, 1
+      assert_xpath '//*[@id="toc"]/ol/li/ol/li', output, 1
+      assert_xpath '//*[@id="toc"]/ol/li/ol/li/a[@href="#_interlude"][text()="2.1. Interlude"]', output, 1
+    end
+  end
+
+  context "book doctype" do
+    test "document title with level 0 headings" do
+      input = <<-EOS
+Book
+====
+:doctype: book
+
+= Chapter One
+
+It was a dark and stormy night...
+
+= Chapter Two
+
+They couldn't believe their eyes when...
+
+== Interlude
+
+While they were waiting...
+
+= Chapter Three
+
+That's all she wrote!
+      EOS
+
+      output = render_string(input)
+      assert_xpath '//h1', output, 4
+      assert_xpath '//h2', output, 1
+      assert_xpath '//h1[@id="_chapter_one"][text() = "Chapter One"]', output, 1
+      assert_xpath '//h1[@id="_chapter_two"][text() = "Chapter Two"]', output, 1
+      assert_xpath '//h1[@id="_chapter_three"][text() = "Chapter Three"]', output, 1
+    end
+  end
 end