asciidoctor 1.5.6.2 → 1.5.7

data/test/converter_test.rb

@@ -9,59 +9,65 @@ context 'Converter' do
 
   context 'View options' do
     test 'should set Haml format to html5 for html5 backend' do
-      doc = Asciidoctor::Document.new [], :template_dir => File.join(File.dirname(__FILE__), 'fixtures', 'custom-backends', 'haml'), :template_cache => false
-      assert doc.converter.is_a?(Asciidoctor::Converter::CompositeConverter)
+      doc = Asciidoctor::Document.new [], :template_dir => (fixture_path 'custom-backends/haml'), :template_cache => false
+      assert_kind_of Asciidoctor::Converter::CompositeConverter, doc.converter
       selected = doc.converter.find_converter('paragraph')
-      assert selected.is_a? Asciidoctor::Converter::TemplateConverter
-      assert selected.templates['paragraph'].is_a? Tilt::HamlTemplate
+      assert_kind_of Asciidoctor::Converter::TemplateConverter, selected
+      assert_kind_of Tilt::HamlTemplate, selected.templates['paragraph']
       assert_equal :html5, selected.templates['paragraph'].options[:format]
     end
 
     test 'should set Haml format to xhtml for docbook backend' do
-      doc = Asciidoctor::Document.new [], :backend => 'docbook45', :template_dir => File.join(File.dirname(__FILE__), 'fixtures', 'custom-backends', 'haml'), :template_cache => false
-      assert doc.converter.is_a?(Asciidoctor::Converter::CompositeConverter)
+      doc = Asciidoctor::Document.new [], :backend => 'docbook45', :template_dir => (fixture_path 'custom-backends/haml'), :template_cache => false
+      assert_kind_of Asciidoctor::Converter::CompositeConverter, doc.converter
       selected = doc.converter.find_converter('paragraph')
-      assert selected.is_a? Asciidoctor::Converter::TemplateConverter
-      assert selected.templates['paragraph'].is_a? Tilt::HamlTemplate
+      assert_kind_of Asciidoctor::Converter::TemplateConverter, selected
+      assert_kind_of Tilt::HamlTemplate, selected.templates['paragraph']
       assert_equal :xhtml, selected.templates['paragraph'].options[:format]
     end
 
     test 'should configure Slim to resolve includes in specified template dirs' do
-      template_dirs = [
-        File.join(File.dirname(__FILE__), 'fixtures', 'custom-backends', 'slim'),
-        File.join(File.dirname(__FILE__), 'fixtures', 'custom-backends', 'slim-overrides'),
-      ]
+      template_dirs = [(fixture_path 'custom-backends/slim'), (fixture_path 'custom-backends/slim-overrides')]
       doc = Asciidoctor::Document.new [], :template_dirs => template_dirs, :template_cache => false
-      assert doc.converter.is_a?(Asciidoctor::Converter::CompositeConverter)
+      assert_kind_of Asciidoctor::Converter::CompositeConverter, doc.converter
       selected = doc.converter.find_converter('paragraph')
-      assert selected.is_a? Asciidoctor::Converter::TemplateConverter
-      assert selected.templates['paragraph'].is_a? Slim::Template
+      assert_kind_of Asciidoctor::Converter::TemplateConverter, selected
+      assert_kind_of Slim::Template, selected.templates['paragraph']
       assert_equal template_dirs.reverse.map {|dir| File.expand_path dir }, selected.templates['paragraph'].options[:include_dirs]
     end
 
+    test 'should coerce template_dirs option to an Array' do
+      template_dirs = fixture_path 'custom-backends/slim'
+      doc = Asciidoctor::Document.new [], :template_dirs => template_dirs, :template_cache => false
+      assert_kind_of Asciidoctor::Converter::CompositeConverter, doc.converter
+      selected = doc.converter.find_converter('paragraph')
+      assert_kind_of Asciidoctor::Converter::TemplateConverter, selected
+      assert_kind_of Array, (selected.instance_variable_get :@template_dirs)
+    end
+
     test 'should set Slim format to html for html5 backend' do
-      doc = Asciidoctor::Document.new [], :template_dir => File.join(File.dirname(__FILE__), 'fixtures', 'custom-backends', 'slim'), :template_cache => false
-      assert doc.converter.is_a?(Asciidoctor::Converter::CompositeConverter)
+      doc = Asciidoctor::Document.new [], :template_dir => (fixture_path 'custom-backends/slim'), :template_cache => false
+      assert_kind_of Asciidoctor::Converter::CompositeConverter, doc.converter
       selected = doc.converter.find_converter('paragraph')
-      assert selected.is_a? Asciidoctor::Converter::TemplateConverter
-      assert selected.templates['paragraph'].is_a? Slim::Template
+      assert_kind_of Asciidoctor::Converter::TemplateConverter, selected
+      assert_kind_of Slim::Template, selected.templates['paragraph']
       assert_equal :html, selected.templates['paragraph'].options[:format]
     end
 
     test 'should set Slim format to nil for docbook backend' do
-      doc = Asciidoctor::Document.new [], :backend => 'docbook45', :template_dir => File.join(File.dirname(__FILE__), 'fixtures', 'custom-backends', 'slim'), :template_cache => false
-      assert doc.converter.is_a?(Asciidoctor::Converter::CompositeConverter)
+      doc = Asciidoctor::Document.new [], :backend => 'docbook45', :template_dir => (fixture_path 'custom-backends/slim'), :template_cache => false
+      assert_kind_of Asciidoctor::Converter::CompositeConverter, doc.converter
       selected = doc.converter.find_converter('paragraph')
-      assert selected.is_a? Asciidoctor::Converter::TemplateConverter
-      assert selected.templates['paragraph'].is_a? Slim::Template
+      assert_kind_of Asciidoctor::Converter::TemplateConverter, selected
+      assert_kind_of Slim::Template, selected.templates['paragraph']
       assert_nil selected.templates['paragraph'].options[:format]
     end
 
     test 'should set safe mode of Slim AsciiDoc engine to match document safe mode when Slim >= 3' do
-      doc = Asciidoctor::Document.new [], :template_dir => File.join(File.dirname(__FILE__), 'fixtures', 'custom-backends', 'slim'), :template_cache => false, :safe => :unsafe
-      assert doc.converter.is_a?(Asciidoctor::Converter::CompositeConverter)
+      doc = Asciidoctor::Document.new [], :template_dir => (fixture_path 'custom-backends/slim'), :template_cache => false, :safe => :unsafe
+      assert_kind_of Asciidoctor::Converter::CompositeConverter, doc.converter
       selected = doc.converter.find_converter('paragraph')
-      assert selected.is_a? Asciidoctor::Converter::TemplateConverter
+      assert_kind_of Asciidoctor::Converter::TemplateConverter, selected
       slim_asciidoc_opts = selected.instance_variable_get(:@engine_options)[:slim][:asciidoc]
       if ::Slim::VERSION >= '3.0'
         assert_equal({ :safe => Asciidoctor::SafeMode::UNSAFE }, slim_asciidoc_opts)
@@ -71,20 +77,20 @@ context 'Converter' do
     end
 
     test 'should support custom template engine options for known engine' do
-      doc = Asciidoctor::Document.new [], :template_dir => File.join(File.dirname(__FILE__), 'fixtures', 'custom-backends', 'slim'), :template_cache => false, :template_engine_options => { :slim => { :pretty => true } }
-      assert doc.converter.is_a?(Asciidoctor::Converter::CompositeConverter)
+      doc = Asciidoctor::Document.new [], :template_dir => (fixture_path 'custom-backends/slim'), :template_cache => false, :template_engine_options => { :slim => { :pretty => true } }
+      assert_kind_of Asciidoctor::Converter::CompositeConverter, doc.converter
       selected = doc.converter.find_converter('paragraph')
-      assert selected.is_a? Asciidoctor::Converter::TemplateConverter
-      assert selected.templates['paragraph'].is_a? Slim::Template
+      assert_kind_of Asciidoctor::Converter::TemplateConverter, selected
+      assert_kind_of Slim::Template, selected.templates['paragraph']
       assert_equal true, selected.templates['paragraph'].options[:pretty]
     end
 
     test 'should support custom template engine options' do
-      doc = Asciidoctor::Document.new [], :template_dir => File.join(File.dirname(__FILE__), 'fixtures', 'custom-backends', 'slim'), :template_cache => false, :template_engine_options => { :slim => { :pretty => true } }
-      assert doc.converter.is_a?(Asciidoctor::Converter::CompositeConverter)
+      doc = Asciidoctor::Document.new [], :template_dir => (fixture_path 'custom-backends/slim'), :template_cache => false, :template_engine_options => { :slim => { :pretty => true } }
+      assert_kind_of Asciidoctor::Converter::CompositeConverter, doc.converter
       selected = doc.converter.find_converter('paragraph')
-      assert selected.is_a? Asciidoctor::Converter::TemplateConverter
-      assert selected.templates['paragraph'].is_a? Slim::Template
+      assert_kind_of Asciidoctor::Converter::TemplateConverter, selected
+      assert_kind_of Slim::Template, selected.templates['paragraph']
       assert_equal false, selected.templates['paragraph'].options[:sort_attrs]
       assert_equal true, selected.templates['paragraph'].options[:pretty]
     end
@@ -92,43 +98,43 @@ context 'Converter' do
 
   context 'Custom backends' do
     test 'should load Haml templates for default backend' do
