kramdown-asciidoc 1.0.0.alpha.10 → 1.0.0.alpha.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c9eaf28d5d26d6a4fe664121fa5d19507c9144644711cca82e348330428a1b2
-  data.tar.gz: d4a0b308bb683012ccc1ed75a54aeeb8f6ceefcf6fbabd54ce4728b34f728895
+  metadata.gz: a8a8579b7930fcfba55c49f569adfffcf2f0d4f98d324e5a928493dca246e78e
+  data.tar.gz: dca656316d4e76d2ea0169b9568ab5f54cab4a8add284f6ca24c0ff141e4918f
 SHA512:
-  metadata.gz: c2b4579e6829ae8b230ac72d9fb5f8e9880c4c40ad037784f695e916cfbd4b83353e44a8b507bd4c92baa1b3805d389420dc12944be0f283c3a30969e5444b50
-  data.tar.gz: 8a73cc65511611f3f5aa541818314bd938e5b0be9aa0f8585e3f2883065fafee1c1d96018c5a552ca6936f73ffa6ec36d67b68e7a9316a305d1ac7f6bba62ab5
+  metadata.gz: c77f10db21bbace2285b3ad00b04cdf4a45306d681739d36395a35d89b78fb5b512eb678afc9a07c965d219cddf7895a314b76e9a97d45971102b25bc976556b
+  data.tar.gz: c4938413fa37f131723e5d08ff44a0cc42c61c0586227a2f984a1c82818d34de62de8d08cf755aef6acf5719728e6de12d6162b5965e7eea2d939de0e78b7c97

data/CHANGELOG.adoc

@@ -5,6 +5,25 @@
 This document provides a high-level view of the changes to {project-name} by release.
 For a detailed view of what has changed, refer to the {uri-repo}/commits/master[commit history] on GitHub.
 