-      doc = Asciidoctor::Document.new [], :template_dir => File.join(File.dirname(__FILE__), 'fixtures', 'custom-backends', 'haml'), :template_cache => false
-      assert doc.converter.is_a?(Asciidoctor::Converter::CompositeConverter)
+      doc = Asciidoctor::Document.new [], :template_dir => (fixture_path 'custom-backends/haml'), :template_cache => false
+      assert_kind_of Asciidoctor::Converter::CompositeConverter, doc.converter
       ['paragraph', 'sidebar'].each do |node_name|
         selected = doc.converter.find_converter node_name
-        assert selected.is_a? Asciidoctor::Converter::TemplateConverter
-        assert selected.templates[node_name].is_a? Tilt::HamlTemplate
+        assert_kind_of Asciidoctor::Converter::TemplateConverter, selected
+        assert_kind_of Tilt::HamlTemplate, selected.templates[node_name]
         assert_equal %(block_#{node_name}.html.haml), File.basename(selected.templates[node_name].file)
       end
     end
 
     test 'should set outfilesuffix according to backend info' do
       doc = Asciidoctor.load 'content'
-      doc.render
+      doc.convert
       assert_equal '.html', doc.attributes['outfilesuffix']
 
-      doc = Asciidoctor.load 'content', :template_dir => File.join(File.dirname(__FILE__), 'fixtures', 'custom-backends', 'haml'), :template_cache => false
-      doc.render
+      doc = Asciidoctor.load 'content', :template_dir => (fixture_path 'custom-backends/haml'), :template_cache => false
+      doc.convert
       assert_equal '.html', doc.attributes['outfilesuffix']
     end
 
     test 'should not override outfilesuffix attribute if locked' do
       doc = Asciidoctor.load 'content', :attributes => {'outfilesuffix' => '.foo'}
-      doc.render
+      doc.convert
       assert_equal '.foo', doc.attributes['outfilesuffix']
 
-      doc = Asciidoctor.load 'content', :template_dir => File.join(File.dirname(__FILE__), 'fixtures', 'custom-backends', 'haml'), :template_cache => false, :attributes => {'outfilesuffix' => '.foo'}
-      doc.render
+      doc = Asciidoctor.load 'content', :template_dir => (fixture_path 'custom-backends/haml'), :template_cache => false, :attributes => {'outfilesuffix' => '.foo'}
+      doc.convert
       assert_equal '.foo', doc.attributes['outfilesuffix']
     end
 
     test 'should load Haml templates for docbook45 backend' do
-      doc = Asciidoctor::Document.new [], :backend => 'docbook45', :template_dir => File.join(File.dirname(__FILE__), 'fixtures', 'custom-backends', 'haml'), :template_cache => false
-      assert doc.converter.is_a?(Asciidoctor::Converter::CompositeConverter)
+      doc = Asciidoctor::Document.new [], :backend => 'docbook45', :template_dir => (fixture_path 'custom-backends/haml'), :template_cache => false
+      assert_kind_of Asciidoctor::Converter::CompositeConverter, doc.converter
       ['paragraph'].each do |node_name|
         selected = doc.converter.find_converter node_name
-        assert selected.is_a? Asciidoctor::Converter::TemplateConverter
-        assert selected.templates[node_name].is_a? Tilt::HamlTemplate
+        assert_kind_of Asciidoctor::Converter::TemplateConverter, selected
+        assert_kind_of Tilt::HamlTemplate, selected.templates[node_name]
         assert_equal %(block_#{node_name}.xml.haml), File.basename(selected.templates[node_name].file)
       end
     end
@@ -148,7 +154,7 @@ Sidebar content
 ****
       EOS
 
-      output = render_embedded_string input, :template_dir => File.join(File.dirname(__FILE__), 'fixtures', 'custom-backends', 'haml'), :template_cache => false
+      output = render_embedded_string input, :template_dir => (fixture_path 'custom-backends/haml'), :template_cache => false
       assert_xpath '/*[@class="sect1"]/*[@class="sectionbody"]/p', output, 1
       assert_xpath '//aside', output, 1
       assert_xpath '/*[@class="sect1"]/*[@class="sectionbody"]/p/following-sibling::aside', output, 1
@@ -161,12 +167,12 @@ Sidebar content
         # clear out any cache, just to be sure
         Asciidoctor::Converter::TemplateConverter.clear_caches if defined? Asciidoctor::Converter::TemplateConverter
 
-        template_dir = File.join(File.dirname(__FILE__), 'fixtures', 'custom-backends', 'haml')
+        template_dir = fixture_path 'custom-backends/haml'
         doc = Asciidoctor::Document.new [], :template_dir => template_dir
         doc.converter
         caches = Asciidoctor::Converter::TemplateConverter.caches
         if defined? ::ThreadSafe::Cache
-          assert caches[:templates].is_a?(::ThreadSafe::Cache)
+          assert_kind_of ::ThreadSafe::Cache, caches[:templates]
           refute_empty caches[:templates]
           paragraph_template_before = caches[:templates].values.find {|t| File.basename(t.file) == 'block_paragraph.html.haml' }
           refute_nil paragraph_template_before
@@ -194,7 +200,7 @@ Sidebar content
     end
 
     test 'should use custom cache to cache templates' do
-      template_dir = File.join(File.dirname(__FILE__), 'fixtures', 'custom-backends', 'haml')
+      template_dir = fixture_path 'custom-backends/haml'
       Asciidoctor::PathResolver.new.system_path(File.join(template_dir, 'html5', 'block_paragraph.html.haml'), nil)
       caches = { :scans => {}, :templates => {} }
       doc = Asciidoctor::Document.new [], :template_dir => template_dir, :template_cache => caches
@@ -203,7 +209,7 @@ Sidebar content
       refute_empty caches[:templates]
       paragraph_template = caches[:templates].values.find {|t| File.basename(t.file) == 'block_paragraph.html.haml' }
       refute_nil paragraph_template
-      assert paragraph_template.is_a? ::Tilt::HamlTemplate
+      assert_kind_of ::Tilt::HamlTemplate, paragraph_template
     end
 
     test 'should be able to disable template cache' do
@@ -211,8 +217,7 @@ Sidebar content
         # clear out any cache, just to be sure
         Asciidoctor::Converter::TemplateConverter.clear_caches if defined? Asciidoctor::Converter::TemplateConverter
 
-        doc = Asciidoctor::Document.new [], :template_dir => File.join(File.dirname(__FILE__), 'fixtures', 'custom-backends', 'haml'),
-            :template_cache => false
+        doc = Asciidoctor::Document.new [], :template_dir => (fixture_path 'custom-backends/haml'), :template_cache => false
         doc.converter
         caches = Asciidoctor::Converter::TemplateConverter.caches
         assert caches.empty? || caches[:scans].empty?
@@ -224,51 +229,51 @@ Sidebar content
     end
 
     test 'should load ERB templates using ERBTemplate if eruby is not set' do
-      doc = Asciidoctor::Document.new [], :template_dir => File.join(File.dirname(__FILE__), 'fixtures', 'custom-backends', 'erb'), :template_cache => false
-      assert doc.converter.is_a?(Asciidoctor::Converter::CompositeConverter)
+      doc = Asciidoctor::Document.new [], :template_dir => (fixture_path 'custom-backends/erb'), :template_cache => false
+      assert_kind_of Asciidoctor::Converter::CompositeConverter, doc.converter
       ['paragraph'].each do |node_name|
         selected = doc.converter.find_converter node_name
-        assert selected.is_a? Asciidoctor::Converter::TemplateConverter
+        assert_kind_of Asciidoctor::Converter::TemplateConverter, selected
         template = selected.templates[node_name]
-        assert template.is_a? Tilt::ERBTemplate
-        refute template.is_a? Tilt::ErubisTemplate
-        assert template.instance_variable_get('@engine').is_a? ::ERB
+        assert_kind_of Tilt::ERBTemplate, template
+        refute_kind_of Tilt::ErubisTemplate, template
+        assert_kind_of ::ERB, template.instance_variable_get('@engine')
         assert_equal %(block_#{node_name}.html.erb), File.basename(selected.templates[node_name].file)
       end
     end
 
     test 'should load ERB templates using ErubisTemplate if eruby is set to erubis' do
-      doc = Asciidoctor::Document.new [], :template_dir => File.join(File.dirname(__FILE__), 'fixtures', 'custom-backends', 'erb'), :template_cache => false, :eruby => 'erubis'
-      assert doc.converter.is_a?(Asciidoctor::Converter::CompositeConverter)
+      doc = Asciidoctor::Document.new [], :template_dir => (fixture_path 'custom-backends/erb'), :template_cache => false, :eruby => 'erubis'
+      assert_kind_of Asciidoctor::Converter::CompositeConverter, doc.converter
       ['paragraph'].each do |node_name|
         selected = doc.converter.find_converter node_name
-        assert selected.is_a? Asciidoctor::Converter::TemplateConverter
+        assert_kind_of Asciidoctor::Converter::TemplateConverter, selected
         template = selected.templates[node_name]
-        assert template.is_a? Tilt::ERBTemplate
-        assert template.is_a? Tilt::ErubisTemplate
-        assert template.instance_variable_get('@engine').is_a? ::Erubis::FastEruby
+        assert_kind_of Tilt::ERBTemplate, template
+        assert_kind_of Tilt::ErubisTemplate, template
+        assert_kind_of ::Erubis::FastEruby, template.instance_variable_get('@engine')
         assert_equal %(block_#{node_name}.html.erb), File.basename(selected.templates[node_name].file)
       end
     end
 
     test 'should load Slim templates for default backend' do
-      doc = Asciidoctor::Document.new [], :template_dir => File.join(File.dirname(__FILE__), 'fixtures', 'custom-backends', 'slim'), :template_cache => false
-      assert doc.converter.is_a?(Asciidoctor::Converter::CompositeConverter)
+      doc = Asciidoctor::Document.new [], :template_dir => (fixture_path 'custom-backends/slim'), :template_cache => false
+      assert_kind_of Asciidoctor::Converter::CompositeConverter, doc.converter
       ['paragraph', 'sidebar'].each do |node_name|
         selected = doc.converter.find_converter node_name
-        assert selected.is_a? Asciidoctor::Converter::TemplateConverter
-        assert selected.templates[node_name].is_a? Slim::Template
+        assert_kind_of Asciidoctor::Converter::TemplateConverter, selected
+        assert_kind_of Slim::Template, selected.templates[node_name]
         assert_equal %(block_#{node_name}.html.slim), File.basename(selected.templates[node_name].file)
       end
     end
 
     test 'should load Slim templates for docbook45 backend' do
-      doc = Asciidoctor::Document.new [], :backend => 'docbook45', :template_dir => File.join(File.dirname(__FILE__), 'fixtures', 'custom-backends', 'slim'), :template_cache => false
-      assert doc.converter.is_a?(Asciidoctor::Converter::CompositeConverter)
+      doc = Asciidoctor::Document.new [], :backend => 'docbook45', :template_dir => (fixture_path 'custom-backends/slim'), :template_cache => false
+      assert_kind_of Asciidoctor::Converter::CompositeConverter, doc.converter
       ['paragraph'].each do |node_name|
         selected = doc.converter.find_converter node_name
-        assert selected.is_a? Asciidoctor::Converter::TemplateConverter
-        assert selected.templates[node_name].is_a? Slim::Template
+        assert_kind_of Asciidoctor::Converter::TemplateConverter, selected
+        assert_kind_of Slim::Template, selected.templates[node_name]
         assert_equal %(block_#{node_name}.xml.slim), File.basename(selected.templates[node_name].file)
       end
     end
@@ -288,7 +293,7 @@ Sidebar content
 ****
       EOS
 
-      output = render_embedded_string input, :template_dir => File.join(File.dirname(__FILE__), 'fixtures', 'custom-backends', 'slim'), :template_cache => false
+      output = render_embedded_string input, :template_dir => (fixture_path 'custom-backends/slim'), :template_cache => false
       assert_xpath '/*[@class="sect1"]/*[@class="sectionbody"]/p', output, 1
       assert_xpath '//aside', output, 1
       assert_xpath '/*[@class="sect1"]/*[@class="sectionbody"]/p/following-sibling::aside', output, 1
@@ -350,6 +355,93 @@ content
       end
     end
 
+    test 'should map handles? method on converter to respond_to? by default' do
+      class CustomConverterC
+        include Asciidoctor::Converter
+        def paragraph node
+          'paragraph'
+        end
+      end
+
+      converter = CustomConverterC.new 'myhtml'
+      assert_respond_to converter, :handles?
+      assert converter.handles?(:paragraph)
+    end
+
+    test 'should not configure converter to support templates by default' do
+      input = <<-EOS
+paragraph
+      EOS
+
+      begin
+        Asciidoctor::Converter::Factory.unregister_all
+        class CustomConverterD
+          include Asciidoctor::Converter
+          register_for 'myhtml'
+          def convert node, transform = nil, opts = {}
+            transform ||= node.node_name
+            send transform, node
+          end
+
+          def document node
+            ['<!DOCTYPE html>', '<html>', '<body>', node.content, '</body>', '</html>'] * %(\n)
+          end
+
+          def paragraph node
+            ['<div class="paragraph">', %(<p>#{node.content}</p>), '</div>'] * %(\n)
+          end
+        end
+
+        doc = document_from_string input, :backend => 'myhtml', :template_dir => (fixture_path 'custom-backends/slim/html5'), :template_cache => false
+        assert_kind_of CustomConverterD, doc.converter
+        refute doc.converter.supports_templates?
+        output = doc.convert
+        assert_xpath '//*[@class="paragraph"]/p[text()="paragraph"]', output, 1
+      ensure
+        Asciidoctor::Converter::Factory.unregister_all
+      end
+    end
+
+    test 'should wrap converter in composite converter with template converter if it declares that it supports templates' do
+      input = <<-EOS
+paragraph
+      EOS
+
+      begin
+        Asciidoctor::Converter::Factory.unregister_all
+        class CustomConverterE
+          include Asciidoctor::Converter
+          register_for 'myhtml'
+
+          def initialize *args
+            super
+            supports_templates
+          end
+
+          def convert node, transform = nil, opts = {}
+            transform ||= node.node_name
+            send transform, node
+          end
+
+          def document node
+            ['<!DOCTYPE html>', '<html>', '<body>', node.content, '</body>', '</html>'] * %(\n)
+          end
+
+          def paragraph node
+            ['<div class="paragraph">', %(<p>#{node.content}</p>), '</div>'] * %(\n)
+          end
+        end
+
+        doc = document_from_string input, :backend => 'myhtml', :template_dir => (fixture_path 'custom-backends/slim/html5'), :template_cache => false
+        assert_kind_of Asciidoctor::Converter::CompositeConverter, doc.converter
+        output = doc.convert
+        assert_xpath '//*[@class="paragraph"]/p[text()="paragraph"]', output, 0
+        assert_xpath '//body/p[text()="paragraph"]', output, 1
+      ensure
+        Asciidoctor::Converter::Factory.unregister_all
+      end
+    end
+
     test 'should fall back to catch all converter' do
       input = <<-EOS
 content
@@ -358,7 +450,7 @@ content
       begin
         Asciidoctor::Converter::Factory.unregister_all
 
-        class CustomConverterC
+        class CustomConverterF
           include Asciidoctor::Converter
           register_for '*'
           def convert node, name = nil
@@ -367,7 +459,7 @@ content
         end
 
         converters = Asciidoctor::Converter::Factory.converters
-        assert converters['*'] == CustomConverterC
+        assert converters['*'] == CustomConverterF
         output = render_string input, :backend => 'foobaz'
         assert 'foobaz content', output
       ensure

data/test/document_test.rb

@@ -131,718 +131,6 @@ content
     end
   end
 
-  context 'Load APIs' do
-    test 'should load input file' do
-      sample_input_path = fixture_path('sample.asciidoc')
-      doc = File.open(sample_input_path) {|file| Asciidoctor.load file, :safe => Asciidoctor::SafeMode::SAFE }
-      assert_equal 'Document Title', doc.doctitle
-      assert_equal File.expand_path(sample_input_path), doc.attr('docfile')
-      assert_equal File.expand_path(File.dirname(sample_input_path)), doc.attr('docdir')
-      assert_equal '.asciidoc', doc.attr('docfilesuffix')
-    end
-
-    test 'should load input file from filename' do
-      sample_input_path = fixture_path('sample.asciidoc')
-      doc = Asciidoctor.load_file(sample_input_path, :safe => Asciidoctor::SafeMode::SAFE)
-      assert_equal 'Document Title', doc.doctitle
-      assert_equal File.expand_path(sample_input_path), doc.attr('docfile')
-      assert_equal File.expand_path(File.dirname(sample_input_path)), doc.attr('docdir')
-      assert_equal '.asciidoc', doc.attr('docfilesuffix')
-    end
-
-    test 'should not load invalid file' do
-      sample_input_path = fixture_path('hello-asciidoctor.pdf')
-      exception = assert_raises ArgumentError do
-        Asciidoctor.load_file(sample_input_path, :safe => Asciidoctor::SafeMode::SAFE)
-      end
-      assert_match(/Failed to load AsciiDoc document/, exception.message)
-      # verify we have the correct backtrace (should be in at least first 5 lines)
-      assert_match((RUBY_ENGINE == 'rbx' ? /parser\.rb/ : /helpers\.rb/), exception.backtrace[0..4].join("\n"))
-    end if RUBY_MIN_VERSION_1_9
-
-    test 'should load input IO' do
-      input = StringIO.new(<<-EOS)
-Document Title
-==============
-
-preamble
-      EOS
-      doc = Asciidoctor.load(input, :safe => Asciidoctor::SafeMode::SAFE)
-      assert_equal 'Document Title', doc.doctitle
-      refute doc.attr?('docfile')
-      assert_equal doc.base_dir, doc.attr('docdir')
-    end
-
-    test 'should load input string' do
-      input = <<-EOS
-Document Title
-==============
-
-preamble
-      EOS
-      doc = Asciidoctor.load(input, :safe => Asciidoctor::SafeMode::SAFE)
-      assert_equal 'Document Title', doc.doctitle
-      refute doc.attr?('docfile')
-      assert_equal doc.base_dir, doc.attr('docdir')
-    end
-
-    test 'should load input string array' do
-      input = <<-EOS
-Document Title
-==============
-
-preamble
-      EOS
-      doc = Asciidoctor.load(input.lines.entries, :safe => Asciidoctor::SafeMode::SAFE)
-      assert_equal 'Document Title', doc.doctitle
-      refute doc.attr?('docfile')
-      assert_equal doc.base_dir, doc.attr('docdir')
-    end
-
-    test 'should accept attributes as array' do
-	  # NOTE there's a tab character before idseparator
-      doc = Asciidoctor.load('text', :attributes => %w(toc sectnums   source-highlighter=coderay idprefix	idseparator=-))
-      assert_kind_of Hash, doc.attributes
-      assert doc.attr?('toc')
-      assert_equal '', doc.attr('toc')
-      assert doc.attr?('sectnums')
-      assert_equal '', doc.attr('sectnums')
-      assert doc.attr?('source-highlighter')
-      assert_equal 'coderay', doc.attr('source-highlighter')
-      assert doc.attr?('idprefix')
-      assert_equal '', doc.attr('idprefix')
-      assert doc.attr?('idseparator')
-      assert_equal '-', doc.attr('idseparator')
-    end
-
-    test 'should accept attributes as empty array' do
-      doc = Asciidoctor.load('text', :attributes => [])
-      assert_kind_of Hash, doc.attributes
-    end
-
-    test 'should accept attributes as string' do
-      doc = Asciidoctor.load('text', :attributes => 'toc sectnums
-source-highlighter=coderay
-idprefix
-idseparator=-')
-      assert_kind_of Hash, doc.attributes
-      assert doc.attr?('toc')
-      assert_equal '', doc.attr('toc')
-      assert doc.attr?('sectnums')
-      assert_equal '', doc.attr('sectnums')
-      assert doc.attr?('source-highlighter')
-      assert_equal 'coderay', doc.attr('source-highlighter')
-      assert doc.attr?('idprefix')
-      assert_equal '', doc.attr('idprefix')
-      assert doc.attr?('idseparator')
-      assert_equal '-', doc.attr('idseparator')
-    end
-
-    test 'should accept values containing spaces in attributes string' do
-      doc = Asciidoctor.load('text', :attributes => %(idprefix idseparator=-   note-caption=Note\\ to\\\tself toc))
-      assert_kind_of Hash, doc.attributes
-      assert doc.attr?('idprefix')
-      assert_equal '', doc.attr('idprefix')
-      assert doc.attr?('idseparator')
-      assert_equal '-', doc.attr('idseparator')
-      assert doc.attr?('note-caption')
-      assert_equal "Note to\tself", doc.attr('note-caption')
-    end
-
-    test 'should accept attributes as empty string' do
-      doc = Asciidoctor.load('text', :attributes => '')
-      assert_kind_of Hash, doc.attributes
-    end
-
-    test 'should accept attributes as nil' do
-      doc = Asciidoctor.load('text', :attributes => nil)
-      assert_kind_of Hash, doc.attributes
-    end
-
-    test 'should accept attributes if hash like' do
-      class Hashish
-        def initialize
-          @table = {'toc' => ''}
-        end
-
-        def keys
-          @table.keys
-        end
-
-        def [](key)
-          @table[key]
-        end
-      end
-
-      doc = Asciidoctor.load('text', :attributes => Hashish.new)
-      assert_kind_of Hash, doc.attributes
-      assert doc.attributes.has_key?('toc')
-    end
-
-    test 'should output timestamps by default' do
-      doc = document_from_string 'text', :backend => :html5, :attributes => nil
-      result = doc.convert
-      assert doc.attr?('docdate')
-      refute doc.attr? 'reproducible'
-      assert_xpath '//div[@id="footer-text" and contains(string(.//text()), "Last updated")]', result, 1
-    end
-
-    test 'should not output timestamps if reproducible attribute is set in HTML 5' do
-      doc = document_from_string 'text', :backend => :html5, :attributes => { 'reproducible' => '' }
-      result = doc.convert
-      assert doc.attr?('docdate')
-      assert doc.attr?('reproducible')
-      assert_xpath '//div[@id="footer-text" and contains(string(.//text()), "Last updated")]', result, 0
-    end
-
-    test 'should not output timestamps if reproducible attribute is set in DocBook' do
-      doc = document_from_string 'text', :backend => :docbook, :attributes => { 'reproducible' => '' }
-      result = doc.convert
-      assert doc.attr?('docdate')
-      assert doc.attr?('reproducible')
-      assert_xpath '/article/info/date', result, 0
-    end
-
-    test 'should not modify options argument' do
-      options = {
-        :safe => Asciidoctor::SafeMode::SAFE
-      }
-      options.freeze
-      sample_input_path = fixture_path('sample.asciidoc')
-      begin
-        Asciidoctor.load_file sample_input_path, options
-      rescue
-        flunk %(options argument should not be modified)
-      end
-    end
-
-    test 'should not modify attributes Hash argument' do
-      attributes = {}
-      attributes.freeze
-      options = {
-        :safe => Asciidoctor::SafeMode::SAFE,
-        :attributes => attributes
-      }
-      sample_input_path = fixture_path('sample.asciidoc')
-      begin
-        Asciidoctor.load_file sample_input_path, options
-      rescue
-        flunk %(attributes argument should not be modified)
-      end
-    end
-
-    test 'should track file and line information with blocks if sourcemap option is set' do
-      doc = Asciidoctor.load_file fixture_path('sample.asciidoc'), :sourcemap => true
-
-      section_1 = doc.sections[0]
-      assert_equal 'Section A', section_1.title
-      refute_nil section_1.source_location
-      assert_equal 'sample.asciidoc', section_1.file
-      assert_equal 10, section_1.lineno
-
-      section_2 = doc.sections[1]
-      assert_equal 'Section B', section_2.title
-      refute_nil section_2.source_location
-      assert_equal 'sample.asciidoc', section_2.file
-      assert_equal 18, section_2.lineno
-
-      last_block = section_2.blocks[-1]
-      assert_equal :ulist, last_block.context
-      refute_nil last_block.source_location
-      assert_equal 'sample.asciidoc', last_block.file
-      assert_equal 23, last_block.lineno
-
-      doc = Asciidoctor.load_file fixture_path('master.adoc'), :sourcemap => true, :safe => :safe
-
-      section_1 = doc.sections[0]
-      assert_equal 'Chapter A', section_1.title
-      refute_nil section_1.source_location
-      assert_equal fixture_path('chapter-a.adoc'), section_1.file
-      assert_equal 1, section_1.lineno
-    end
-
-    test 'should assign correct source location if section occurs on last line of input' do
-      input = <<-EOS
-= Document Title
-
-== Section A
-
-content
-
-== Section B
-      EOS
-
-      doc = document_from_string input, :sourcemap => true
-      assert_equal [1, 3, 7], (doc.find_by :context => :section).map(&:lineno)
-    end
-
-    test 'should allow sourcemap option on document to be modified' do
-      doc = Asciidoctor.load_file fixture_path('sample.asciidoc'), :parse => false
-      doc.sourcemap = true
-      doc = doc.parse
-
-      section_1 = doc.sections[0]
-      assert_equal 'Section A', section_1.title
-      refute_nil section_1.source_location
-      assert_equal 'sample.asciidoc', section_1.file
-      assert_equal 10, section_1.lineno
-    end
-
-    test 'find_by should return Array of blocks anywhere in document tree that match criteria' do
-      input = <<-EOS
-= Document Title
-
-preamble
-
-== Section A
-
-paragraph
-
---
-Exhibit A::
-+
-[#tiger.animal]
-image::tiger.png[Tiger]
---
-
-image::shoe.png[Shoe]
-
-== Section B
-
-paragraph
-      EOS
-
-      doc = Asciidoctor.load input
-      result = doc.find_by :context => :image
-      assert_equal 2, result.size
-      assert_equal :image, result[0].context
-      assert_equal 'tiger.png', result[0].attr('target')
-      assert_equal :image, result[1].context
-      assert_equal 'shoe.png', result[1].attr('target')
-    end
-
-    test 'find_by should return an empty Array if no matches are found' do
-      input = <<-EOS
-paragraph
-      EOS
-      doc = Asciidoctor.load input
-      result = doc.find_by :context => :section
-      refute_nil result
-      assert_equal 0, result.size
-    end
-
-    test 'find_by should return Array of blocks that match style criteria' do
-      input = <<-EOS
-[square]
-* one
-* two
-* three
-
----
-
-* apples
-* bananas
-* pears
-      EOS
-
-      doc = Asciidoctor.load input
-      result = doc.find_by :context => :ulist, :style => 'square'
-      assert_equal 1, result.size
-      assert_equal :ulist, result[0].context
-    end
-
-    test 'find_by should return Array of blocks that match role criteria' do
-      input = <<-EOS
-[#tiger.animal]
-image::tiger.png[Tiger]
-
-image::shoe.png[Shoe]
-      EOS
-
-      doc = Asciidoctor.load input
-      result = doc.find_by :context => :image, :role => 'animal'
-      assert_equal 1, result.size
-      assert_equal :image, result[0].context
-      assert_equal 'tiger.png', result[0].attr('target')
-    end
-
-    test 'find_by should return the document title section if context selector is :section' do
-      input = <<-EOS
-= Document Title
-
-preamble
-
-== Section One
-
-content
-      EOS
-      doc = Asciidoctor.load input
-      result = doc.find_by :context => :section
-      refute_nil result
-      assert_equal 2, result.size
-      assert_equal :section, result[0].context
-      assert_equal 'Document Title', result[0].title
-    end
-
-    test 'find_by should only return results for which the block argument yields true' do
-      input = <<-EOS
-== Section
-
-content
-
-=== Subsection
-
-content
-      EOS
-      doc = Asciidoctor.load input
-      result = doc.find_by(:context => :section) {|sect| sect.level == 1 }
-      refute_nil result
-      assert_equal 1, result.size
-      assert_equal :section, result[0].context
-      assert_equal 'Section', result[0].title
-    end
-
-    test 'find_by should only return one result when matching by id' do
-      input = <<-EOS
-== Section
-
-content
-
-[#subsection]
-=== Subsection
-
-content
-      EOS
-      doc = Asciidoctor.load input
-      result = doc.find_by(:context => :section, :id => 'subsection')
-      refute_nil result
-      assert_equal 1, result.size
-      assert_equal :section, result[0].context
-      assert_equal 'Subsection', result[0].title
-    end
-
-    test 'find_by should return an empty Array if the id criteria matches but the block argument yields false' do
-      input = <<-EOS
-== Section
-
-content
-
-[#subsection]
-=== Subsection
-
-content
-      EOS
-      doc = Asciidoctor.load input
-      result = doc.find_by(:context => :section, :id => 'subsection') {|sect| false }
-      refute_nil result
-      assert_equal 0, result.size
-    end
-
-    test 'find_by should not crash if dlist entry does not have description' do
-      input = <<-EOS
-term without description::
-      EOS
-      doc = Asciidoctor.load input
-      result = doc.find_by
-      refute_nil result
-      assert_equal 3, result.size
-      assert_kind_of Asciidoctor::Document, result[0]
-      assert_kind_of Asciidoctor::List, result[1]
-      assert_kind_of Asciidoctor::ListItem, result[2]
-    end
-  end
-
-  context 'Convert APIs' do
-    test 'should convert source document to string when to_file is false' do
-      sample_input_path = fixture_path('sample.asciidoc')
-
-      output = Asciidoctor.convert_file sample_input_path, :header_footer => true, :to_file => false
-      refute_empty output
-      assert_xpath '/html', output, 1
-      assert_xpath '/html/head', output, 1
-      assert_xpath '/html/body', output, 1
-      assert_xpath '/html/head/title[text() = "Document Title"]', output, 1
-      assert_xpath '/html/body/*[@id="header"]/h1[text() = "Document Title"]', output, 1
-    end
-
-    test 'lines in output should be separated by line feed' do
-      sample_input_path = fixture_path('sample.asciidoc')
-
-      output = Asciidoctor.convert_file sample_input_path, :header_footer => true, :to_file => false
-      refute_empty output
-      lines = output.split("\n")
-      assert_equal lines.size, output.split(/\r\n|\r|\n/).size
-      raw_lengths = lines.map(&:length)
-      trimmed_lengths = lines.map {|line| line.rstrip.length }
-      assert_equal raw_lengths, trimmed_lengths
-    end
-
-    test 'should accept attributes as array' do
-      sample_input_path = fixture_path('sample.asciidoc')
-      output = Asciidoctor.convert_file sample_input_path, :attributes => %w(sectnums idprefix idseparator=-), :to_file => false
-      assert_css '#section-a', output, 1
-    end
-
-    test 'should accept attributes as string' do
-      sample_input_path = fixture_path('sample.asciidoc')
-      output = Asciidoctor.convert_file sample_input_path, :attributes => 'sectnums idprefix idseparator=-', :to_file => false
-      assert_css '#section-a', output, 1
-    end
-
-    test 'should link to default stylesheet by default when safe mode is SECURE or greater' do
-      sample_input_path = fixture_path('basic.asciidoc')
-      output = Asciidoctor.convert_file sample_input_path, :header_footer => true, :to_file => false
-      assert_css 'html:root > head > link[rel="stylesheet"][href^="https://fonts.googleapis.com"]', output, 1
-      assert_css 'html:root > head > link[rel="stylesheet"][href="./asciidoctor.css"]', output, 1
-    end
-
-    test 'should embed default stylesheet by default if SafeMode is less than SECURE' do
-      input = <<-EOS
-= Document Title
-
-text
-      EOS
-
-      output = Asciidoctor.render(input, :safe => Asciidoctor::SafeMode::SERVER, :header_footer => true)
-      assert_css 'html:root > head > link[rel="stylesheet"][href^="https://fonts.googleapis.com"]', output, 1
-      assert_css 'html:root > head > link[rel="stylesheet"][href="./asciidoctor.css"]', output, 0
-      stylenode = xmlnodes_at_css 'html:root > head > style', output, 1
-      styles = stylenode.content
-      refute_nil styles
-      refute_empty styles.strip
-    end
-
-    test 'should link to default stylesheet by default even if linkcss is unset in document' do
-      input = <<-EOS
-= Document Title
-:linkcss!:
-
-text
-      EOS
-
-      output = Asciidoctor.render(input, :header_footer => true)
-      assert_css 'html:root > head > link[rel="stylesheet"][href^="https://fonts.googleapis.com"]', output, 1
-      assert_css 'html:root > head > link[rel="stylesheet"][href="./asciidoctor.css"]', output, 1
-    end
-
-    test 'should link to default stylesheet by default if linkcss is unset' do
-      input = <<-EOS
-= Document Title
-
-text
-      EOS
-
-      output = Asciidoctor.render(input, :header_footer => true, :attributes => {'linkcss!' => ''})
-      assert_css 'html:root > head > link[rel="stylesheet"][href^="https://fonts.googleapis.com"]', output, 1
-      assert_css 'html:root > head > link[rel="stylesheet"][href="./asciidoctor.css"]', output, 1
-    end
-
-    test 'should embed default stylesheet if safe mode is less than secure and linkcss is unset' do
-      sample_input_path = fixture_path('basic.asciidoc')
-      output = Asciidoctor.convert_file sample_input_path, :header_footer => true, :to_file => false,
-          :safe => Asciidoctor::SafeMode::SAFE, :attributes => {'linkcss!' => ''}
-      assert_css 'html:root > head > style', output, 1
-      stylenode = xmlnodes_at_css 'html:root > head > style', output, 1
-      styles = stylenode.content
-      refute_nil styles
-      refute_empty styles.strip
-    end
-
-    test 'should not link to stylesheet if stylesheet is unset' do
-      input = <<-EOS
-= Document Title
-
-text
-      EOS
-
-      output = Asciidoctor.render(input, :header_footer => true, :attributes => {'stylesheet!' => ''})
-      assert_css 'html:root > head > link[rel="stylesheet"][href^="https://fonts.googleapis.com"]', output, 0
-      assert_css 'html:root > head > link[rel="stylesheet"]', output, 0
-    end
-
-    test 'should link to custom stylesheet if specified in stylesheet attribute' do
-      input = <<-EOS
-= Document Title
-
-text
-      EOS
-
-      output = Asciidoctor.render(input, :header_footer => true, :attributes => {'stylesheet' => './custom.css'})
-      assert_css 'html:root > head > link[rel="stylesheet"][href^="https://fonts.googleapis.com"]', output, 0
-      assert_css 'html:root > head > link[rel="stylesheet"][href="./custom.css"]', output, 1
-
-      output = Asciidoctor.render(input, :header_footer => true, :attributes => {'stylesheet' => 'file:///home/username/custom.css'})
-      assert_css 'html:root > head > link[rel="stylesheet"][href="file:///home/username/custom.css"]', output, 1
-    end
-
-    test 'should resolve custom stylesheet relative to stylesdir' do
-      input = <<-EOS
-= Document Title
-
-text
-      EOS
-
-      output = Asciidoctor.render(input, :header_footer => true, :attributes => {'stylesheet' => 'custom.css', 'stylesdir' => './stylesheets'})
-      assert_css 'html:root > head > link[rel="stylesheet"][href="./stylesheets/custom.css"]', output, 1
-    end
-
-    test 'should resolve custom stylesheet to embed relative to stylesdir' do
-      sample_input_path = fixture_path('basic.asciidoc')
-      output = Asciidoctor.convert_file sample_input_path, :header_footer => true, :safe => Asciidoctor::SafeMode::SAFE, :to_file => false,
-          :attributes => {'stylesheet' => 'custom.css', 'stylesdir' => './stylesheets', 'linkcss!' => ''}
-      stylenode = xmlnodes_at_css 'html:root > head > style', output, 1
-      styles = stylenode.content
-      refute_nil styles
-      refute_empty styles.strip
-    end
-
-    test 'should convert source file and write result to adjacent file by default' do
-      sample_input_path = fixture_path('sample.asciidoc')
-      sample_output_path = fixture_path('sample.html')
-      begin
-        Asciidoctor.convert_file sample_input_path
-        assert File.exist?(sample_output_path)
-        output = IO.read(sample_output_path)
-        refute_empty output
-        assert_xpath '/html', output, 1
-        assert_xpath '/html/head', output, 1
-        assert_xpath '/html/body', output, 1
-        assert_xpath '/html/head/title[text() = "Document Title"]', output, 1
-        assert_xpath '/html/body/*[@id="header"]/h1[text() = "Document Title"]', output, 1
-      ensure
-        FileUtils.rm(sample_output_path)
-      end
-    end
-
-    test 'should convert source file and write to specified file' do
-      sample_input_path = fixture_path('sample.asciidoc')
-      sample_output_path = fixture_path('result.html')
-      begin
-        Asciidoctor.convert_file sample_input_path, :to_file => sample_output_path
-        assert File.exist?(sample_output_path)
-        output = IO.read(sample_output_path)
-        refute_empty output
-        assert_xpath '/html', output, 1
-        assert_xpath '/html/head', output, 1
-        assert_xpath '/html/body', output, 1
-        assert_xpath '/html/head/title[text() = "Document Title"]', output, 1
-        assert_xpath '/html/body/*[@id="header"]/h1[text() = "Document Title"]', output, 1
-      ensure
-        FileUtils.rm(sample_output_path)
-      end
-    end
-
-    test 'should convert source file and write to specified file in base_dir' do
-      sample_input_path = fixture_path('sample.asciidoc')
-      sample_output_path = fixture_path('result.html')
-      fixture_dir = fixture_path('')
-      begin
-        Asciidoctor.convert_file sample_input_path, :to_file => 'result.html', :base_dir => fixture_dir
-        assert File.exist?(sample_output_path)
-        output = IO.read(sample_output_path)
-        refute_empty output
-        assert_xpath '/html', output, 1
-        assert_xpath '/html/head', output, 1
-        assert_xpath '/html/body', output, 1
-        assert_xpath '/html/head/title[text() = "Document Title"]', output, 1
-        assert_xpath '/html/body/*[@id="header"]/h1[text() = "Document Title"]', output, 1
-      rescue => e
-        flunk e.message
-      ensure
-        FileUtils.rm(sample_output_path, :force => true)
-      end
-    end
-
-    test 'in_place option is ignored when to_file is specified' do
-      sample_input_path = fixture_path('sample.asciidoc')
-      sample_output_path = fixture_path('result.html')
-      begin
-        Asciidoctor.convert_file sample_input_path, :to_file => sample_output_path, :in_place => true
-        assert File.exist?(sample_output_path)
-      ensure
-        FileUtils.rm(sample_output_path) if File.exist? sample_output_path
-      end
-    end
-
-    test 'in_place option is ignored when to_dir is specified' do
-      sample_input_path = fixture_path('sample.asciidoc')
-      sample_output_path = fixture_path('sample.html')
-      begin
-        Asciidoctor.convert_file sample_input_path, :to_dir => File.dirname(sample_output_path), :in_place => true
-        assert File.exist?(sample_output_path)
-      ensure
-        FileUtils.rm(sample_output_path) if File.exist? sample_output_path
-      end
-    end
-
-    test 'output should be relative to to_dir option' do
-      sample_input_path = fixture_path('sample.asciidoc')
-      output_dir = File.join(File.dirname(sample_input_path), 'test_output')
-      Dir.mkdir output_dir if !File.exist? output_dir
-      sample_output_path = File.join(output_dir, 'sample.html')
-      begin
-        Asciidoctor.convert_file sample_input_path, :to_dir => output_dir
-        assert File.exist? sample_output_path
-      ensure
-        FileUtils.rm(sample_output_path) if File.exist? sample_output_path
-        FileUtils.rmdir output_dir
-      end
-    end
-
-    test 'missing directories should be created if mkdirs is enabled' do
-      sample_input_path = fixture_path('sample.asciidoc')
-      output_dir = File.join(File.join(File.dirname(sample_input_path), 'test_output'), 'subdir')
-      sample_output_path = File.join(output_dir, 'sample.html')
-      begin
-        Asciidoctor.convert_file sample_input_path, :to_dir => output_dir, :mkdirs => true
-        assert File.exist? sample_output_path
-      ensure
-        FileUtils.rm(sample_output_path) if File.exist? sample_output_path
-        FileUtils.rmdir output_dir
-        FileUtils.rmdir File.dirname(output_dir)
-      end
-    end
-
-    # TODO need similar test for when to_dir is specified
-    test 'should raise exception if an attempt is made to overwrite input file' do
-      sample_input_path = fixture_path('sample.asciidoc')
-
-      assert_raises IOError do
-        Asciidoctor.convert_file sample_input_path, :attributes => { 'outfilesuffix' => '.asciidoc' }
-      end
-    end
-
-    test 'to_file should be relative to to_dir when both given' do
-      sample_input_path = fixture_path('sample.asciidoc')
-      base_dir = File.dirname(sample_input_path)
-      sample_rel_output_path = File.join('test_output', 'result.html')
-      output_dir = File.dirname(File.join(base_dir, sample_rel_output_path))
-      Dir.mkdir output_dir if !File.exist? output_dir
-      sample_output_path = File.join(base_dir, sample_rel_output_path)
-      begin
-        Asciidoctor.convert_file sample_input_path, :to_dir => base_dir, :to_file => sample_rel_output_path
-        assert File.exist? sample_output_path
-      ensure
-        FileUtils.rm(sample_output_path) if File.exist? sample_output_path
-        FileUtils.rmdir output_dir
-      end
-    end
-
-    test 'should not modify options argument' do
-      options = {
-        :safe => Asciidoctor::SafeMode::SAFE,
-        :to_file => false
-      }
-      options.freeze
-      sample_input_path = fixture_path('sample.asciidoc')
-      begin
-        Asciidoctor.convert_file sample_input_path, options
-      rescue
-        flunk %(options argument should not be modified)
-      end
-    end
-  end
-
   context 'Docinfo files' do
     test 'should include docinfo files for html backend' do
       sample_input_path = fixture_path('basic.asciidoc')
@@ -1048,18 +336,17 @@ text
 
     test 'should substitute attributes in docinfo files by default' do
       sample_input_path = fixture_path 'subs.adoc'
-      output, warnings = redirect_streams do |_, err|
+      using_memory_logger do |logger|
         output = Asciidoctor.convert_file sample_input_path,
             :to_file => false,
             :header_footer => true,
             :safe => :server,
             :attributes => { 'docinfo' => '', 'bootstrap-version' => nil, 'linkcss' => '', 'attribute-missing' => 'drop-line' }
-        [output, err.string]
+        refute_empty output
+        assert_css 'script', output, 0
+        assert_xpath %(//meta[@name="copyright"][@content="(C) OpenDevise"]), output, 1
+        assert_message logger, :WARN, 'dropping line containing reference to missing attribute: bootstrap-version'
       end
-      refute_empty output
-      assert_css 'script', output, 0
-      assert_xpath %(//meta[@name="copyright"][@content="(C) OpenDevise"]), output, 1
-      assert_includes warnings, 'dropping line containing reference to missing attribute'
     end
 
     test 'should apply explicit substitutions to docinfo files' do
@@ -1134,9 +421,9 @@ text
         '/img/favicon.png' => %w(/img/favicon.png image/png)
       }.each {|val, (href, type)|
         result = render_string %(= Untitled), :attributes => { 'favicon' => val }
-        assert_css 'link[rel="shortcut icon"]', result, 1
-        assert_css %(link[rel="shortcut icon"][href="#{href}"]), result, 1
-        assert_css %(link[rel="shortcut icon"][type="#{type}"]), result, 1
+        assert_css 'link[rel="icon"]', result, 1
+        assert_css %(link[rel="icon"][href="#{href}"]), result, 1
+        assert_css %(link[rel="icon"][type="#{type}"]), result, 1
       }
     end
   end
@@ -1302,7 +589,25 @@ Block content
      assert doc.has_header?
      assert_equal 'Document Title', doc.header.title
      assert_equal 'Document Title', doc.first_section.title
-     assert_xpath '//*[@id="preamble"]//p[text()="Document Title"]', doc.render, 1
+     assert_xpath '//*[@id="preamble"]//p[text()="Document Title"]', doc.convert, 1
+    end
+
+    test 'document with blank title attribute entry overrides doctitle' do
+     input = <<-EOS
+= Document Title
+:title:
+
+{doctitle}
+
+== First Section
+     EOS
+     doc = document_from_string input
+     assert_equal '', doc.doctitle
+     assert_equal '', doc.title
+     assert doc.has_header?
+     assert_equal 'Document Title', doc.header.title
+     assert_equal 'Document Title', doc.first_section.title
+     assert_xpath '//*[@id="preamble"]//p[text()="Document Title"]', doc.convert, 1
     end
 
     test 'document with title attribute entry overrides doctitle attribute entry' do
@@ -1322,7 +627,7 @@ Block content
      assert doc.has_header?
      assert_equal 'doctitle', doc.header.title
      assert_equal 'doctitle', doc.first_section.title
-     assert_xpath '//*[@id="preamble"]//p[text()="Document Title, doctitle"]', doc.render, 1
+     assert_xpath '//*[@id="preamble"]//p[text()="Document Title, doctitle"]', doc.convert, 1
     end
 
     test 'document with doctitle attribute entry overrides header title and doctitle' do
@@ -1337,11 +642,11 @@ Block content
      EOS
      doc = document_from_string input
      assert_equal 'Override', doc.doctitle
-     assert_nil doc.title
+     assert_nil doc.attributes['title']
      assert doc.has_header?
      assert_equal 'Override', doc.header.title
      assert_equal 'Override', doc.first_section.title
-     assert_xpath '//*[@id="preamble"]//p[text()="Document Title, Override"]', doc.render, 1
+     assert_xpath '//*[@id="preamble"]//p[text()="Document Title, Override"]', doc.convert, 1
     end
 
     test 'doctitle attribute entry above header overrides header title and doctitle' do
@@ -1355,11 +660,11 @@ Block content
      EOS
      doc = document_from_string input
      assert_equal 'Override', doc.doctitle
-     assert_nil doc.title
+     assert_nil doc.attributes['title']
      assert doc.has_header?
      assert_equal 'Override', doc.header.title
      assert_equal 'Override', doc.first_section.title
-     assert_xpath '//*[@id="preamble"]//p[text()="Override"]', doc.render, 1
+     assert_xpath '//*[@id="preamble"]//p[text()="Override"]', doc.convert, 1
     end
 
     test 'should recognize document title when preceded by blank lines' do
@@ -1568,6 +873,18 @@ content
       assert_xpath '//meta[@name="author"][@content="Ze Product team"]', output, 1
     end
 
+    test 'should not double escape ampersand in author attribute' do
+      input = <<-EOS
+= Document Title
+R&D Lab
+
+{author}
+      EOS
+
+      output = render_string input
+      assert_includes output, 'R&amp;D Lab', 2
+    end
+
     test 'should include multiple authors in HTML output' do
       input = <<-EOS
 = Document Title
@@ -1605,6 +922,19 @@ content
       assert_xpath '//articleinfo/authorgroup/author[2]/firstname[text() = "Junior"]', output, 1
     end
 
+    test 'with author defined by indexed attribute name' do
+      input = <<-EOS
+= Document Title
+:author_1: Doc Writer
+
+{author}
+      EOS
+
+      doc = document_from_string input
+      assert_equal 'Doc Writer', (doc.attr 'author')
+      assert_equal 'Doc Writer', (doc.attr 'author_1')
+    end
+
     test 'with authors defined using attribute entry to DocBook' do
       input = <<-EOS
 = Document Title
@@ -1625,10 +955,50 @@ content
       assert_xpath '(//articleinfo/authorgroup/author)[2]/email[text() = "junior@asciidoc.org"]', output, 1
     end
 
+    test 'should populate copyright element in DocBook output if copyright attribute is defined' do
+      input = <<-EOS
+= Jet Bike
+:copyright: ACME, Inc.
+
+Essential for catching road runners.
+      EOS
+      output = render_string input, :backend => 'docbook5'
+      assert_xpath '/article/info/copyright', output, 1
+      assert_xpath '/article/info/copyright/holder[text()="ACME, Inc."]', output, 1
+    end
+
+    test 'should populate copyright element in DocBook output if copyright attribute is defined with year' do
+      input = <<-EOS
+= Jet Bike
+:copyright: ACME, Inc. 1956
+
+Essential for catching road runners.
+      EOS
+      output = render_string input, :backend => 'docbook5'
+      assert_xpath '/article/info/copyright', output, 1
+      assert_xpath '/article/info/copyright/holder[text()="ACME, Inc."]', output, 1
+      assert_xpath '/article/info/copyright/year', output, 1
+      assert_xpath '/article/info/copyright/year[text()="1956"]', output, 1
+    end
+
+    test 'should populate copyright element in DocBook output if copyright attribute is defined with year range' do
+      input = <<-EOS
+= Jet Bike
+:copyright: ACME, Inc. 1956-2018
+
+Essential for catching road runners.
+      EOS
+      output = render_string input, :backend => 'docbook5'
+      assert_xpath '/article/info/copyright', output, 1
+      assert_xpath '/article/info/copyright/holder[text()="ACME, Inc."]', output, 1
+      assert_xpath '/article/info/copyright/year', output, 1
+      assert_xpath '/article/info/copyright/year[text()="1956-2018"]', output, 1
+    end
+
     test 'with header footer' do
       doc = document_from_string "= Title\n\nparagraph"
       refute doc.attr?('embedded')
-      result = doc.render
+      result = doc.convert
       assert_xpath '/html', result, 1
       assert_xpath '//*[@id="header"]', result, 1
       assert_xpath '//*[@id="header"]/h1', result, 1
@@ -1649,7 +1019,7 @@ content
 
     test 'can disable last updated in footer' do
       doc = document_from_string "= Document Title\n\npreamble", :attributes => {'last-update-label!' => ''}
-      result = doc.render
+      result = doc.convert
       assert_xpath '//*[@id="footer-text"]', result, 1
       assert_xpath '//*[@id="footer-text"][normalize-space(text())=""]', result, 1
     end
@@ -1657,7 +1027,7 @@ content
     test 'no header footer' do
       doc = document_from_string "= Document Title\n\ncontent", :header_footer => false
       assert doc.attr?('embedded')
-      result = doc.render
+      result = doc.convert
       assert_xpath '/html', result, 0
       assert_xpath '/h1', result, 0
       assert_xpath '/*[@id="header"]', result, 0
@@ -1726,13 +1096,13 @@ finally a reference to the second footnote footnoteref:[note2].
       output = render_string input
       assert_css '#footnotes', output, 1
       assert_css '#footnotes .footnote', output, 2
-      assert_css '#footnotes .footnote#_footnote_1', output, 1
-      assert_xpath '//div[@id="footnotes"]/div[@id="_footnote_1"]/a[@href="#_footnoteref_1"][text()="1"]', output, 1
-      text = xmlnodes_at_xpath '//div[@id="footnotes"]/div[@id="_footnote_1"]/text()', output
+      assert_css '#footnotes .footnote#_footnotedef_1', output, 1
+      assert_xpath '//div[@id="footnotes"]/div[@id="_footnotedef_1"]/a[@href="#_footnoteref_1"][text()="1"]', output, 1
+      text = xmlnodes_at_xpath '//div[@id="footnotes"]/div[@id="_footnotedef_1"]/text()', output
       assert_equal '. An example footnote.', text.text.strip
-      assert_css '#footnotes .footnote#_footnote_2', output, 1
-      assert_xpath '//div[@id="footnotes"]/div[@id="_footnote_2"]/a[@href="#_footnoteref_2"][text()="2"]', output, 1
-      text = xmlnodes_at_xpath '//div[@id="footnotes"]/div[@id="_footnote_2"]/text()', output
+      assert_css '#footnotes .footnote#_footnotedef_2', output, 1
+      assert_xpath '//div[@id="footnotes"]/div[@id="_footnotedef_2"]/a[@href="#_footnoteref_2"][text()="2"]', output, 1
+      text = xmlnodes_at_xpath '//div[@id="footnotes"]/div[@id="_footnotedef_2"]/text()', output
       assert_equal '. Second footnote.', text.text.strip
     end
 
@@ -1744,9 +1114,9 @@ Text that has supporting information{empty}footnote:[An example footnote.].
       output = render_embedded_string input
       assert_css '#footnotes', output, 1
       assert_css '#footnotes .footnote', output, 1
-      assert_css '#footnotes .footnote#_footnote_1', output, 1
-      assert_xpath '/div[@id="footnotes"]/div[@id="_footnote_1"]/a[@href="#_footnoteref_1"][text()="1"]', output, 1
-      text = xmlnodes_at_xpath '/div[@id="footnotes"]/div[@id="_footnote_1"]/text()', output
+      assert_css '#footnotes .footnote#_footnotedef_1', output, 1
+      assert_xpath '/div[@id="footnotes"]/div[@id="_footnotedef_1"]/a[@href="#_footnoteref_1"][text()="1"]', output, 1
+      text = xmlnodes_at_xpath '/div[@id="footnotes"]/div[@id="_footnotedef_1"]/text()', output
       assert_equal '. An example footnote.', text.text.strip
     end
 
@@ -1776,12 +1146,29 @@ content{blank}footnote:[commentary]
 
       doc = document_from_string input
       refute_nil doc.catalog
-      assert_equal [:footnotes, :ids, :images, :includes, :indexterms, :links, :refs].to_set, doc.catalog.keys.to_set
+      assert_equal [:footnotes, :ids, :images, :includes, :indexterms, :links, :refs, :callouts].to_set, doc.catalog.keys.to_set
       assert_same doc.catalog, doc.references
       assert_same doc.catalog[:footnotes], doc.references[:footnotes]
       assert_same doc.catalog[:ids], doc.references[:ids]
       assert_equal 'Section A', doc.references[:ids]['_section_a']
     end
+
+    test 'should catalog assets inside nested document' do
+      input = <<-EOS
+image::outer.png[]
+
+|===
+a|
+image::inner.png[]
+|===
+      EOS
+
+      doc = document_from_string input, :catalog_assets => true
+      images = doc.catalog[:images]
+      refute_empty images
+      assert_equal 2, images.size
+      assert_equal images, ['outer.png', 'inner.png']
+    end
   end
 
   context 'Backends and Doctypes' do
@@ -1861,6 +1248,7 @@ content
 Author Name
 v1.0, 2001-01-01
 :icons:
+:favicon:
 
 image:tiger.png[]
 
@@ -2057,6 +1445,8 @@ section body
     test 'docbook5 backend doctype manpage' do
       input = <<-EOS
 = asciidoctor(1)
+:mansource: Asciidoctor
+:manmanual: Asciidoctor Manual
 
 == NAME
 
@@ -2079,6 +1469,8 @@ section body
       assert_xpath '/xmlns:refentry/xmlns:info/xmlns:title[text() = "asciidoctor(1)"]', result, 1
       assert_xpath '/xmlns:refentry/xmlns:refmeta/xmlns:refentrytitle[text() = "asciidoctor"]', result, 1
       assert_xpath '/xmlns:refentry/xmlns:refmeta/xmlns:manvolnum[text() = "1"]', result, 1
+      assert_xpath '/xmlns:refentry/xmlns:refmeta/xmlns:refmiscinfo[@class="source"][text() = "Asciidoctor"]', result, 1
+      assert_xpath '/xmlns:refentry/xmlns:refmeta/xmlns:refmiscinfo[@class="manual"][text() = "Asciidoctor Manual"]', result, 1
       assert_xpath '/xmlns:refentry/xmlns:refnamediv/xmlns:refname[text() = "asciidoctor"]', result, 1
       assert_xpath '/xmlns:refentry/xmlns:refnamediv/xmlns:refpurpose[text() = "Process text"]', result, 1
       assert_xpath '/xmlns:refentry/xmlns:refsynopsisdiv', result, 1
@@ -2093,6 +1485,23 @@ section body
       assert_equal '_first_section', id_attr.value
     end
 
+    test 'should output non-breaking space for source and manual in docbook5 manpage output if absent from source' do
+      input = <<-EOS
+= asciidoctor(1)
+
+== NAME
+
+asciidoctor - Process text
+
+== SYNOPSIS
+
+some text
+      EOS
+      result = render_string(input, :keep_namespaces => true, :attributes => {'backend' => 'docbook5', 'doctype' => 'manpage'})
+      assert_xpath %(/xmlns:refentry/xmlns:refmeta/xmlns:refmiscinfo[@class="source"][text() = "#{decode_char 160}"]), result, 1
+      assert_xpath %(/xmlns:refentry/xmlns:refmeta/xmlns:refmiscinfo[@class="manual"][text() = "#{decode_char 160}"]), result, 1
+    end
+
     test 'docbook5 backend doctype book' do
       input = <<-EOS
 = Title
@@ -2122,6 +1531,30 @@ chapter body
       assert_equal '_first_chapter', id_attr.value
     end
 
+    test 'adds refname to DocBook output for each name defined in NAME section of manpage' do
+      input = <<-EOS
+= eve(1)
+Andrew Stanton
+v1.0.0
+:doctype: manpage
+:manmanual: EVE
+:mansource: EVE
+
+== NAME
+
+eve, islifeform - analyzes an image to determine if it's a picture of a life form
+
+== SYNOPSIS
+
+*eve* ['OPTION']... 'FILE'...
+      EOS
+
+      result = render_string input, :backend => 'docbook5'
+      assert_xpath '/refentry/refnamediv/refname', result, 2
+      assert_xpath '(/refentry/refnamediv/refname)[1][text()="eve"]', result, 1
+      assert_xpath '(/refentry/refnamediv/refname)[2][text()="islifeform"]', result, 1
+    end
+
     test 'adds a front and back cover image to DocBook 5 when doctype is book' do
       input = <<-EOS
 = Title
@@ -2214,24 +1647,24 @@ preamble
 asciidoctor - converts AsciiDoc source files to HTML, DocBook and other formats
       EOS
 
-       doc = document_from_string input
-       assert_equal 'asciidoctor', doc.attr('mantitle')
-       assert_equal '1', doc.attr('manvolnum')
+      doc = document_from_string input
+      assert_equal 'asciidoctor', doc.attr('mantitle')
+      assert_equal '1', doc.attr('manvolnum')
     end
 
     test 'should perform attribute substitution on mantitle in manpage doctype' do
       input = <<-EOS
 = {app}(1)
 :doctype: manpage
-:app: asciidoctor
+:app: Asciidoctor
 
 == NAME
 
 asciidoctor - converts AsciiDoc source files to HTML, DocBook and other formats
       EOS
 
-       doc = document_from_string input
-       assert_equal 'asciidoctor', doc.attr('mantitle')
+      doc = document_from_string input
+      assert_equal 'asciidoctor', doc.attr('mantitle')
     end
 
     test 'should consume name section as manname and manpurpose for manpage doctype' do
@@ -2244,10 +1677,11 @@ asciidoctor - converts AsciiDoc source files to HTML, DocBook and other formats
 asciidoctor - converts AsciiDoc source files to HTML, DocBook and other formats
       EOS
 
-       doc = document_from_string input
-       assert_equal 'asciidoctor', doc.attr('manname')
-       assert_equal 'converts AsciiDoc source files to HTML, DocBook and other formats', doc.attr('manpurpose')
-       assert_equal 0, doc.blocks.size
+      doc = document_from_string input
+      assert_equal 'asciidoctor', doc.attr('manname')
+      assert_equal 'converts AsciiDoc source files to HTML, DocBook and other formats', doc.attr('manpurpose')
+      assert_equal '_name', doc.attr('manname-id')
+      assert_equal 0, doc.blocks.size
     end
 
     test 'should set docname and outfilesuffix from manname and manvolnum for manpage backend and doctype' do
@@ -2260,9 +1694,9 @@ asciidoctor - converts AsciiDoc source files to HTML, DocBook and other formats
 asciidoctor - converts AsciiDoc source files to HTML, DocBook and other formats
       EOS
 
-       doc = document_from_string input, :backend => 'manpage'
-       assert_equal 'asciidoctor', doc.attributes['docname']
-       assert_equal '.1', doc.attributes['outfilesuffix']
+      doc = document_from_string input, :backend => 'manpage'
+      assert_equal 'asciidoctor', doc.attributes['docname']
+      assert_equal '.1', doc.attributes['outfilesuffix']
     end
 
     test 'should mark synopsis as special section in manpage doctype' do
@@ -2279,12 +1713,12 @@ asciidoctor - converts AsciiDoc source files to HTML, DocBook and other formats
 *asciidoctor* ['OPTION']... 'FILE'..
       EOS
 
-       doc = document_from_string input
-       synopsis_section = doc.blocks.first
-       refute_nil synopsis_section
-       assert_equal :section, synopsis_section.context
-       assert synopsis_section.special
-       assert_equal 'synopsis', synopsis_section.sectname
+      doc = document_from_string input
+      synopsis_section = doc.blocks.first
+      refute_nil synopsis_section
+      assert_equal :section, synopsis_section.context
+      assert synopsis_section.special
+      assert_equal 'synopsis', synopsis_section.sectname
     end
 
     test 'should output special header block in HTML for manpage doctype' do
@@ -2305,6 +1739,7 @@ asciidoctor - converts AsciiDoc source files to HTML, DocBook and other formats
       assert_css 'body.manpage', output, 1
       assert_xpath '//body/*[@id="header"]/h1[text()="asciidoctor(1) Manual Page"]', output, 1
       assert_xpath '//body/*[@id="header"]/h1/following-sibling::h2[text()="NAME"]', output, 1
+      assert_xpath '//h2[@id="_name"][text()="NAME"]', output, 1
       assert_xpath '//h2[text()="NAME"]/following-sibling::*[@class="sectionbody"]', output, 1
       assert_xpath '//h2[text()="NAME"]/following-sibling::*[@class="sectionbody"]/p[text()="asciidoctor - converts AsciiDoc source files to HTML, DocBook and other formats"]', output, 1
       assert_xpath '//*[@id="content"]/*[@class="sect1"]/h2[text()="SYNOPSIS"]', output, 1
@@ -2328,6 +1763,7 @@ asciidoctor - converts AsciiDoc source files to HTML, DocBook and other formats
       output = render_embedded_string input
       assert_xpath '/h1[text()="asciidoctor(1) Manual Page"]', output, 1
       assert_xpath '/h1/following-sibling::h2[text()="NAME"]', output, 1
+      assert_xpath '/h2[@id="_name"][text()="NAME"]', output, 1
       assert_xpath '/h2[text()="NAME"]/following-sibling::*[@class="sectionbody"]', output, 1
       assert_xpath '/h2[text()="NAME"]/following-sibling::*[@class="sectionbody"]/p[text()="asciidoctor - converts AsciiDoc source files to HTML, DocBook and other formats"]', output, 1
     end
@@ -2342,18 +1778,23 @@ asciidoctor - converts AsciiDoc source files to HTML, DocBook and other formats
 
     test 'keeps naughty absolute paths from getting outside' do
       naughty_path = "#{disk_root}etc/passwd"
-      doc = empty_document
-      secure_path = doc.normalize_asset_path(naughty_path)
-      refute_equal naughty_path, secure_path
-      assert_match(/^#{doc.base_dir}/, secure_path)
+      using_memory_logger do |logger|
+        doc = empty_document
+        secure_path = doc.normalize_asset_path naughty_path
+        refute_equal naughty_path, secure_path
+        assert_equal (::File.join doc.base_dir, 'etc/passwd'), secure_path
+        assert_message logger, :WARN, 'path is outside of jail; recovering automatically'
+      end
     end
 
     test 'keeps naughty relative paths from getting outside' do
       naughty_path = 'safe/ok/../../../../../etc/passwd'
-      doc = empty_document
-      secure_path = redirect_streams { doc.normalize_asset_path(naughty_path) }
-      refute_equal naughty_path, secure_path
-      assert_match(/^#{doc.base_dir}/, secure_path)
+      using_memory_logger do
+        doc = empty_document
+        secure_path = doc.normalize_asset_path naughty_path
+        refute_equal naughty_path, secure_path
+        assert_match(/^#{doc.base_dir}/, secure_path)
+      end
     end
 
     test 'should raise an exception when a converter cannot be resolved before conversion' do