+== 1.0.0.alpha.11 (2018-08-02) - @mojavelinux
+
+=== Added
+
+* add a public API (Kramdoc.convert and Kramdoc.convert_file) for converting input strings and paths, respectively (#31)
+* update CLI to use public API (#31)
+* run test suite on Windows using AppVeyor (#32)
+* don't crash when empty comment occurs under primary text of list item
+* convert phrase enclosed in <span> (#36)
+* convert phrase enclosed in <mark>
+* convert a bare <div> to a paragraph
+* remove leading space from text if at beginning of line
+
+=== Changed
+
+* add code role to codespan if enclosed in quotes (required for AsciiDoc to parse properly) (#29)
+* use unconstrained codespan if bounded on either side by a smart quote
+* ignore auto-generated ID if heading has an explicit inline anchor
+
 == 1.0.0.alpha.10 (2018-07-16) - @mojavelinux
 
 === Added

data/README.adoc

@@ -1,6 +1,6 @@
 = {project-name} (Markdown to AsciiDoc)
 Dan Allen <https://github.com/mojavelinux>
-v1.0.0.alpha.10, 2018-07-16
+v1.0.0.alpha.11, 2018-08-02
 // Aliases:
 :project-name: Kramdown AsciiDoc
 :project-handle: kramdown-asciidoc
@@ -25,6 +25,8 @@ endif::[]
 :uri-kramdown: https://kramdown.gettalong.org
 :uri-rvm: https://rvm.io
 :uri-rvm-install: https://rvm.io/rvm/install
+:uri-ci-appveyor: https://ci.appveyor.com/project/asciidoctor/kramdown-asciidoc
+:img-ci-appveyor: https://ci.appveyor.com/api/projects/status/2pwvdbcoeux1ifb5/branch/master?svg=true
 :uri-ci-travis: https://travis-ci.org/asciidoctor/kramdown-asciidoc
 :uri-ci-travis-img: https://img.shields.io/travis/asciidoctor/kramdown-asciidoc/master.svg
 :uri-gem: https://rubygems.org/gems/kramdown-asciidoc
@@ -33,6 +35,7 @@ endif::[]
 ifdef::status[]
 image:{uri-gem-img}[Gem Version,link={uri-gem}]
 image:{uri-ci-travis-img}[Build Status (Travis CI),link={uri-ci-travis}]
+image:{img-ci-appveyor}[Build Status (AppVeyor),link={uri-ci-appveyor}]
 endif::[]
 
 {uri-repo}[{project-name}] (gem: *{project-handle}*) is a {uri-kramdown}[kramdown] extension for converting Markdown documents to {uri-asciidoc}[AsciiDoc].

data/lib/kramdown-asciidoc/api.rb

@@ -0,0 +1,27 @@
+module Kramdown; module AsciiDoc
+  LF = ?\n
+
+  def self.convert markdown, opts = {}
+    markdown = markdown.rstrip
+    markdown = markdown.slice 1, markdown.length while markdown.start_with? LF
+    attributes = (opts[:attributes] ||= {})
+    markdown = ::Kramdown::AsciiDoc.extract_front_matter markdown, attributes
+    markdown = ::Kramdown::AsciiDoc.replace_toc markdown, attributes
+    asciidoc = (::Kramdown::Document.new markdown, (::Kramdown::AsciiDoc::DEFAULT_PARSER_OPTS.merge opts)).to_asciidoc
+    asciidoc += LF unless asciidoc.empty?
+    if (to = opts[:to])
+      (to.respond_to? :write) ? (to.write asciidoc) : (::IO.write to, asciidoc)
+      nil
+    else
+      asciidoc
+    end
+  end
+
+  def self.convert_file markdown_file, opts = {}
+    markdown = ::IO.read markdown_file, mode: 'r:UTF-8', newline: :universal
+    (output_file = (::Pathname.new markdown_file).sub_ext '.adoc').dirname.mkpath
+    convert markdown, (opts.merge to: output_file)
+  end
+end; end
+
+Kramdoc = Kramdown::AsciiDoc

data/lib/kramdown-asciidoc/cli.rb

@@ -62,12 +62,12 @@ module Kramdown; module AsciiDoc
         end
 
         opts.on '-h', '--help', 'Display this help text and exit' do
-          $stdout.puts opts.help
+          $stdout.write opts.help
           return 0
         end
 
         opts.on '-v', '--version', %(Display version information and exit) do
-          $stdout.puts %(#{opts.program_name} #{VERSION})
+          $stdout.write %(#{opts.program_name} #{VERSION}\n)
           return 0
         end
       end
@@ -76,7 +76,7 @@ module Kramdown; module AsciiDoc
 
       if args.empty?
         opt_parser.warn 'Please specify a Markdown file to convert.'
-        $stdout.puts opt_parser.help
+        $stdout.write opt_parser.help
         return 1
       end
 
@@ -85,12 +85,12 @@ module Kramdown; module AsciiDoc
         [0, options]
       else
         opt_parser.warn %(extra arguments detected (unparsed arguments: #{(args.drop 1).join ' '}))
-        $stdout.puts opt_parser.help
+        $stdout.write opt_parser.help
         [1, options]
       end
     rescue ::OptionParser::InvalidOption
-      $stderr.puts %(#{opt_parser.program_name}: #{$!.message})
-      $stdout.puts opt_parser.help
+      $stderr.write %(#{opt_parser.program_name}: #{$!.message}\n)
+      $stdout.write opt_parser.help
       return 1
     end
 
@@ -99,33 +99,25 @@ module Kramdown; module AsciiDoc
       return code unless code == 0 && options
       if (input_file = options.delete :input_file) == '-'
         pipe_in = true
-        markdown = $stdin.read.rstrip
+        markdown = $stdin.read
       else
-        markdown = (::IO.read input_file, mode: 'r:UTF-8', newline: :universal).rstrip
+        markdown = ::IO.read input_file, mode: 'r:UTF-8', newline: :universal
       end
       if (output_file = options.delete :output_file)
         if output_file == '-'
           pipe_out = true
         else
-          (::Pathname.new output_file).dirname.mkpath
+          (output_file = ::Pathname.new output_file).dirname.mkpath
         end
       else
-        output_file = ((::Pathname.new input_file).sub_ext '.adoc').to_s
+        output_file = (::Pathname.new input_file).sub_ext '.adoc'
       end
-      if !(pipe_in || pipe_out) && (::File.absolute_path input_file) == (::File.absolute_path output_file)
-        $stderr.puts %(kramdoc: input and output file cannot be the same: #{input_file})
+      if !pipe_in && !pipe_out && (::File.expand_path input_file) == output_file.expand_path.to_s
+        $stderr.write %(kramdoc: input and output file cannot be the same: #{input_file}\n)
         return 1
       end
-      markdown = markdown.slice 1, markdown.length while markdown.start_with? ?\n
-      attributes = options[:attributes]
-      markdown = ::Kramdown::AsciiDoc.extract_front_matter markdown, attributes
-      markdown = ::Kramdown::AsciiDoc.replace_toc markdown, attributes
-      doc = ::Kramdown::Document.new markdown, (::Kramdown::AsciiDoc::DEFAULT_PARSER_OPTS.merge options)
-      if pipe_out
-        $stdout.puts doc.to_asciidoc
-      else
-        ::IO.write output_file, doc.to_asciidoc
-      end
+      # QUESTION should we set :from option?
+      ::Kramdoc.convert markdown, (options.merge to: (pipe_out ? $stdout : output_file))
       0
     end
   end

data/lib/kramdown-asciidoc/converter.rb

@@ -142,12 +142,13 @@ module Kramdown; module AsciiDoc
         end
         style << 'discrete'
       end
-      if (id = el.attr['id'])
-        style << %(##{id})
-      elsif (child_i = el.children[0] || VoidElement).type == :html_element && child_i.value == 'a' && (id = child_i.attr['id'])
+      if (child_i = to_element el.children[0]).type == :html_element && child_i.value == 'a' && (id = child_i.attr['id'])
         el = clone el, children: child_i.children + (el.children.drop 1)
         style << %(##{id})
-      elsif (role = el.attr['class'])
+      elsif (id = el.attr['id'])
+        style << %(##{id})
+      end
+      if (role = el.attr['class'])
         style << %(.#{role.tr ' ', '.'})
       end
       lines = []
@@ -184,7 +185,7 @@ module Kramdown; module AsciiDoc
       # NOTE detect formatted admonition marker (e.g., *Note:* ...)
       elsif (child_i.type == :strong || child_i.type == :em) &&
           (marker_el = child_i.children[0]) && ((marker = ADMON_FORMATTED_MARKERS[marker_el.value]) ||
-          ((marker = ADMON_LABELS[marker_el.value]) && (child_ii = children[1] || VoidElement).type == :text &&
+          ((marker = ADMON_LABELS[marker_el.value]) && (child_ii = to_element children[1]).type == :text &&
           ((child_ii_text = child_ii.value).start_with? ': ')))
         children = children.drop 1
         children[0] = clone child_ii, value: (child_ii_text.slice 1, child_ii_text.length) if child_ii
@@ -209,7 +210,8 @@ module Kramdown; module AsciiDoc
         if contents.size > 1 && (contents[-1].start_with? '-- ')
           attribution = (attribution_line = contents.pop).slice 3, attribution_line.length
           writer.add_line %([,#{attribution}])
-          contents.pop while contents.size > 0 && contents[-1].empty?
+          # NOTE there will be at least one non-blank line, but coerce .to_s just to be safe
+          contents.pop while contents[-1].to_s.empty?
         end
         # Q: should writer handle delimited block nesting?
         delimiter = depth > 0 ? ('____' + '__' * depth) : '_'
@@ -250,7 +252,7 @@ module Kramdown; module AsciiDoc
     end
 
     def convert_img el, opts
-      if !(parent = opts[:parent]) || parent.type == :p && parent.children.size == 1
+      if (parent = opts[:parent]).type == :p && parent.children.size == 1
         style = []
         if (id = el.attr['id'])
           style << %(##{id})
@@ -318,8 +320,9 @@ module Kramdown; module AsciiDoc
       primary_lines.unshift %(#{indent > 0 ? ' ' * indent : ''}#{marker * level} #{primary_lines.shift})
       writer.add_lines primary_lines
       unless remaining.empty?
-        next_node = remaining.find {|n| n.type != :blank }
-        el.options[:compound] = true if next_node && (BLOCK_TYPES.include? next_node.type)
+        if remaining.find {|n| (type = n.type) == :blank ? nil : ((BLOCK_TYPES.include? type) ? true : break) }
+          el.options[:compound] = true 
+        end
         traverse remaining, (opts.merge parent: el)
       end
     end
@@ -348,8 +351,9 @@ module Kramdown; module AsciiDoc
         end
       end
       unless remaining.empty?
-        next_node = remaining.find {|n| n.type != :blank }
-        el.options[:compound] = true if next_node && (BLOCK_TYPES.include? next_node.type)
+        if remaining.find {|n| (type = n.type) == :blank ? nil : ((BLOCK_TYPES.include? type) ? true : break) }
+          el.options[:compound] = true
+        end
         traverse remaining, (opts.merge parent: el)
       end
     end
@@ -425,7 +429,21 @@ module Kramdown; module AsciiDoc
     end 
 
     def convert_codespan el, opts
-      mark = (unconstrained? opts[:prev], opts[:next], :codespan) ? '``' : '`'
+      attrlist, mark = '', '`'
+      if unconstrained? (prev_el = opts[:prev]), (next_el = opts[:next])
+        mark = '``'
+      elsif next_el
+        case next_el.type
+        when :smart_quote
+          if prev_el && prev_el.type == :smart_quote
+            attrlist, mark = '[.code]', '``'
+          else
+            mark = '``'
+          end
+        when :text
+          mark = '``' if (next_el.value.chr == ?') || (prev_el && prev_el.type == :smart_quote)
+        end
+      end
       text = el.value
       pass = (replaceable? text) ? :shorthand : nil
       pass = :macro if text.include? '++'
@@ -434,13 +452,13 @@ module Kramdown; module AsciiDoc
       elsif pass == :macro
         opts[:writer].append %(#{mark}pass:c[#{text}]#{mark})
       else
-        opts[:writer].append %(#{mark}#{text}#{mark})
+        opts[:writer].append %(#{attrlist}#{mark}#{text}#{mark})
       end
     end
 
     def convert_em el, opts
       composed_text = compose_text el
-      mark = (unconstrained? opts[:prev], opts[:next], :em) ? '__' : '_'
+      mark = (unconstrained? opts[:prev], opts[:next]) ? '__' : '_'
       opts[:writer].append %(#{mark}#{composed_text}#{mark})
     end
 
@@ -449,25 +467,21 @@ module Kramdown; module AsciiDoc
         @attributes['experimental'] = ''
         opts[:writer].append %(menu:#{$1}[#{$2}])
       else
-        mark = (unconstrained? opts[:prev], opts[:next], :strong) ? '**' : '*'
+        mark = (unconstrained? opts[:prev], opts[:next]) ? '**' : '*'
         opts[:writer].append %(#{mark}#{composed_text}#{mark})
       end
     end
 
-    def unconstrained? prev_el, next_el, enclosure
-      (next_char_word? next_el, enclosure) || (prev_char_wordish? prev_el)
+    def unconstrained? prev_el, next_el
+      (next_char_word? next_el) || (prev_char_wordish? prev_el)
     end
 
     def prev_char_wordish? prev_el
       prev_el && (prev_el.type == :entity || (prev_el.type == :text && (WordishRx.match? prev_el.value[-1])))
     end
 
-    def next_char_word? next_el, enclosure
-      if next_el.type == :text
-        (WordRx.match? (next_ch = next_el.value.chr)) || (enclosure == :codespan && next_ch == ?')
-      elsif enclosure == :codespan && next_el.type == :smart_quote
-        true
-      end if next_el
+    def next_char_word? next_el
+      next_el && next_el.type == :text && (WordRx.match? next_el.value.chr)
     end
 
     def convert_text el, opts
@@ -476,7 +490,11 @@ module Kramdown; module AsciiDoc
         @attributes['pp'] = '{plus}{plus}'
         text = text.gsub '++', '{pp}'
       end
-      opts[:writer].append text
+      if (current_line = (writer = opts[:writer]).current_line).to_s.empty?
+        writer.append text.lstrip
+      else
+        writer.append text
+      end
     end
 
     def replaceable? text
@@ -503,7 +521,7 @@ module Kramdown; module AsciiDoc
         writer.append %(#{(writer.current_line.end_with? ' ') ? '' : ' '}+)
       end
       if el.options[:html_tag]
-        writer.add_blank_line unless (next_el = opts[:next] || VoidElement).type == :text && (next_el.value.start_with? LF)
+        writer.add_blank_line unless (next_el = to_element opts[:next]).type == :text && (next_el.value.start_with? LF)
       end
     end
 
@@ -522,29 +540,36 @@ module Kramdown; module AsciiDoc
 
     def convert_html_element el, opts
       if (tag = el.value) == 'div' && (child_i = el.children[0]) && child_i.options[:transparent] && (child_i_i = child_i.children[0])
-        if child_i_i.type == :img
-          convert_img child_i_i, (opts.merge parent: child_i, index: 0) if child_i.children.size == 1
-          return
-        elsif child_i_i.value == 'span' && ((role = el.attr['class'] || '').start_with? 'note') && child_i_i.attr['class'] == 'notetitle'
-          marker = ADMON_FORMATTED_MARKERS[(child_i_i.children[0] || VoidElement).value] || 'Note'
+        if child_i_i.value == 'span' && ((role = el.attr['class'].to_s).start_with? 'note') && child_i_i.attr['class'] == 'notetitle'
+          marker = ADMON_FORMATTED_MARKERS[(to_element child_i_i.children[0]).value] || 'Note'
           lines = compose_text (child_i.children.drop 1), parent: child_i, strip: true, split: true, wrap: @wrap
           lines.unshift %(#{ADMON_TYPE_MAP[marker]}: #{lines.shift})
           opts[:writer].start_block
           opts[:writer].add_lines lines
           return
+        else
+          return convert_p child_i, (opts.merge parent: el, index: 0)
         end
       end
 
       contents = compose_text el, (opts.merge strip: el.options[:category] == :block)
-      attrs = (attrs = el.attr).empty? ? '' : attrs.map {|k, v| %( #{k}="#{v}") }.join
       case tag
       when 'del'
         opts[:writer].append %([.line-through]##{contents}#)
+      when 'mark'
+        opts[:writer].append %(##{contents}#)
+      when 'span'
+        if (role = el.attr['class'])
+          opts[:writer].append %([.#{role.tr ' ', '.'}]##{contents}#)
+        else
+          opts[:writer].append contents
+        end
       when 'sup'
         opts[:writer].append %(^#{contents}^)
       when 'sub'
         opts[:writer].append %(~#{contents}~)
       else
+        attrs = (attrs = el.attr).empty? ? '' : attrs.map {|k, v| %( #{k}="#{v}") }.join
         opts[:writer].append %(+++<#{tag}#{attrs}>+++#{contents}+++</#{tag}>+++)
       end
     end
@@ -566,7 +591,7 @@ module Kramdown; module AsciiDoc
         else
           writer.add_line %(// #{lines[0]})
         end
-      else
+      elsif !lines.empty?
         if (current_line = writer.current_line) && !(current_line.end_with? LF)
           start_new_line = true
           writer.replace_line current_line.rstrip if current_line.end_with? ' '
@@ -583,7 +608,7 @@ module Kramdown; module AsciiDoc
     end
 
     def extract_prologue el, opts
-      if (child_i = (children = el.children)[0] || VoidElement).type == :xml_comment
+      if (child_i = to_element (children = el.children)[0]).type == :xml_comment
         (prologue_el = el.dup).children = children.take_while {|child| child.type == :xml_comment || child.type == :blank }
         (el = el.dup).children = children.drop prologue_el.children.size
         traverse prologue_el, (opts.merge writer: (prologue_writer = Writer.new))
@@ -600,6 +625,10 @@ module Kramdown; module AsciiDoc
       el
     end
 
+    def to_element el
+      el || VoidElement
+    end
+
     def traverse el, opts
       if ::Array === el
         nodes = el

data/lib/kramdown-asciidoc/kramdown_ext/parser/html.rb

@@ -0,0 +1,9 @@
+class Kramdown::Parser::Html::ElementConverter
+  # Overload convert_br to add the :html_tag option to indicate this br element originates from an HTML tag
+  def convert_br el
+    el.options.replace location: el.options[:location], html_tag: true
+    el.type = el.value.to_sym
+    el.value = nil
+    nil
+  end
+end

data/lib/kramdown-asciidoc/version.rb

@@ -1,3 +1,3 @@
 module Kramdown; module AsciiDoc
-  VERSION = '1.0.0.alpha.10'
+  VERSION = '1.0.0.alpha.11'
 end; end

data/lib/kramdown-asciidoc/writer.rb

@@ -60,7 +60,7 @@ module Kramdown; module AsciiDoc
     end
 
     # Q: perhaps do_in_list that takes a block?
-    def start_list compound, kin = :list
+    def start_list compound, kin
       # Q: can this be further optimized?
       @body << '' if in_list? ? compound : !empty?
       @block_separator << '+'
@@ -68,7 +68,7 @@ module Kramdown; module AsciiDoc
       nil
     end
 
-    def end_list kin = :list
+    def end_list kin
       @block_separator.pop
       @list_level[kin] -= 1
       nil
@@ -125,7 +125,7 @@ module Kramdown; module AsciiDoc
     end
 
     def to_s
-      ((@header.empty? ? @body : (@header + (@body.empty? ? [] : ['']) + @body)).join LF) + LF
+      (@header.empty? ? @body : (@header + (@body.empty? ? [] : [''] + @body))).join LF
     end
   end
 end; end

data/lib/kramdown-asciidoc.rb

@@ -1,14 +1,8 @@
 require 'kramdown'
+require_relative 'kramdown-asciidoc/kramdown_ext/parser/html'
 require_relative 'kramdown-asciidoc/core_ext/regexp/is_match'
+require_relative 'kramdown-asciidoc/api'
 require_relative 'kramdown-asciidoc/converter'
 require_relative 'kramdown-asciidoc/writer'
+autoload :Pathname, 'pathname'
 autoload :YAML, 'yaml'
-
-class Kramdown::Parser::Html::ElementConverter
-  def convert_br el
-    el.options.replace location: el.options[:location], html_tag: true
-    el.type = el.value.to_sym
-    el.value = nil
-    nil
-  end
-end

data/spec/api_spec.rb

@@ -0,0 +1,63 @@
+require_relative 'spec_helper'
+
+describe Kramdown::AsciiDoc do
+  context '#convert' do
+    it 'converts Markdown to AsciiDoc' do
+      input = <<~EOS
+      ---
+      title: Document Title
+      ---
+
+      Body content.
+      EOS
+
+      expected = <<~EOS
+      = Document Title
+
+      Body content.
+      EOS
+
+      (expect subject.convert input).to eql expected
+    end
+
+    it 'writes AsciiDoc to filename specified in :to option' do
+      the_output_file = output_file 'convert-api.adoc'
+      (expect subject.convert 'Converted using the API', to: the_output_file).to be_nil
+      (expect (IO.read the_output_file)).to eql %(Converted using the API\n)
+    end
+
+    it 'writes AsciiDoc to IO object specified in :to option' do
+      old_stdout, $stdout = $stdout, StringIO.new
+      begin
+        (expect subject.convert 'text', to: $stdout).to be_nil
+        (expect $stdout.string).to eql %(text\n)
+      ensure
+        $stdout = old_stdout
+      end
+    end
+
+    it 'adds line feed (EOL) to end of output document if non-empty' do
+      (expect subject.convert 'paragraph').to end_with ?\n
+    end
+
+    it 'does not add line feed (EOL) to end of output document if empty' do
+      (expect subject.convert '').to be_empty
+    end
+  end
+
+  context '#convert_file' do
+    it 'converts Markdown file to AsciiDoc file' do
+      the_source_file = output_file 'convert-file-api.md'
+      the_output_file = output_file 'convert-file-api.adoc'
+      IO.write the_source_file, 'Converted using the API'
+      (expect subject.convert_file the_source_file).to be_nil
+      (expect (IO.read the_output_file)).to eql %(Converted using the API\n)
+    end
+  end
+end
+
+describe Kramdoc do
+  it 'supports Kramdoc as an alias for Kramdown::AsciiDoc' do
+    (expect Kramdoc).to eql Kramdown::AsciiDoc
+  end
+end

data/spec/cli_spec.rb

@@ -1,6 +1,5 @@
 require_relative 'spec_helper'
 require 'kramdown-asciidoc/cli'
-require 'stringio'
 
 describe Kramdown::AsciiDoc::Cli do
   subject { Kramdown::AsciiDoc::Cli }
@@ -211,7 +210,7 @@ describe Kramdown::AsciiDoc::Cli do
       [#_heading-2]
       == Heading 2
 
-      [#_heading-3]
+      [#explicit-id]
       === Heading 3
 
       [#_back-to-heading-2]

data/spec/converter_spec.rb

@@ -9,9 +9,9 @@ describe Kramdown::AsciiDoc::Converter do
   context '#convert' do
     let (:input) { %(# Document Title\n\nBody text.) }
 
-    it 'adds line feed (EOL) to end of output document' do
-      (expect converter.convert root).to end_with %(\n)
-      (expect doc.to_asciidoc).to end_with %(\n)
+    it 'does not add line feed (EOL) to end of output document' do
+      (expect converter.convert root).not_to end_with ?\n
+      (expect doc.to_asciidoc).not_to end_with ?\n
     end
 
     # Q: can we find a scenario that covers this?
@@ -154,7 +154,7 @@ describe Kramdown::AsciiDoc::Converter do
       When using this technology, anything is possible.
       EOS
 
-      expected = <<~EOS
+      expected = <<~EOS.chomp
       = Introduction
       :description: An introduction to this amazing technology.
 
@@ -177,7 +177,7 @@ describe Kramdown::AsciiDoc::Converter do
       When using this technology, anything is possible.
       EOS
 
-      expected = <<~EOS
+      expected = <<~EOS.chomp
       = Introduction
       :description: An introduction to this amazing technology.
 

data/spec/scenario_spec.rb

@@ -15,7 +15,7 @@ describe 'scenario' do
       context %(for #{scenario_name}) do
         let(:input) { IO.read input_filename, mode: 'r:UTF-8', newline: :universal }
         let(:extra_options) { options }
-        let(:expected) { IO.read output_filename, mode: 'r:UTF-8', newline: :universal }
+        let(:expected) { (IO.read output_filename, mode: 'r:UTF-8', newline: :universal).chomp }
         it 'converts Markdown to AsciiDoc' do
           (expect doc.to_asciidoc).to eql expected
         end

data/spec/scenarios/blockquote/attribution-separated.md

@@ -1,4 +1,5 @@
 > Not everything that is faced can be changed.
 > But nothing can be changed until it is faced.
 >
+>
 > -- James Baldwin

data/spec/scenarios/codespan/caret.adoc

@@ -0,0 +1 @@
+`^` is often used for superscript

data/spec/scenarios/codespan/caret.md

@@ -0,0 +1 @@
+`^` is often used for superscript

data/spec/scenarios/codespan/possessive.adoc

@@ -0,0 +1,3 @@
+``lerna``'s link command
+
+``yarn``'s workspace command

data/spec/scenarios/codespan/possessive.md

@@ -0,0 +1,3 @@
+`lerna`'s link command
+
+`yarn`\'s workspace command

data/spec/scenarios/codespan/quoted.adoc

@@ -0,0 +1 @@
+use "[.code]``short``" as the attribute value

data/spec/scenarios/codespan/quoted.md

@@ -0,0 +1 @@
+use "`short`" as the attribute value

data/spec/scenarios/codespan/smart-quotes.adoc

@@ -0,0 +1 @@
+assign the value "[.code]``short``" to the attribute

data/spec/scenarios/codespan/smart-quotes.md

@@ -0,0 +1 @@
+assign the value "`short`" to the attribute