RubyGems - asciidoctor - Versions diffs - 1.5.8 → 2.0.17 - Mend

asciidoctor 1.5.8 → 2.0.17

Files changed (197) hide show

checksums.yaml +4 -4
data/.yardopts +11 -0
data/CHANGELOG.adoc +628 -45
data/LICENSE +2 -1
data/README-de.adoc +28 -38
data/README-fr.adoc +30 -43
data/README-jp.adoc +255 -201
data/README-zh_CN.adoc +40 -44
data/README.adoc +170 -143
data/asciidoctor.gemspec +22 -34
data/bin/asciidoctor +5 -4
data/data/locale/attributes-ar.adoc +4 -3
data/data/locale/attributes-be.adoc +23 -0
data/data/locale/attributes-bg.adoc +4 -3
data/data/locale/attributes-ca.adoc +6 -5
data/data/locale/attributes-cs.adoc +4 -3
data/data/locale/attributes-da.adoc +6 -5
data/data/locale/attributes-de.adoc +6 -5
data/data/locale/attributes-en.adoc +4 -4
data/data/locale/attributes-es.adoc +6 -5
data/data/locale/attributes-fa.adoc +4 -3
data/data/locale/attributes-fi.adoc +4 -3
data/data/locale/attributes-fr.adoc +8 -7
data/data/locale/attributes-hu.adoc +4 -3
data/data/locale/attributes-id.adoc +4 -3
data/data/locale/attributes-it.adoc +6 -5
data/data/locale/attributes-ja.adoc +4 -3
data/data/locale/{attributes-kr.adoc → attributes-ko.adoc} +4 -3
data/data/locale/attributes-nb.adoc +4 -3
data/data/locale/attributes-nl.adoc +6 -5
data/data/locale/attributes-nn.adoc +4 -3
data/data/locale/attributes-pl.adoc +8 -7
data/data/locale/attributes-pt.adoc +6 -5
data/data/locale/attributes-pt_BR.adoc +6 -5
data/data/locale/attributes-ro.adoc +4 -3
data/data/locale/attributes-ru.adoc +6 -5
data/data/locale/attributes-sr.adoc +4 -4
data/data/locale/attributes-sr_Latn.adoc +4 -4
data/data/locale/attributes-sv.adoc +4 -4
data/data/locale/attributes-th.adoc +23 -0
data/data/locale/attributes-tr.adoc +4 -3
data/data/locale/attributes-uk.adoc +6 -5
data/data/locale/attributes-vi.adoc +23 -0
data/data/locale/attributes-zh_CN.adoc +4 -3
data/data/locale/attributes-zh_TW.adoc +4 -3
data/data/reference/syntax.adoc +296 -0
data/data/stylesheets/asciidoctor-default.css +120 -114
data/data/stylesheets/coderay-asciidoctor.css +15 -17
data/lib/asciidoctor/abstract_block.rb +146 -140
data/lib/asciidoctor/abstract_node.rb +152 -170
data/lib/asciidoctor/attribute_list.rb +77 -89
data/lib/asciidoctor/block.rb +29 -28
data/lib/asciidoctor/callouts.rb +4 -2
data/lib/asciidoctor/cli/invoker.rb +20 -24
data/lib/asciidoctor/cli/options.rb +107 -96
data/lib/asciidoctor/cli.rb +3 -2
data/lib/asciidoctor/convert.rb +199 -0
data/lib/asciidoctor/converter/composite.rb +40 -48
data/lib/asciidoctor/converter/docbook5.rb +627 -644
data/lib/asciidoctor/converter/html5.rb +1053 -951
data/lib/asciidoctor/converter/manpage.rb +581 -532
data/lib/asciidoctor/converter/template.rb +232 -271
data/lib/asciidoctor/converter.rb +370 -185
data/lib/asciidoctor/core_ext/float/truncate.rb +20 -0
data/lib/asciidoctor/core_ext/hash/merge.rb +8 -0
data/lib/asciidoctor/core_ext/match_data/names.rb +7 -0
data/lib/asciidoctor/core_ext/nil_or_empty.rb +1 -0
data/lib/asciidoctor/core_ext/regexp/is_match.rb +4 -2
data/lib/asciidoctor/core_ext.rb +8 -17
data/lib/asciidoctor/document.rb +503 -461
data/lib/asciidoctor/extensions.rb +127 -174
data/lib/asciidoctor/helpers.rb +184 -107
data/lib/asciidoctor/inline.rb +9 -12
data/lib/asciidoctor/list.rb +11 -29
data/lib/asciidoctor/load.rb +119 -0
data/lib/asciidoctor/logging.rb +22 -17
data/lib/asciidoctor/parser.rb +673 -719
data/lib/asciidoctor/path_resolver.rb +48 -33
data/lib/asciidoctor/reader.rb +383 -338
data/lib/asciidoctor/rouge_ext.rb +39 -0
data/lib/asciidoctor/rx.rb +723 -0
data/lib/asciidoctor/section.rb +17 -16
data/lib/asciidoctor/stylesheets.rb +19 -37
data/lib/asciidoctor/substitutors.rb +926 -1022
data/lib/asciidoctor/syntax_highlighter/coderay.rb +88 -0
data/lib/asciidoctor/syntax_highlighter/highlightjs.rb +34 -0
data/lib/asciidoctor/syntax_highlighter/html_pipeline.rb +10 -0
data/lib/asciidoctor/syntax_highlighter/prettify.rb +30 -0
data/lib/asciidoctor/syntax_highlighter/pygments.rb +157 -0
data/lib/asciidoctor/syntax_highlighter/rouge.rb +143 -0
data/lib/asciidoctor/syntax_highlighter.rb +253 -0
data/lib/asciidoctor/table.rb +152 -114
data/lib/asciidoctor/timings.rb +7 -5
data/lib/asciidoctor/version.rb +2 -1
data/lib/asciidoctor/writer.rb +30 -0
data/lib/asciidoctor.rb +266 -1340
data/man/asciidoctor.1 +49 -47
data/man/asciidoctor.adoc +54 -45
metadata +50 -245
data/CONTRIBUTING.adoc +0 -185
data/Gemfile +0 -60
data/Rakefile +0 -129
data/bin/asciidoctor-safe +0 -15
data/features/open_block.feature +0 -92
data/features/pass_block.feature +0 -66
data/features/step_definitions.rb +0 -49
data/features/text_formatting.feature +0 -57
data/features/xref.feature +0 -1039
data/lib/asciidoctor/converter/base.rb +0 -59
data/lib/asciidoctor/converter/docbook45.rb +0 -93
data/lib/asciidoctor/converter/factory.rb +0 -226
data/lib/asciidoctor/core_ext/1.8.7/base64/strict_encode64.rb +0 -6
data/lib/asciidoctor/core_ext/1.8.7/concurrent/hash.rb +0 -5
data/lib/asciidoctor/core_ext/1.8.7/hash/key.rb +0 -4
data/lib/asciidoctor/core_ext/1.8.7/io/binread.rb +0 -6
data/lib/asciidoctor/core_ext/1.8.7/io/write.rb +0 -5
data/lib/asciidoctor/core_ext/1.8.7/string/chr.rb +0 -6
data/lib/asciidoctor/core_ext/1.8.7/string/limit_bytesize.rb +0 -29
data/lib/asciidoctor/core_ext/1.8.7/symbol/empty.rb +0 -6
data/lib/asciidoctor/core_ext/1.8.7/symbol/length.rb +0 -6
data/lib/asciidoctor/core_ext/string/limit_bytesize.rb +0 -10
data/test/api_test.rb +0 -1240
data/test/attribute_list_test.rb +0 -242
data/test/attributes_test.rb +0 -1623
data/test/blocks_test.rb +0 -3870
data/test/converter_test.rb +0 -470
data/test/document_test.rb +0 -1853
data/test/extensions_test.rb +0 -1560
data/test/fixtures/asciidoc_index.txt +0 -521
data/test/fixtures/basic-docinfo-footer.html +0 -6
data/test/fixtures/basic-docinfo-footer.xml +0 -8
data/test/fixtures/basic-docinfo.html +0 -1
data/test/fixtures/basic-docinfo.xml +0 -4
data/test/fixtures/basic.asciidoc +0 -5
data/test/fixtures/chapter-a.adoc +0 -3
data/test/fixtures/child-include.adoc +0 -5
data/test/fixtures/circle.svg +0 -9
data/test/fixtures/custom-backends/erb/html5/block_paragraph.html.erb +0 -6
data/test/fixtures/custom-backends/haml/docbook45/block_paragraph.xml.haml +0 -6
data/test/fixtures/custom-backends/haml/html5/block_paragraph.html.haml +0 -3
data/test/fixtures/custom-backends/haml/html5/block_sidebar.html.haml +0 -5
data/test/fixtures/custom-backends/haml/html5-tweaks/block_paragraph.html.haml +0 -1
data/test/fixtures/custom-backends/slim/docbook45/block_paragraph.xml.slim +0 -6
data/test/fixtures/custom-backends/slim/html5/block_paragraph.html.slim +0 -3
data/test/fixtures/custom-backends/slim/html5/block_sidebar.html.slim +0 -5
data/test/fixtures/custom-docinfodir/basic-docinfo.html +0 -1
data/test/fixtures/custom-docinfodir/docinfo.html +0 -1
data/test/fixtures/docinfo-footer.html +0 -1
data/test/fixtures/docinfo-footer.xml +0 -9
data/test/fixtures/docinfo.html +0 -1
data/test/fixtures/docinfo.xml +0 -3
data/test/fixtures/doctime-localtime.adoc +0 -2
data/test/fixtures/dot.gif +0 -0
data/test/fixtures/encoding.asciidoc +0 -13
data/test/fixtures/file-with-missing-include.adoc +0 -1
data/test/fixtures/grandchild-include.adoc +0 -3
data/test/fixtures/hello-asciidoctor.pdf +0 -69
data/test/fixtures/include-file.asciidoc +0 -24
data/test/fixtures/include-file.jsx +0 -8
data/test/fixtures/include-file.ml +0 -3
data/test/fixtures/include-file.xml +0 -5
data/test/fixtures/lists.adoc +0 -96
data/test/fixtures/master.adoc +0 -5
data/test/fixtures/mismatched-end-tag.adoc +0 -7
data/test/fixtures/other-chapters.adoc +0 -11
data/test/fixtures/outer-include.adoc +0 -5
data/test/fixtures/parent-include-restricted.adoc +0 -5
data/test/fixtures/parent-include.adoc +0 -5
data/test/fixtures/sample.asciidoc +0 -30
data/test/fixtures/section-a.adoc +0 -4
data/test/fixtures/stylesheets/custom.css +0 -3
data/test/fixtures/subdir/index.adoc +0 -3
data/test/fixtures/subdir/inner-include.adoc +0 -3
data/test/fixtures/subdir/middle-include.adoc +0 -5
data/test/fixtures/subs-docinfo.html +0 -2
data/test/fixtures/subs.adoc +0 -6
data/test/fixtures/tagged-class-enclosed.rb +0 -25
data/test/fixtures/tagged-class.rb +0 -23
data/test/fixtures/tip.gif +0 -0
data/test/fixtures/unclosed-tag.adoc +0 -3
data/test/fixtures/unexpected-end-tag.adoc +0 -4
data/test/invoker_test.rb +0 -745
data/test/links_test.rb +0 -855
data/test/lists_test.rb +0 -5151
data/test/logger_test.rb +0 -211
data/test/manpage_test.rb +0 -660
data/test/options_test.rb +0 -262
data/test/paragraphs_test.rb +0 -562
data/test/parser_test.rb +0 -742
data/test/paths_test.rb +0 -395
data/test/preamble_test.rb +0 -173
data/test/reader_test.rb +0 -2161
data/test/sections_test.rb +0 -3575
data/test/substitutions_test.rb +0 -2066
data/test/tables_test.rb +0 -2036
data/test/test_helper.rb +0 -447
data/test/text_test.rb +0 -309

data/lib/asciidoctor/converter/html5.rb CHANGED Viewed

@@ -1,227 +1,272 @@
-# encoding: UTF-8
+# frozen_string_literal: true
 module Asciidoctor
-  # A built-in {Converter} implementation that generates HTML 5 output
-  # consistent with the html5 backend from AsciiDoc Python.
-  class Converter::Html5Converter < Converter::BuiltIn
-    (QUOTE_TAGS = {
-      :monospaced  => ['<code>',   '</code>',   true],
-      :emphasis    => ['<em>',     '</em>',     true],
-      :strong      => ['<strong>', '</strong>', true],
-      :double      => ['&#8220;',  '&#8221;',   false],
-      :single      => ['&#8216;',  '&#8217;',   false],
-      :mark        => ['<mark>',   '</mark>',   true],
-      :superscript => ['<sup>',    '</sup>',    true],
-      :subscript   => ['<sub>',    '</sub>',    true],
-      :asciimath   => ['\$',       '\$',        false],
-      :latexmath   => ['\(',       '\)',        false]
-      # Opal can't resolve these constants when referenced here
-      #:asciimath   => INLINE_MATH_DELIMITERS[:asciimath] + [false],
-      #:latexmath   => INLINE_MATH_DELIMITERS[:latexmath] + [false]
-    }).default = ['', '', false]
-    DropAnchorRx = /<(?:a[^>+]+|\/a)>/
-    StemBreakRx = / *\\\n(?:\\?\n)*|\n\n+/
-    SvgPreambleRx = /\A.*?(?=<svg\b)/m
-    SvgStartTagRx = /\A<svg[^>]*>/
-    DimensionAttributeRx = /\s(?:width|height|style)=(["']).*?\1/
-    def initialize backend, opts = {}
-      @xml_mode = opts[:htmlsyntax] == 'xml'
-      @void_element_slash = @xml_mode ? '/' : nil
-      @stylesheets = Stylesheets.instance
+# A built-in {Converter} implementation that generates HTML 5 output
+# consistent with the html5 backend from AsciiDoc.py.
+class Converter::Html5Converter < Converter::Base
+  register_for 'html5'
+  (QUOTE_TAGS = {
+    monospaced:  ['<code>', '</code>', true],
+    emphasis:    ['<em>', '</em>', true],
+    strong:      ['<strong>', '</strong>', true],
+    double:      ['&#8220;', '&#8221;'],
+    single:      ['&#8216;', '&#8217;'],
+    mark:        ['<mark>', '</mark>', true],
+    superscript: ['<sup>', '</sup>', true],
+    subscript:   ['<sub>', '</sub>', true],
+    asciimath:   ['\$', '\$'],
+    latexmath:   ['\(', '\)'],
+    # Opal can't resolve these constants when referenced here
+    #asciimath:  INLINE_MATH_DELIMITERS[:asciimath] + [false],
+    #latexmath:  INLINE_MATH_DELIMITERS[:latexmath] + [false],
+  }).default = ['', '']
+  DropAnchorRx = %r(<(?:a\b[^>]*|/a)>)
+  StemBreakRx = / *\\\n(?:\\?\n)*|\n\n+/
+  if RUBY_ENGINE == 'opal'
+    # NOTE In JavaScript, ^ matches the start of the string when the m flag is not set
+    SvgPreambleRx = /^#{CC_ALL}*?(?=<svg[\s>])/
+    SvgStartTagRx = /^<svg(?:\s[^>]*)?>/
+  else
+    SvgPreambleRx = /\A.*?(?=<svg[\s>])/m
+    SvgStartTagRx = /\A<svg(?:\s[^>]*)?>/
+  end
+  DimensionAttributeRx = /\s(?:width|height|style)=(["'])#{CC_ANY}*?\1/
+  def initialize backend, opts = {}
+    @backend = backend
+    if opts[:htmlsyntax] == 'xml'
+      syntax = 'xml'
+      @xml_mode = true
+      @void_element_slash = '/'
+    else
+      syntax = 'html'
+      @xml_mode = nil
+      @void_element_slash = ''
     end
+    init_backend_traits basebackend: 'html', filetype: 'html', htmlsyntax: syntax, outfilesuffix: '.html', supports_templates: true
+  end
-    def document node
-      slash = @void_element_slash
-      br = %(<br#{slash}>)
-      unless (asset_uri_scheme = (node.attr 'asset-uri-scheme', 'https')).empty?
-        asset_uri_scheme = %(#{asset_uri_scheme}:)
-      end
-      cdn_base = %(#{asset_uri_scheme}//cdnjs.cloudflare.com/ajax/libs)
-      linkcss = node.attr? 'linkcss'
-      result = ['<!DOCTYPE html>']
-      lang_attribute = (node.attr? 'nolang') ? '' : %( lang="#{node.attr 'lang', 'en'}")
-      result << %(<html#{@xml_mode ? ' xmlns="http://www.w3.org/1999/xhtml"' : ''}#{lang_attribute}>)
-      result << %(<head>
+  def convert node, transform = node.node_name, opts = nil
+    case transform
+    when 'inline_quoted' then convert_inline_quoted node
+    when 'paragraph' then convert_paragraph node
+    when 'inline_anchor' then convert_inline_anchor node
+    when 'section' then convert_section node
+    when 'listing' then convert_listing node
+    when 'literal' then convert_literal node
+    when 'ulist' then convert_ulist node
+    when 'olist' then convert_olist node
+    when 'dlist' then convert_dlist node
+    when 'admonition' then convert_admonition node
+    when 'colist' then convert_colist node
+    when 'embedded' then convert_embedded node
+    when 'example' then convert_example node
+    when 'floating_title' then convert_floating_title node
+    when 'image' then convert_image node
+    when 'inline_break' then convert_inline_break node
+    when 'inline_button' then convert_inline_button node
+    when 'inline_callout' then convert_inline_callout node
+    when 'inline_footnote' then convert_inline_footnote node
+    when 'inline_image' then convert_inline_image node
+    when 'inline_indexterm' then convert_inline_indexterm node
+    when 'inline_kbd' then convert_inline_kbd node
+    when 'inline_menu' then convert_inline_menu node
+    when 'open' then convert_open node
+    when 'page_break' then convert_page_break node
+    when 'preamble' then convert_preamble node
+    when 'quote' then convert_quote node
+    when 'sidebar' then convert_sidebar node
+    when 'stem' then convert_stem node
+    when 'table' then convert_table node
+    when 'thematic_break' then convert_thematic_break node
+    when 'verse' then convert_verse node
+    when 'video' then convert_video node
+    when 'document' then convert_document node
+    when 'toc' then convert_toc node
+    when 'pass' then convert_pass node
+    when 'audio' then convert_audio node
+    else; super
+    end
+  end
+  def convert_document node
+    br = %(<br#{slash = @void_element_slash}>)
+    unless (asset_uri_scheme = (node.attr 'asset-uri-scheme', 'https')).empty?
+      asset_uri_scheme = %(#{asset_uri_scheme}:)
+    end
+    cdn_base_url = %(#{asset_uri_scheme}//cdnjs.cloudflare.com/ajax/libs)
+    linkcss = node.attr? 'linkcss'
+    max_width_attr = (node.attr? 'max-width') ? %( style="max-width: #{node.attr 'max-width'};") : ''
+    result = ['<!DOCTYPE html>']
+    lang_attribute = (node.attr? 'nolang') ? '' : %( lang="#{node.attr 'lang', 'en'}")
+    result << %(<html#{@xml_mode ? ' xmlns="http://www.w3.org/1999/xhtml"' : ''}#{lang_attribute}>)
+    result << %(<head>
 <meta charset="#{node.attr 'encoding', 'UTF-8'}"#{slash}>
-<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"#{slash}><![endif]-->
+<meta http-equiv="X-UA-Compatible" content="IE=edge"#{slash}>
 <meta name="viewport" content="width=device-width, initial-scale=1.0"#{slash}>
 <meta name="generator" content="Asciidoctor #{node.attr 'asciidoctor-version'}"#{slash}>)
-      result << %(<meta name="application-name" content="#{node.attr 'app-name'}"#{slash}>) if node.attr? 'app-name'
-      result << %(<meta name="description" content="#{node.attr 'description'}"#{slash}>) if node.attr? 'description'
-      result << %(<meta name="keywords" content="#{node.attr 'keywords'}"#{slash}>) if node.attr? 'keywords'
-      result << %(<meta name="author" content="#{((authors = node.attr 'authors').include? '<') ? (authors.gsub XmlSanitizeRx, '') : authors}"#{slash}>) if node.attr? 'authors'
-      result << %(<meta name="copyright" content="#{node.attr 'copyright'}"#{slash}>) if node.attr? 'copyright'
-      if node.attr? 'favicon'
-        if (icon_href = node.attr 'favicon').empty?
-          icon_href, icon_type = 'favicon.ico', 'image/x-icon'
-        else
-          icon_type = (icon_ext = ::File.extname icon_href) == '.ico' ? 'image/x-icon' : %(image/#{icon_ext.slice 1, icon_ext.length})
-        end
-        result << %(<link rel="icon" type="#{icon_type}" href="#{icon_href}"#{slash}>)
+    result << %(<meta name="application-name" content="#{node.attr 'app-name'}"#{slash}>) if node.attr? 'app-name'
+    result << %(<meta name="description" content="#{node.attr 'description'}"#{slash}>) if node.attr? 'description'
+    result << %(<meta name="keywords" content="#{node.attr 'keywords'}"#{slash}>) if node.attr? 'keywords'
+    result << %(<meta name="author" content="#{((authors = node.sub_replacements node.attr 'authors').include? '<') ? (authors.gsub XmlSanitizeRx, '') : authors}"#{slash}>) if node.attr? 'authors'
+    result << %(<meta name="copyright" content="#{node.attr 'copyright'}"#{slash}>) if node.attr? 'copyright'
+    if node.attr? 'favicon'
+      if (icon_href = node.attr 'favicon').empty?
+        icon_href = 'favicon.ico'
+        icon_type = 'image/x-icon'
+      elsif (icon_ext = Helpers.extname icon_href, nil)
+        icon_type = icon_ext == '.ico' ? 'image/x-icon' : %(image/#{icon_ext.slice 1, icon_ext.length})
+      else
+        icon_type = 'image/x-icon'
       end
-      result << %(<title>#{node.doctitle :sanitize => true, :use_fallback => true}</title>)
+      result << %(<link rel="icon" type="#{icon_type}" href="#{icon_href}"#{slash}>)
+    end
+    result << %(<title>#{node.doctitle sanitize: true, use_fallback: true}</title>)
-      if DEFAULT_STYLESHEET_KEYS.include?(node.attr 'stylesheet')
-        if (webfonts = node.attr 'webfonts')
-          result << %(<link rel="stylesheet" href="#{asset_uri_scheme}//fonts.googleapis.com/css?family=#{webfonts.empty? ? 'Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700' : webfonts}"#{slash}>)
-        end
-        if linkcss
-          result << %(<link rel="stylesheet" href="#{node.normalize_web_path DEFAULT_STYLESHEET_NAME, (node.attr 'stylesdir', ''), false}"#{slash}>)
-        else
-          result << @stylesheets.embed_primary_stylesheet
-        end
-      elsif node.attr? 'stylesheet'
-        if linkcss
-          result << %(<link rel="stylesheet" href="#{node.normalize_web_path((node.attr 'stylesheet'), (node.attr 'stylesdir', ''))}"#{slash}>)
-        else
-          result << %(<style>
-#{node.read_asset node.normalize_system_path((node.attr 'stylesheet'), (node.attr 'stylesdir', '')), :warn_on_failure => true, :label => 'stylesheet'}
+    if DEFAULT_STYLESHEET_KEYS.include?(node.attr 'stylesheet')
+      if (webfonts = node.attr 'webfonts')
+        result << %(<link rel="stylesheet" href="#{asset_uri_scheme}//fonts.googleapis.com/css?family=#{webfonts.empty? ? 'Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700' : webfonts}"#{slash}>)
+      end
+      if linkcss
+        result << %(<link rel="stylesheet" href="#{node.normalize_web_path DEFAULT_STYLESHEET_NAME, (node.attr 'stylesdir', ''), false}"#{slash}>)
+      else
+        result << %(<style>
+#{Stylesheets.instance.primary_stylesheet_data}
 </style>)
-        end
       end
-      if node.attr? 'icons', 'font'
-        if node.attr? 'iconfont-remote'
-          result << %(<link rel="stylesheet" href="#{node.attr 'iconfont-cdn', %[#{cdn_base}/font-awesome/#{FONT_AWESOME_VERSION}/css/font-awesome.min.css]}"#{slash}>)
-        else
-          iconfont_stylesheet = %(#{node.attr 'iconfont-name', 'font-awesome'}.css)
-          result << %(<link rel="stylesheet" href="#{node.normalize_web_path iconfont_stylesheet, (node.attr 'stylesdir', ''), false}"#{slash}>)
-        end
+    elsif node.attr? 'stylesheet'
+      if linkcss
+        result << %(<link rel="stylesheet" href="#{node.normalize_web_path((node.attr 'stylesheet'), (node.attr 'stylesdir', ''))}"#{slash}>)
+      else
+        result << %(<style>
+#{node.read_contents (node.attr 'stylesheet'), start: (node.attr 'stylesdir'), warn_on_failure: true, label: 'stylesheet'}
+</style>)
       end
+    end
-      case (highlighter = node.attr 'source-highlighter')
-      when 'coderay'
-        if (node.attr 'coderay-css', 'class') == 'class'
-          if linkcss
-            result << %(<link rel="stylesheet" href="#{node.normalize_web_path @stylesheets.coderay_stylesheet_name, (node.attr 'stylesdir', ''), false}"#{slash}>)
-          else
-            result << @stylesheets.embed_coderay_stylesheet
-          end
-        end
-      when 'pygments'
-        if (node.attr 'pygments-css', 'class') == 'class'
-          pygments_style = node.attr 'pygments-style'
-          if linkcss
-            result << %(<link rel="stylesheet" href="#{node.normalize_web_path @stylesheets.pygments_stylesheet_name(pygments_style), (node.attr 'stylesdir', ''), false}"#{slash}>)
-          else
-            result << (@stylesheets.embed_pygments_stylesheet pygments_style)
-          end
-        end
+    if node.attr? 'icons', 'font'
+      if node.attr? 'iconfont-remote'
+        result << %(<link rel="stylesheet" href="#{node.attr 'iconfont-cdn', %[#{cdn_base_url}/font-awesome/#{FONT_AWESOME_VERSION}/css/font-awesome.min.css]}"#{slash}>)
+      else
+        iconfont_stylesheet = %(#{node.attr 'iconfont-name', 'font-awesome'}.css)
+        result << %(<link rel="stylesheet" href="#{node.normalize_web_path iconfont_stylesheet, (node.attr 'stylesdir', ''), false}"#{slash}>)
       end
+    end
-      unless (docinfo_content = node.docinfo).empty?
-        result << docinfo_content
-      end
+    if (syntax_hl = node.syntax_highlighter)
+      result << (syntax_hl_docinfo_head_idx = result.size)
+    end
-      result << '</head>'
-      body_attrs = node.id ? [%(id="#{node.id}")] : []
-      if (sectioned = node.sections?) && (node.attr? 'toc-class') && (node.attr? 'toc') && (node.attr? 'toc-placement', 'auto')
-        classes = [node.doctype, (node.attr 'toc-class'), %(toc-#{node.attr 'toc-position', 'header'})]
-      else
-        classes = [node.doctype]
-      end
-      classes << (node.attr 'docrole') if node.attr? 'docrole'
-      body_attrs << %(class="#{classes.join ' '}")
-      body_attrs << %(style="max-width: #{node.attr 'max-width'};") if node.attr? 'max-width'
-      result << %(<body #{body_attrs.join ' '}>)
-      unless node.noheader
-        result << '<div id="header">'
-        if node.doctype == 'manpage'
-          result << %(<h1>#{node.doctitle} Manual Page</h1>)
-          if sectioned && (node.attr? 'toc') && (node.attr? 'toc-placement', 'auto')
-            result << %(<div id="toc" class="#{node.attr 'toc-class', 'toc'}">
+    unless (docinfo_content = node.docinfo).empty?
+      result << docinfo_content
+    end
+    result << '</head>'
+    id_attr = node.id ? %( id="#{node.id}") : ''
+    if (sectioned = node.sections?) && (node.attr? 'toc-class') && (node.attr? 'toc') && (node.attr? 'toc-placement', 'auto')
+      classes = [node.doctype, (node.attr 'toc-class'), %(toc-#{node.attr 'toc-position', 'header'})]
+    else
+      classes = [node.doctype]
+    end
+    classes << node.role if node.role?
+    result << %(<body#{id_attr} class="#{classes.join ' '}">)
+    unless (docinfo_content = node.docinfo :header).empty?
+      result << docinfo_content
+    end
+    unless node.noheader
+      result << %(<div id="header"#{max_width_attr}>)
+      if node.doctype == 'manpage'
+        result << %(<h1>#{node.doctitle} Manual Page</h1>)
+        if sectioned && (node.attr? 'toc') && (node.attr? 'toc-placement', 'auto')
+          result << %(<div id="toc" class="#{node.attr 'toc-class', 'toc'}">
 <div id="toctitle">#{node.attr 'toc-title'}</div>
-#{outline node}
+#{node.converter.convert node, 'outline'}
 </div>)
+        end
+        result << (generate_manname_section node) if node.attr? 'manpurpose'
+      else
+        if node.header?
+          result << %(<h1>#{node.header.title}</h1>) unless node.notitle
+          details = []
+          idx = 1
+          node.authors.each do |author|
+            details << %(<span id="author#{idx > 1 ? idx : ''}" class="author">#{node.sub_replacements author.name}</span>#{br})
+            details << %(<span id="email#{idx > 1 ? idx : ''}" class="email">#{node.sub_macros author.email}</span>#{br}) if author.email
+            idx += 1
           end
-          result << (generate_manname_section node) if node.attr? 'manpurpose'
-        else
-          if node.has_header?
-            result << %(<h1>#{node.header.title}</h1>) unless node.notitle
-            details = []
-            idx = 1
-            node.authors.each do |author|
-              details << %(<span id="author#{idx > 1 ? idx : ''}" class="author">#{author.name}</span>#{br})
-              details << %(<span id="email#{idx > 1 ? idx : ''}" class="email">#{node.sub_macros author.email}</span>#{br}) if author.email
-              idx += 1
-            end
-            if node.attr? 'revnumber'
-              details << %(<span id="revnumber">#{((node.attr 'version-label') || '').downcase} #{node.attr 'revnumber'}#{(node.attr? 'revdate') ? ',' : ''}</span>)
-            end
-            if node.attr? 'revdate'
-              details << %(<span id="revdate">#{node.attr 'revdate'}</span>)
-            end
-            if node.attr? 'revremark'
-              details << %(#{br}<span id="revremark">#{node.attr 'revremark'}</span>)
-            end
-            unless details.empty?
-              result << '<div class="details">'
-              result.concat details
-              result << '</div>'
-            end
+          if node.attr? 'revnumber'
+            details << %(<span id="revnumber">#{((node.attr 'version-label') || '').downcase} #{node.attr 'revnumber'}#{(node.attr? 'revdate') ? ',' : ''}</span>)
+          end
+          if node.attr? 'revdate'
+            details << %(<span id="revdate">#{node.attr 'revdate'}</span>)
+          end
+          if node.attr? 'revremark'
+            details << %(#{br}<span id="revremark">#{node.attr 'revremark'}</span>)
           end
+          unless details.empty?
+            result << '<div class="details">'
+            result.concat details
+            result << '</div>'
+          end
+        end
-          if sectioned && (node.attr? 'toc') && (node.attr? 'toc-placement', 'auto')
-            result << %(<div id="toc" class="#{node.attr 'toc-class', 'toc'}">
+        if sectioned && (node.attr? 'toc') && (node.attr? 'toc-placement', 'auto')
+          result << %(<div id="toc" class="#{node.attr 'toc-class', 'toc'}">
 <div id="toctitle">#{node.attr 'toc-title'}</div>
-#{outline node}
+#{node.converter.convert node, 'outline'}
 </div>)
-          end
         end
-        result << '</div>'
       end
+      result << '</div>'
+    end
-      result << %(<div id="content">
+    result << %(<div id="content"#{max_width_attr}>
 #{node.content}
 </div>)
-      if node.footnotes? && !(node.attr? 'nofootnotes')
-        result << %(<div id="footnotes">
+    if node.footnotes? && !(node.attr? 'nofootnotes')
+      result << %(<div id="footnotes"#{max_width_attr}>
 <hr#{slash}>)
-        node.footnotes.each do |footnote|
-          result << %(<div class="footnote" id="_footnotedef_#{footnote.index}">
+      node.footnotes.each do |footnote|
+        result << %(<div class="footnote" id="_footnotedef_#{footnote.index}">
 <a href="#_footnoteref_#{footnote.index}">#{footnote.index}</a>. #{footnote.text}
 </div>)
-        end
-        result << '</div>'
       end
+      result << '</div>'
+    end
-      unless node.nofooter
-        result << '<div id="footer">'
-        result << '<div id="footer-text">'
-        result << %(#{node.attr 'version-label'} #{node.attr 'revnumber'}#{br}) if node.attr? 'revnumber'
-        result << %(#{node.attr 'last-update-label'} #{node.attr 'docdatetime'}) if (node.attr? 'last-update-label') && !(node.attr? 'reproducible')
-        result << '</div>'
-        result << '</div>'
-      end
+    unless node.nofooter
+      result << %(<div id="footer"#{max_width_attr}>)
+      result << '<div id="footer-text">'
+      result << %(#{node.attr 'version-label'} #{node.attr 'revnumber'}#{br}) if node.attr? 'revnumber'
+      result << %(#{node.attr 'last-update-label'} #{node.attr 'docdatetime'}) if (node.attr? 'last-update-label') && !(node.attr? 'reproducible')
+      result << '</div>'
+      result << '</div>'
+    end
-      unless (docinfo_content = node.docinfo :footer).empty?
-        result << docinfo_content
-      end
+    # JavaScript (and auxiliary stylesheets) loaded at the end of body for performance reasons
+    # See http://www.html5rocks.com/en/tutorials/speed/script-loading/
-      # Load Javascript at the end of body for performance
-      # See http://www.html5rocks.com/en/tutorials/speed/script-loading/
-      case highlighter
-      when 'highlightjs', 'highlight.js'
-        highlightjs_path = node.attr 'highlightjsdir', %(#{cdn_base}/highlight.js/9.13.1)
-        result << %(<link rel="stylesheet" href="#{highlightjs_path}/styles/#{node.attr 'highlightjs-theme', 'github'}.min.css"#{slash}>)
-        result << %(<script src="#{highlightjs_path}/highlight.min.js"></script>
-<script>hljs.initHighlighting()</script>)
-      when 'prettify'
-        prettify_path = node.attr 'prettifydir', %(#{cdn_base}/prettify/r298)
-        result << %(<link rel="stylesheet" href="#{prettify_path}/#{node.attr 'prettify-theme', 'prettify'}.min.css"#{slash}>)
-        result << %(<script src="#{prettify_path}/prettify.min.js"></script>
-<script>prettyPrint()</script>)
+    if syntax_hl
+      if syntax_hl.docinfo? :head
+        result[syntax_hl_docinfo_head_idx] = syntax_hl.docinfo :head, node, cdn_base_url: cdn_base_url, linkcss: linkcss, self_closing_tag_slash: slash
+      else
+        result.delete_at syntax_hl_docinfo_head_idx
       end
+      if syntax_hl.docinfo? :footer
+        result << (syntax_hl.docinfo :footer, node, cdn_base_url: cdn_base_url, linkcss: linkcss, self_closing_tag_slash: slash)
+      end
+    end
-      if node.attr? 'stem'
-        eqnums_val = node.attr 'eqnums', 'none'
-        eqnums_val = 'AMS' if eqnums_val.empty?
-        eqnums_opt = %( equationNumbers: { autoNumber: "#{eqnums_val}" } )
-        # IMPORTANT inspect calls on delimiter arrays are intentional for JavaScript compat (emulates JSON.stringify)
-        result << %(<script type="text/x-mathjax-config">
+    if node.attr? 'stem'
+      eqnums_val = node.attr 'eqnums', 'none'
+      eqnums_val = 'AMS' if eqnums_val.empty?
+      eqnums_opt = %( equationNumbers: { autoNumber: "#{eqnums_val}" } )
+      # IMPORTANT inspect calls on delimiter arrays are intentional for JavaScript compat (emulates JSON.stringify)
+      result << %(<script type="text/x-mathjax-config">
 MathJax.Hub.Config({
   messageStyle: "none",
   tex2jax: {
@@ -234,157 +279,169 @@ MathJax.Hub.Config({
     ignoreClass: "nostem|noasciimath"
   },
   TeX: {#{eqnums_opt}}
-});
+})
+MathJax.Hub.Register.StartupHook("AsciiMath Jax Ready", function () {
+  MathJax.InputJax.AsciiMath.postfilterHooks.Add(function (data, node) {
+    if ((node = data.script.parentNode) && (node = node.parentNode) && node.classList.contains("stemblock")) {
+      data.math.root.display = "block"
+    }
+    return data
+  })
+})
 </script>
-<script src="#{cdn_base}/mathjax/#{MATHJAX_VERSION}/MathJax.js?config=TeX-MML-AM_HTMLorMML"></script>)
-      end
+<script src="#{cdn_base_url}/mathjax/#{MATHJAX_VERSION}/MathJax.js?config=TeX-MML-AM_HTMLorMML"></script>)
+    end
-      result << '</body>'
-      result << '</html>'
-      result.join LF
+    unless (docinfo_content = node.docinfo :footer).empty?
+      result << docinfo_content
     end
-    def embedded node
-      result = []
-      if node.doctype == 'manpage'
-        # QUESTION should notitle control the manual page title?
-        unless node.notitle
-          id_attr = node.id ? %( id="#{node.id}") : ''
-          result << %(<h1#{id_attr}>#{node.doctitle} Manual Page</h1>)
-        end
-        result << (generate_manname_section node) if node.attr? 'manpurpose'
-      else
-        if node.has_header? && !node.notitle
-          id_attr = node.id ? %( id="#{node.id}") : ''
-          result << %(<h1#{id_attr}>#{node.header.title}</h1>)
-        end
+    result << '</body>'
+    result << '</html>'
+    result.join LF
+  end
+  def convert_embedded node
+    result = []
+    if node.doctype == 'manpage'
+      # QUESTION should notitle control the manual page title?
+      unless node.notitle
+        id_attr = node.id ? %( id="#{node.id}") : ''
+        result << %(<h1#{id_attr}>#{node.doctitle} Manual Page</h1>)
       end
+      result << (generate_manname_section node) if node.attr? 'manpurpose'
+    elsif node.header? && !node.notitle
+      id_attr = node.id ? %( id="#{node.id}") : ''
+      result << %(<h1#{id_attr}>#{node.header.title}</h1>)
+    end
-      if node.sections? && (node.attr? 'toc') && (toc_p = node.attr 'toc-placement') != 'macro' && toc_p != 'preamble'
-        result << %(<div id="toc" class="toc">
+    if node.sections? && (node.attr? 'toc') && (toc_p = node.attr 'toc-placement') != 'macro' && toc_p != 'preamble'
+      result << %(<div id="toc" class="toc">
 <div id="toctitle">#{node.attr 'toc-title'}</div>
-#{outline node}
+#{node.converter.convert node, 'outline'}
 </div>)
-      end
+    end
-      result << node.content
+    result << node.content
-      if node.footnotes? && !(node.attr? 'nofootnotes')
-        result << %(<div id="footnotes">
+    if node.footnotes? && !(node.attr? 'nofootnotes')
+      result << %(<div id="footnotes">
 <hr#{@void_element_slash}>)
-        node.footnotes.each do |footnote|
-          result << %(<div class="footnote" id="_footnotedef_#{footnote.index}">
+      node.footnotes.each do |footnote|
+        result << %(<div class="footnote" id="_footnotedef_#{footnote.index}">
 <a href="#_footnoteref_#{footnote.index}">#{footnote.index}</a>. #{footnote.text}
 </div>)
-        end
-        result << '</div>'
       end
-      result.join LF
+      result << '</div>'
     end
-    def outline node, opts = {}
-      return unless node.sections?
-      sectnumlevels = opts[:sectnumlevels] || (node.document.attributes['sectnumlevels'] || 3).to_i
-      toclevels = opts[:toclevels] || (node.document.attributes['toclevels'] || 2).to_i
-      sections = node.sections
-      # FIXME top level is incorrect if a multipart book starts with a special section defined at level 0
-      result = [%(<ul class="sectlevel#{sections[0].level}">)]
-      sections.each do |section|
-        slevel = section.level
-        if section.caption
-          stitle = section.captioned_title
-        elsif section.numbered && slevel <= sectnumlevels
-          if slevel < 2 && node.document.doctype == 'book'
-            if section.sectname == 'chapter'
-              stitle =  %(#{(signifier = node.document.attributes['chapter-signifier']) ? "#{signifier} " : ''}#{section.sectnum} #{section.title})
-            elsif section.sectname == 'part'
-              stitle =  %(#{(signifier = node.document.attributes['part-signifier']) ? "#{signifier} " : ''}#{section.sectnum nil, ':'} #{section.title})
-            else
-              stitle = %(#{section.sectnum} #{section.title})
-            end
+    result.join LF
+  end
+  def convert_outline node, opts = {}
+    return unless node.sections?
+    sectnumlevels = opts[:sectnumlevels] || (node.document.attributes['sectnumlevels'] || 3).to_i
+    toclevels = opts[:toclevels] || (node.document.attributes['toclevels'] || 2).to_i
+    sections = node.sections
+    # FIXME top level is incorrect if a multipart book starts with a special section defined at level 0
+    result = [%(<ul class="sectlevel#{sections[0].level}">)]
+    sections.each do |section|
+      slevel = section.level
+      if section.caption
+        stitle = section.captioned_title
+      elsif section.numbered && slevel <= sectnumlevels
+        if slevel < 2 && node.document.doctype == 'book'
+          case section.sectname
+          when 'chapter'
+            stitle =  %(#{(signifier = node.document.attributes['chapter-signifier']) ? "#{signifier} " : ''}#{section.sectnum} #{section.title})
+          when 'part'
+            stitle =  %(#{(signifier = node.document.attributes['part-signifier']) ? "#{signifier} " : ''}#{section.sectnum nil, ':'} #{section.title})
           else
             stitle = %(#{section.sectnum} #{section.title})
           end
         else
-          stitle = section.title
-        end
-        stitle = stitle.gsub DropAnchorRx, '' if stitle.include? '<a'
-        if slevel < toclevels && (child_toc_level = outline section, :toclevels => toclevels, :sectnumlevels => sectnumlevels)
-          result << %(<li><a href="##{section.id}">#{stitle}</a>)
-          result << child_toc_level
-          result << '</li>'
-        else
-          result << %(<li><a href="##{section.id}">#{stitle}</a></li>)
+          stitle = %(#{section.sectnum} #{section.title})
         end
+      else
+        stitle = section.title
+      end
+      stitle = stitle.gsub DropAnchorRx, '' if stitle.include? '<a'
+      if slevel < toclevels && (child_toc_level = convert_outline section, toclevels: toclevels, sectnumlevels: sectnumlevels)
+        result << %(<li><a href="##{section.id}">#{stitle}</a>)
+        result << child_toc_level
+        result << '</li>'
+      else
+        result << %(<li><a href="##{section.id}">#{stitle}</a></li>)
       end
-      result << '</ul>'
-      result.join LF
     end
+    result << '</ul>'
+    result.join LF
+  end
-    def section node
-      doc_attrs = node.document.attributes
-      level = node.level
-      if node.caption
-        title = node.captioned_title
-      elsif node.numbered && level <= (doc_attrs['sectnumlevels'] || 3).to_i
-        if level < 2 && node.document.doctype == 'book'
-          if node.sectname == 'chapter'
-            title = %(#{(signifier = doc_attrs['chapter-signifier']) ? "#{signifier} " : ''}#{node.sectnum} #{node.title})
-          elsif node.sectname == 'part'
-            title = %(#{(signifier = doc_attrs['part-signifier']) ? "#{signifier} " : ''}#{node.sectnum nil, ':'} #{node.title})
-          else
-            title = %(#{node.sectnum} #{node.title})
-          end
+  def convert_section node
+    doc_attrs = node.document.attributes
+    level = node.level
+    if node.caption
+      title = node.captioned_title
+    elsif node.numbered && level <= (doc_attrs['sectnumlevels'] || 3).to_i
+      if level < 2 && node.document.doctype == 'book'
+        case node.sectname
+        when 'chapter'
+          title = %(#{(signifier = doc_attrs['chapter-signifier']) ? "#{signifier} " : ''}#{node.sectnum} #{node.title})
+        when 'part'
+          title = %(#{(signifier = doc_attrs['part-signifier']) ? "#{signifier} " : ''}#{node.sectnum nil, ':'} #{node.title})
         else
           title = %(#{node.sectnum} #{node.title})
         end
       else
-        title = node.title
+        title = %(#{node.sectnum} #{node.title})
       end
-      if node.id
-        id_attr = %( id="#{id = node.id}")
-        if doc_attrs['sectlinks']
-          title = %(<a class="link" href="##{id}">#{title}</a>)
-        end
-        if doc_attrs['sectanchors']
-          # QUESTION should we add a font-based icon in anchor if icons=font?
-          if doc_attrs['sectanchors'] == 'after'
-            title = %(#{title}<a class="anchor" href="##{id}"></a>)
-          else
-            title = %(<a class="anchor" href="##{id}"></a>#{title})
-          end
+    else
+      title = node.title
+    end
+    if node.id
+      id_attr = %( id="#{id = node.id}")
+      if doc_attrs['sectlinks']
+        title = %(<a class="link" href="##{id}">#{title}</a>)
+      end
+      if doc_attrs['sectanchors']
+        # QUESTION should we add a font-based icon in anchor if icons=font?
+        if doc_attrs['sectanchors'] == 'after'
+          title = %(#{title}<a class="anchor" href="##{id}"></a>)
+        else
+          title = %(<a class="anchor" href="##{id}"></a>#{title})
         end
-      else
-        id_attr = ''
       end
-      if level == 0
-        %(<h1#{id_attr} class="sect0#{(role = node.role) ? " #{role}" : ''}">#{title}</h1>
+    else
+      id_attr = ''
+    end
+    if level == 0
+      %(<h1#{id_attr} class="sect0#{(role = node.role) ? " #{role}" : ''}">#{title}</h1>
 #{node.content})
-      else
-        %(<div class="sect#{level}#{(role = node.role) ? " #{role}" : ''}">
+    else
+      %(<div class="sect#{level}#{(role = node.role) ? " #{role}" : ''}">
 <h#{level + 1}#{id_attr}>#{title}</h#{level + 1}>
 #{level == 1 ? %[<div class="sectionbody">
 #{node.content}
 </div>] : node.content}
 </div>)
-      end
     end
+  end
-    def admonition node
-      id_attr = node.id ? %( id="#{node.id}") : ''
-      name = node.attr 'name'
-      title_element = node.title? ? %(<div class="title">#{node.title}</div>\n) : ''
-      if node.document.attr? 'icons'
-        if (node.document.attr? 'icons', 'font') && !(node.attr? 'icon')
-          label = %(<i class="fa icon-#{name}" title="#{node.attr 'textlabel'}"></i>)
-        else
-          label = %(<img src="#{node.icon_uri name}" alt="#{node.attr 'textlabel'}"#{@void_element_slash}>)
-        end
+  def convert_admonition node
+    id_attr = node.id ? %( id="#{node.id}") : ''
+    name = node.attr 'name'
+    title_element = node.title? ? %(<div class="title">#{node.title}</div>\n) : ''
+    if node.document.attr? 'icons'
+      if (node.document.attr? 'icons', 'font') && !(node.attr? 'icon')
+        label = %(<i class="fa icon-#{name}" title="#{node.attr 'textlabel'}"></i>)
       else
-        label = %(<div class="title">#{node.attr 'textlabel'}</div>)
+        label = %(<img src="#{node.icon_uri name}" alt="#{node.attr 'textlabel'}"#{@void_element_slash}>)
       end
-      %(<div#{id_attr} class="admonitionblock #{name}#{(role = node.role) ? " #{role}" : ''}">
+    else
+      label = %(<div class="title">#{node.attr 'textlabel'}</div>)
+    end
+    %(<div#{id_attr} class="admonitionblock #{name}#{(role = node.role) ? " #{role}" : ''}">
 <table>
 <tr>
 <td class="icon">
@@ -396,853 +453,898 @@ MathJax.Hub.Config({
 </tr>
 </table>
 </div>)
-    end
+  end
-    def audio node
-      xml = @xml_mode
-      id_attribute = node.id ? %( id="#{node.id}") : ''
-      classes = ['audioblock', node.role].compact
-      class_attribute = %( class="#{classes.join ' '}")
-      title_element = node.title? ? %(<div class="title">#{node.title}</div>\n) : ''
-      start_t = node.attr 'start', nil, false
-      end_t = node.attr 'end', nil, false
-      time_anchor = (start_t || end_t) ? %(#t=#{start_t || ''}#{end_t ? ",#{end_t}" : ''}) : ''
-      %(<div#{id_attribute}#{class_attribute}>
+  def convert_audio node
+    xml = @xml_mode
+    id_attribute = node.id ? %( id="#{node.id}") : ''
+    classes = ['audioblock', node.role].compact
+    class_attribute = %( class="#{classes.join ' '}")
+    title_element = node.title? ? %(<div class="title">#{node.title}</div>\n) : ''
+    start_t = node.attr 'start'
+    end_t = node.attr 'end'
+    time_anchor = (start_t || end_t) ? %(#t=#{start_t || ''}#{end_t ? ",#{end_t}" : ''}) : ''
+    %(<div#{id_attribute}#{class_attribute}>
 #{title_element}<div class="content">
 <audio src="#{node.media_uri(node.attr 'target')}#{time_anchor}"#{(node.option? 'autoplay') ? (append_boolean_attribute 'autoplay', xml) : ''}#{(node.option? 'nocontrols') ? '' : (append_boolean_attribute 'controls', xml)}#{(node.option? 'loop') ? (append_boolean_attribute 'loop', xml) : ''}>
 Your browser does not support the audio tag.
 </audio>
 </div>
 </div>)
-    end
+  end
-    def colist node
-      result = []
-      id_attribute = node.id ? %( id="#{node.id}") : ''
-      classes = ['colist', node.style, node.role].compact
-      class_attribute = %( class="#{classes.join ' '}")
-      result << %(<div#{id_attribute}#{class_attribute}>)
-      result << %(<div class="title">#{node.title}</div>) if node.title?
-      if node.document.attr? 'icons'
-        result << '<table>'
-        font_icons, num = (node.document.attr? 'icons', 'font'), 0
-        node.items.each do |item|
-          num += 1
-          if font_icons
-            num_label = %(<i class="conum" data-value="#{num}"></i><b>#{num}</b>)
-          else
-            num_label = %(<img src="#{node.icon_uri "callouts/#{num}"}" alt="#{num}"#{@void_element_slash}>)
-          end
-          result << %(<tr>
+  def convert_colist node
+    result = []
+    id_attribute = node.id ? %( id="#{node.id}") : ''
+    classes = ['colist', node.style, node.role].compact
+    class_attribute = %( class="#{classes.join ' '}")
+    result << %(<div#{id_attribute}#{class_attribute}>)
+    result << %(<div class="title">#{node.title}</div>) if node.title?
+    if node.document.attr? 'icons'
+      result << '<table>'
+      font_icons, num = (node.document.attr? 'icons', 'font'), 0
+      node.items.each do |item|
+        num += 1
+        if font_icons
+          num_label = %(<i class="conum" data-value="#{num}"></i><b>#{num}</b>)
+        else
+          num_label = %(<img src="#{node.icon_uri "callouts/#{num}"}" alt="#{num}"#{@void_element_slash}>)
+        end
+        result << %(<tr>
 <td>#{num_label}</td>
 <td>#{item.text}#{item.blocks? ? LF + item.content : ''}</td>
 </tr>)
-        end
-        result << '</table>'
-      else
-        result << '<ol>'
-        node.items.each do |item|
-          result << %(<li>
+      end
+      result << '</table>'
+    else
+      result << '<ol>'
+      node.items.each do |item|
+        result << %(<li>
 <p>#{item.text}</p>#{item.blocks? ? LF + item.content : ''}
 </li>)
-        end
-        result << '</ol>'
       end
+      result << '</ol>'
+    end
-      result << '</div>'
-      result.join LF
+    result << '</div>'
+    result.join LF
+  end
+  def convert_dlist node
+    result = []
+    id_attribute = node.id ? %( id="#{node.id}") : ''
+    case node.style
+    when 'qanda'
+      classes = ['qlist', 'qanda', node.role]
+    when 'horizontal'
+      classes = ['hdlist', node.role]
+    else
+      classes = ['dlist', node.style, node.role]
     end
-    def dlist node
-      result = []
-      id_attribute = node.id ? %( id="#{node.id}") : ''
+    class_attribute = %( class="#{classes.compact.join ' '}")
-      classes = case node.style
-      when 'qanda'
-        ['qlist', 'qanda', node.role]
-      when 'horizontal'
-        ['hdlist', node.role]
-      else
-        ['dlist', node.style, node.role]
-      end.compact
-      class_attribute = %( class="#{classes.join ' '}")
-      result << %(<div#{id_attribute}#{class_attribute}>)
-      result << %(<div class="title">#{node.title}</div>) if node.title?
-      case node.style
-      when 'qanda'
-        result << '<ol>'
-        node.items.each do |terms, dd|
-          result << '<li>'
-          [*terms].each do |dt|
-            result << %(<p><em>#{dt.text}</em></p>)
-          end
-          if dd
-            result << %(<p>#{dd.text}</p>) if dd.text?
-            result << dd.content if dd.blocks?
-          end
-          result << '</li>'
+    result << %(<div#{id_attribute}#{class_attribute}>)
+    result << %(<div class="title">#{node.title}</div>) if node.title?
+    case node.style
+    when 'qanda'
+      result << '<ol>'
+      node.items.each do |terms, dd|
+        result << '<li>'
+        terms.each do |dt|
+          result << %(<p><em>#{dt.text}</em></p>)
         end
-        result << '</ol>'
-      when 'horizontal'
-        slash = @void_element_slash
-        result << '<table>'
-        if (node.attr? 'labelwidth') || (node.attr? 'itemwidth')
-          result << '<colgroup>'
-          col_style_attribute = (node.attr? 'labelwidth') ? %( style="width: #{(node.attr 'labelwidth').chomp '%'}%;") : ''
-          result << %(<col#{col_style_attribute}#{slash}>)
-          col_style_attribute = (node.attr? 'itemwidth') ? %( style="width: #{(node.attr 'itemwidth').chomp '%'}%;") : ''
-          result << %(<col#{col_style_attribute}#{slash}>)
-          result << '</colgroup>'
+        if dd
+          result << %(<p>#{dd.text}</p>) if dd.text?
+          result << dd.content if dd.blocks?
         end
-        node.items.each do |terms, dd|
-          result << '<tr>'
-          result << %(<td class="hdlist1#{(node.option? 'strong') ? ' strong' : ''}">)
-          terms_array = [*terms]
-          last_term = terms_array[-1]
-          terms_array.each do |dt|
-            result << dt.text
-            result << %(<br#{slash}>) if dt != last_term
-          end
-          result << '</td>'
-          result << '<td class="hdlist2">'
-          if dd
-            result << %(<p>#{dd.text}</p>) if dd.text?
-            result << dd.content if dd.blocks?
-          end
-          result << '</td>'
-          result << '</tr>'
+        result << '</li>'
+      end
+      result << '</ol>'
+    when 'horizontal'
+      slash = @void_element_slash
+      result << '<table>'
+      if (node.attr? 'labelwidth') || (node.attr? 'itemwidth')
+        result << '<colgroup>'
+        col_style_attribute = (node.attr? 'labelwidth') ? %( style="width: #{(node.attr 'labelwidth').chomp '%'}%;") : ''
+        result << %(<col#{col_style_attribute}#{slash}>)
+        col_style_attribute = (node.attr? 'itemwidth') ? %( style="width: #{(node.attr 'itemwidth').chomp '%'}%;") : ''
+        result << %(<col#{col_style_attribute}#{slash}>)
+        result << '</colgroup>'
+      end
+      node.items.each do |terms, dd|
+        result << '<tr>'
+        result << %(<td class="hdlist1#{(node.option? 'strong') ? ' strong' : ''}">)
+        first_term = true
+        terms.each do |dt|
+          result << %(<br#{slash}>) unless first_term
+          result << dt.text
+          first_term = nil
         end
-        result << '</table>'
-      else
-        result << '<dl>'
-        dt_style_attribute = node.style ? '' : ' class="hdlist1"'
-        node.items.each do |terms, dd|
-          [*terms].each do |dt|
-            result << %(<dt#{dt_style_attribute}>#{dt.text}</dt>)
-          end
-          if dd
-            result << '<dd>'
-            result << %(<p>#{dd.text}</p>) if dd.text?
-            result << dd.content if dd.blocks?
-            result << '</dd>'
-          end
+        result << '</td>'
+        result << '<td class="hdlist2">'
+        if dd
+          result << %(<p>#{dd.text}</p>) if dd.text?
+          result << dd.content if dd.blocks?
         end
-        result << '</dl>'
+        result << '</td>'
+        result << '</tr>'
       end
-      result << '</div>'
-      result.join LF
+      result << '</table>'
+    else
+      result << '<dl>'
+      dt_style_attribute = node.style ? '' : ' class="hdlist1"'
+      node.items.each do |terms, dd|
+        terms.each do |dt|
+          result << %(<dt#{dt_style_attribute}>#{dt.text}</dt>)
+        end
+        next unless dd
+        result << '<dd>'
+        result << %(<p>#{dd.text}</p>) if dd.text?
+        result << dd.content if dd.blocks?
+        result << '</dd>'
+      end
+      result << '</dl>'
     end
-    def example node
-      id_attribute = node.id ? %( id="#{node.id}") : ''
-      title_element = node.title? ? %(<div class="title">#{node.captioned_title}</div>\n) : ''
+    result << '</div>'
+    result.join LF
+  end
+  def convert_example node
+    id_attribute = node.id ? %( id="#{node.id}") : ''
+    if node.option? 'collapsible'
+      class_attribute = node.role ? %( class="#{node.role}") : ''
+      summary_element = node.title? ? %(<summary class="title">#{node.title}</summary>) : '<summary class="title">Details</summary>'
+      %(<details#{id_attribute}#{class_attribute}#{(node.option? 'open') ? ' open' : ''}>
+#{summary_element}
+<div class="content">
+#{node.content}
+</div>
+</details>)
+    else
+      title_element = node.title? ? %(<div class="title">#{node.captioned_title}</div>\n) : ''
       %(<div#{id_attribute} class="exampleblock#{(role = node.role) ? " #{role}" : ''}">
 #{title_element}<div class="content">
 #{node.content}
 </div>
 </div>)
     end
+  end
-    def floating_title node
-      tag_name = %(h#{node.level + 1})
-      id_attribute = node.id ? %( id="#{node.id}") : ''
-      classes = [node.style, node.role].compact
-      %(<#{tag_name}#{id_attribute} class="#{classes.join ' '}">#{node.title}</#{tag_name}>)
-    end
+  def convert_floating_title node
+    tag_name = %(h#{node.level + 1})
+    id_attribute = node.id ? %( id="#{node.id}") : ''
+    classes = [node.style, node.role].compact
+    %(<#{tag_name}#{id_attribute} class="#{classes.join ' '}">#{node.title}</#{tag_name}>)
+  end
-    def image node
-      target = node.attr 'target'
-      width_attr = (node.attr? 'width') ? %( width="#{node.attr 'width'}") : ''
-      height_attr = (node.attr? 'height') ? %( height="#{node.attr 'height'}") : ''
-      if ((node.attr? 'format', 'svg', false) || (target.include? '.svg')) && node.document.safe < SafeMode::SECURE &&
-          ((svg = (node.option? 'inline')) || (obj = (node.option? 'interactive')))
-        if svg
-          img = (read_svg_contents node, target) || %(<span class="alt">#{node.alt}</span>)
-        elsif obj
-          fallback = (node.attr? 'fallback') ? %(<img src="#{node.image_uri(node.attr 'fallback')}" alt="#{encode_quotes node.alt}"#{width_attr}#{height_attr}#{@void_element_slash}>) : %(<span class="alt">#{node.alt}</span>)
-          img = %(<object type="image/svg+xml" data="#{node.image_uri target}"#{width_attr}#{height_attr}>#{fallback}</object>)
-        end
-      end
-      img ||= %(<img src="#{node.image_uri target}" alt="#{encode_quotes node.alt}"#{width_attr}#{height_attr}#{@void_element_slash}>)
-      if node.attr? 'link', nil, false
-        img = %(<a class="image" href="#{node.attr 'link'}"#{(append_link_constraint_attrs node).join}>#{img}</a>)
+  def convert_image node
+    target = node.attr 'target'
+    width_attr = (node.attr? 'width') ? %( width="#{node.attr 'width'}") : ''
+    height_attr = (node.attr? 'height') ? %( height="#{node.attr 'height'}") : ''
+    if ((node.attr? 'format', 'svg') || (target.include? '.svg')) && node.document.safe < SafeMode::SECURE
+      if node.option? 'inline'
+        img = (read_svg_contents node, target) || %(<span class="alt">#{node.alt}</span>)
+      elsif node.option? 'interactive'
+        fallback = (node.attr? 'fallback') ? %(<img src="#{node.image_uri node.attr 'fallback'}" alt="#{encode_attribute_value node.alt}"#{width_attr}#{height_attr}#{@void_element_slash}>) : %(<span class="alt">#{node.alt}</span>)
+        img = %(<object type="image/svg+xml" data="#{node.image_uri target}"#{width_attr}#{height_attr}>#{fallback}</object>)
+      else
+        img = %(<img src="#{node.image_uri target}" alt="#{encode_attribute_value node.alt}"#{width_attr}#{height_attr}#{@void_element_slash}>)
       end
-      id_attr = node.id ? %( id="#{node.id}") : ''
-      classes = ['imageblock']
-      classes << (node.attr 'float') if node.attr? 'float'
-      classes << %(text-#{node.attr 'align'}) if node.attr? 'align'
-      classes << node.role if node.role
-      class_attr = %( class="#{classes.join ' '}")
-      title_el = node.title? ? %(\n<div class="title">#{node.captioned_title}</div>) : ''
-      %(<div#{id_attr}#{class_attr}>
+    else
+      img = %(<img src="#{node.image_uri target}" alt="#{encode_attribute_value node.alt}"#{width_attr}#{height_attr}#{@void_element_slash}>)
+    end
+    img = %(<a class="image" href="#{node.attr 'link'}"#{(append_link_constraint_attrs node).join}>#{img}</a>) if node.attr? 'link'
+    id_attr = node.id ? %( id="#{node.id}") : ''
+    classes = ['imageblock']
+    classes << (node.attr 'float') if node.attr? 'float'
+    classes << %(text-#{node.attr 'align'}) if node.attr? 'align'
+    classes << node.role if node.role
+    class_attr = %( class="#{classes.join ' '}")
+    title_el = node.title? ? %(\n<div class="title">#{node.captioned_title}</div>) : ''
+    %(<div#{id_attr}#{class_attr}>
 <div class="content">
 #{img}
 </div>#{title_el}
 </div>)
-    end
+  end
-    def listing node
-      nowrap = !(node.document.attr? 'prewrap') || (node.option? 'nowrap')
-      if node.style == 'source'
-        if (language = node.attr 'language', nil, false)
-          code_attrs = %( data-lang="#{language}")
-        else
-          code_attrs = ''
-        end
-        case node.document.attr 'source-highlighter'
-        when 'coderay'
-          pre_class = %( class="CodeRay highlight#{nowrap ? ' nowrap' : ''}")
-        when 'pygments'
-          if (node.document.attr? 'pygments-css', 'inline')
-            @pygments_bg = @stylesheets.pygments_background(node.document.attr 'pygments-style') unless defined? @pygments_bg
-            pre_class = %( class="pygments highlight#{nowrap ? ' nowrap' : ''}" style="background: #{@pygments_bg}")
-          else
-            pre_class = %( class="pygments highlight#{nowrap ? ' nowrap' : ''}")
-          end
-        when 'highlightjs', 'highlight.js'
-          pre_class = %( class="highlightjs highlight#{nowrap ? ' nowrap' : ''}")
-          code_attrs = %( class="language-#{language} hljs"#{code_attrs}) if language
-        when 'prettify'
-          pre_class = %( class="prettyprint highlight#{nowrap ? ' nowrap' : ''}#{(node.attr? 'linenums', nil, false) ? ' linenums' : ''}")
-          code_attrs = %( class="language-#{language}"#{code_attrs}) if language
-        when 'html-pipeline'
-          pre_class = language ? %( lang="#{language}") : ''
-          code_attrs = ''
-        else
-          pre_class = %( class="highlight#{nowrap ? ' nowrap' : ''}")
-          code_attrs = %( class="language-#{language}"#{code_attrs}) if language
-        end
-        pre_start = %(<pre#{pre_class}><code#{code_attrs}>)
-        pre_end = '</code></pre>'
+  def convert_listing node
+    nowrap = (node.option? 'nowrap') || !(node.document.attr? 'prewrap')
+    if node.style == 'source'
+      lang = node.attr 'language'
+      if (syntax_hl = node.document.syntax_highlighter)
+        opts = syntax_hl.highlight? ? {
+          css_mode: ((doc_attrs = node.document.attributes)[%(#{syntax_hl.name}-css)] || :class).to_sym,
+          style: doc_attrs[%(#{syntax_hl.name}-style)],
+        } : {}
+        opts[:nowrap] = nowrap
       else
-        pre_start = %(<pre#{nowrap ? ' class="nowrap"' : ''}>)
-        pre_end = '</pre>'
+        pre_open = %(<pre class="highlight#{nowrap ? ' nowrap' : ''}"><code#{lang ? %[ class="language-#{lang}" data-lang="#{lang}"] : ''}>)
+        pre_close = '</code></pre>'
       end
-      id_attribute = node.id ? %( id="#{node.id}") : ''
-      title_element = node.title? ? %(<div class="title">#{node.captioned_title}</div>\n) : ''
-      %(<div#{id_attribute} class="listingblock#{(role = node.role) ? " #{role}" : ''}">
+    else
+      pre_open = %(<pre#{nowrap ? ' class="nowrap"' : ''}>)
+      pre_close = '</pre>'
+    end
+    id_attribute = node.id ? %( id="#{node.id}") : ''
+    title_element = node.title? ? %(<div class="title">#{node.captioned_title}</div>\n) : ''
+    %(<div#{id_attribute} class="listingblock#{(role = node.role) ? " #{role}" : ''}">
 #{title_element}<div class="content">
-#{pre_start}#{node.content}#{pre_end}
+#{syntax_hl ? (syntax_hl.format node, lang, opts) : pre_open + (node.content || '') + pre_close}
 </div>
 </div>)
-    end
+  end
-    def literal node
-      id_attribute = node.id ? %( id="#{node.id}") : ''
-      title_element = node.title? ? %(<div class="title">#{node.title}</div>\n) : ''
-      nowrap = !(node.document.attr? 'prewrap') || (node.option? 'nowrap')
-      %(<div#{id_attribute} class="literalblock#{(role = node.role) ? " #{role}" : ''}">
+  def convert_literal node
+    id_attribute = node.id ? %( id="#{node.id}") : ''
+    title_element = node.title? ? %(<div class="title">#{node.title}</div>\n) : ''
+    nowrap = !(node.document.attr? 'prewrap') || (node.option? 'nowrap')
+    %(<div#{id_attribute} class="literalblock#{(role = node.role) ? " #{role}" : ''}">
 #{title_element}<div class="content">
 <pre#{nowrap ? ' class="nowrap"' : ''}>#{node.content}</pre>
 </div>
 </div>)
-    end
-    def stem node
-      id_attribute = node.id ? %( id="#{node.id}") : ''
-      title_element = node.title? ? %(<div class="title">#{node.title}</div>\n) : ''
-      open, close = BLOCK_MATH_DELIMITERS[style = node.style.to_sym]
-      equation = node.content
+  end
+  def convert_stem node
+    id_attribute = node.id ? %( id="#{node.id}") : ''
+    title_element = node.title? ? %(<div class="title">#{node.title}</div>\n) : ''
+    open, close = BLOCK_MATH_DELIMITERS[style = node.style.to_sym]
+    if (equation = node.content)
       if style == :asciimath && (equation.include? LF)
-        br = %(<br#{@void_element_slash}>#{LF})
-        equation = equation.gsub(StemBreakRx) { %(#{close}#{br * ($&.count LF)}#{open}) }
+        br = %(#{LF}<br#{@void_element_slash}>)
+        equation = equation.gsub(StemBreakRx) { %(#{close}#{br * (($&.count LF) - 1)}#{LF}#{open}) }
       end
       unless (equation.start_with? open) && (equation.end_with? close)
         equation = %(#{open}#{equation}#{close})
       end
-      %(<div#{id_attribute} class="stemblock#{(role = node.role) ? " #{role}" : ''}">
+    else
+      equation = ''
+    end
+    %(<div#{id_attribute} class="stemblock#{(role = node.role) ? " #{role}" : ''}">
 #{title_element}<div class="content">
 #{equation}
 </div>
 </div>)
-    end
-    def olist node
-      result = []
-      id_attribute = node.id ? %( id="#{node.id}") : ''
-      classes = ['olist', node.style, node.role].compact
-      class_attribute = %( class="#{classes.join ' '}")
-      result << %(<div#{id_attribute}#{class_attribute}>)
-      result << %(<div class="title">#{node.title}</div>) if node.title?
-      type_attribute = (keyword = node.list_marker_keyword) ? %( type="#{keyword}") : ''
-      start_attribute = (node.attr? 'start') ? %( start="#{node.attr 'start'}") : ''
-      reversed_attribute = (node.option? 'reversed') ? (append_boolean_attribute 'reversed', @xml_mode) : ''
-      result << %(<ol class="#{node.style}"#{type_attribute}#{start_attribute}#{reversed_attribute}>)
+  end
-      node.items.each do |item|
+  def convert_olist node
+    result = []
+    id_attribute = node.id ? %( id="#{node.id}") : ''
+    classes = ['olist', node.style, node.role].compact
+    class_attribute = %( class="#{classes.join ' '}")
+    result << %(<div#{id_attribute}#{class_attribute}>)
+    result << %(<div class="title">#{node.title}</div>) if node.title?
+    type_attribute = (keyword = node.list_marker_keyword) ? %( type="#{keyword}") : ''
+    start_attribute = (node.attr? 'start') ? %( start="#{node.attr 'start'}") : ''
+    reversed_attribute = (node.option? 'reversed') ? (append_boolean_attribute 'reversed', @xml_mode) : ''
+    result << %(<ol class="#{node.style}"#{type_attribute}#{start_attribute}#{reversed_attribute}>)
+    node.items.each do |item|
+      if item.id
+        result << %(<li id="#{item.id}"#{item.role ? %[ class="#{item.role}"] : ''}>)
+      elsif item.role
+        result << %(<li class="#{item.role}">)
+      else
         result << '<li>'
-        result << %(<p>#{item.text}</p>)
-        result << item.content if item.blocks?
-        result << '</li>'
       end
-      result << '</ol>'
-      result << '</div>'
-      result.join LF
+      result << %(<p>#{item.text}</p>)
+      result << item.content if item.blocks?
+      result << '</li>'
     end
-    def open node
-      if (style = node.style) == 'abstract'
-        if node.parent == node.document && node.document.doctype == 'book'
-          logger.warn 'abstract block cannot be used in a document without a title when doctype is book. Excluding block content.'
-          ''
-        else
-          id_attr = node.id ? %( id="#{node.id}") : ''
-          title_el = node.title? ? %(<div class="title">#{node.title}</div>\n) : ''
-          %(<div#{id_attr} class="quoteblock abstract#{(role = node.role) ? " #{role}" : ''}">
+    result << '</ol>'
+    result << '</div>'
+    result.join LF
+  end
+  def convert_open node
+    if (style = node.style) == 'abstract'
+      if node.parent == node.document && node.document.doctype == 'book'
+        logger.warn 'abstract block cannot be used in a document without a title when doctype is book. Excluding block content.'
+        ''
+      else
+        id_attr = node.id ? %( id="#{node.id}") : ''
+        title_el = node.title? ? %(<div class="title">#{node.title}</div>\n) : ''
+        %(<div#{id_attr} class="quoteblock abstract#{(role = node.role) ? " #{role}" : ''}">
 #{title_el}<blockquote>
 #{node.content}
 </blockquote>
 </div>)
-        end
-      elsif style == 'partintro' && (node.level > 0 || node.parent.context != :section || node.document.doctype != 'book')
-        logger.error 'partintro block can only be used when doctype is book and must be a child of a book part. Excluding block content.'
-        ''
-      else
-          id_attr = node.id ? %( id="#{node.id}") : ''
-          title_el = node.title? ? %(<div class="title">#{node.title}</div>\n) : ''
-        %(<div#{id_attr} class="openblock#{style && style != 'open' ? " #{style}" : ''}#{(role = node.role) ? " #{role}" : ''}">
+      end
+    elsif style == 'partintro' && (node.level > 0 || node.parent.context != :section || node.document.doctype != 'book')
+      logger.error 'partintro block can only be used when doctype is book and must be a child of a book part. Excluding block content.'
+      ''
+    else
+      id_attr = node.id ? %( id="#{node.id}") : ''
+      title_el = node.title? ? %(<div class="title">#{node.title}</div>\n) : ''
+      %(<div#{id_attr} class="openblock#{style && style != 'open' ? " #{style}" : ''}#{(role = node.role) ? " #{role}" : ''}">
 #{title_el}<div class="content">
 #{node.content}
 </div>
 </div>)
-      end
-    end
-    def page_break node
-      '<div style="page-break-after: always;"></div>'
     end
+  end
-    def paragraph node
-      class_attribute = node.role ? %(class="paragraph #{node.role}") : 'class="paragraph"'
-      attributes = node.id ? %(id="#{node.id}" #{class_attribute}) : class_attribute
+  def convert_page_break node
+    '<div style="page-break-after: always;"></div>'
+  end
-      if node.title?
-        %(<div #{attributes}>
+  def convert_paragraph node
+    if node.role
+      attributes = %(#{node.id ? %[ id="#{node.id}"] : ''} class="paragraph #{node.role}")
+    elsif node.id
+      attributes = %( id="#{node.id}" class="paragraph")
+    else
+      attributes = ' class="paragraph"'
+    end
+    if node.title?
+      %(<div#{attributes}>
 <div class="title">#{node.title}</div>
 <p>#{node.content}</p>
 </div>)
-      else
-        %(<div #{attributes}>
+    else
+      %(<div#{attributes}>
 <p>#{node.content}</p>
 </div>)
-      end
     end
+  end
+  alias convert_pass content_only
-    def preamble node
-      if (doc = node.document).attr?('toc-placement', 'preamble') && doc.sections? && (doc.attr? 'toc')
-        toc = %(
+  def convert_preamble node
+    if (doc = node.document).attr?('toc-placement', 'preamble') && doc.sections? && (doc.attr? 'toc')
+      toc = %(
 <div id="toc" class="#{doc.attr 'toc-class', 'toc'}">
 <div id="toctitle">#{doc.attr 'toc-title'}</div>
-#{outline doc}
+#{doc.converter.convert doc, 'outline'}
 </div>)
-      else
-        toc = ''
-      end
+    else
+      toc = ''
+    end
-      %(<div id="preamble">
+    %(<div id="preamble">
 <div class="sectionbody">
 #{node.content}
 </div>#{toc}
 </div>)
-    end
+  end
-    def quote node
-      id_attribute = node.id ? %( id="#{node.id}") : ''
-      classes = ['quoteblock', node.role].compact
-      class_attribute = %( class="#{classes.join ' '}")
-      title_element = node.title? ? %(\n<div class="title">#{node.title}</div>) : ''
-      attribution = (node.attr? 'attribution') ? (node.attr 'attribution') : nil
-      citetitle = (node.attr? 'citetitle') ? (node.attr 'citetitle') : nil
-      if attribution || citetitle
-        cite_element = citetitle ? %(<cite>#{citetitle}</cite>) : ''
-        attribution_text = attribution ? %(&#8212; #{attribution}#{citetitle ? "<br#{@void_element_slash}>\n" : ''}) : ''
-        attribution_element = %(\n<div class="attribution">\n#{attribution_text}#{cite_element}\n</div>)
-      else
-        attribution_element = ''
-      end
+  def convert_quote node
+    id_attribute = node.id ? %( id="#{node.id}") : ''
+    classes = ['quoteblock', node.role].compact
+    class_attribute = %( class="#{classes.join ' '}")
+    title_element = node.title? ? %(\n<div class="title">#{node.title}</div>) : ''
+    attribution = (node.attr? 'attribution') ? (node.attr 'attribution') : nil
+    citetitle = (node.attr? 'citetitle') ? (node.attr 'citetitle') : nil
+    if attribution || citetitle
+      cite_element = citetitle ? %(<cite>#{citetitle}</cite>) : ''
+      attribution_text = attribution ? %(&#8212; #{attribution}#{citetitle ? "<br#{@void_element_slash}>\n" : ''}) : ''
+      attribution_element = %(\n<div class="attribution">\n#{attribution_text}#{cite_element}\n</div>)
+    else
+      attribution_element = ''
+    end
-      %(<div#{id_attribute}#{class_attribute}>#{title_element}
+    %(<div#{id_attribute}#{class_attribute}>#{title_element}
 <blockquote>
 #{node.content}
 </blockquote>#{attribution_element}
 </div>)
-    end
+  end
-    def thematic_break node
-      %(<hr#{@void_element_slash}>)
-    end
+  def convert_thematic_break node
+    %(<hr#{@void_element_slash}>)
+  end
-    def sidebar node
-      id_attribute = node.id ? %( id="#{node.id}") : ''
-      title_element = node.title? ? %(<div class="title">#{node.title}</div>\n) : ''
-      %(<div#{id_attribute} class="sidebarblock#{(role = node.role) ? " #{role}" : ''}">
+  def convert_sidebar node
+    id_attribute = node.id ? %( id="#{node.id}") : ''
+    title_element = node.title? ? %(<div class="title">#{node.title}</div>\n) : ''
+    %(<div#{id_attribute} class="sidebarblock#{(role = node.role) ? " #{role}" : ''}">
 <div class="content">
 #{title_element}#{node.content}
 </div>
 </div>)
+  end
+  def convert_table node
+    result = []
+    id_attribute = node.id ? %( id="#{node.id}") : ''
+    frame = 'ends' if (frame = node.attr 'frame', 'all', 'table-frame') == 'topbot'
+    classes = ['tableblock', %(frame-#{frame}), %(grid-#{node.attr 'grid', 'all', 'table-grid'})]
+    if (stripes = node.attr 'stripes', nil, 'table-stripes')
+      classes << %(stripes-#{stripes})
+    end
+    style_attribute = ''
+    if (autowidth = node.option? 'autowidth') && !(node.attr? 'width')
+      classes << 'fit-content'
+    elsif (tablewidth = node.attr 'tablepcwidth') == 100
+      classes << 'stretch'
+    else
+      style_attribute = %( style="width: #{tablewidth}%;")
+    end
+    classes << (node.attr 'float') if node.attr? 'float'
+    if (role = node.role)
+      classes << role
     end
+    class_attribute = %( class="#{classes.join ' '}")
-    def table node
-      result = []
-      id_attribute = node.id ? %( id="#{node.id}") : ''
-      classes = ['tableblock', %(frame-#{node.attr 'frame', 'all'}), %(grid-#{node.attr 'grid', 'all'})]
-      if (stripes = node.attr 'stripes')
-        classes << %(stripes-#{stripes})
-      end
-      styles = []
-      if (autowidth = node.attributes['autowidth-option']) && !(node.attr? 'width', nil, false)
-        classes << 'fit-content'
-      elsif (tablewidth = node.attr 'tablepcwidth') == 100
-        classes << 'stretch'
+    result << %(<table#{id_attribute}#{class_attribute}#{style_attribute}>)
+    result << %(<caption class="title">#{node.captioned_title}</caption>) if node.title?
+    if (node.attr 'rowcount') > 0
+      slash = @void_element_slash
+      result << '<colgroup>'
+      if autowidth
+        result += (Array.new node.columns.size, %(<col#{slash}>))
       else
-        styles << %(width: #{tablewidth}%;)
-      end
-      classes << (node.attr 'float') if node.attr? 'float'
-      if (role = node.role)
-        classes << role
-      end
-      class_attribute = %( class="#{classes.join ' '}")
-      style_attribute = styles.empty? ? '' : %( style="#{styles.join ' '}")
-      result << %(<table#{id_attribute}#{class_attribute}#{style_attribute}>)
-      result << %(<caption class="title">#{node.captioned_title}</caption>) if node.title?
-      if (node.attr 'rowcount') > 0
-        slash = @void_element_slash
-        result << '<colgroup>'
-        if autowidth
-          result += (Array.new node.columns.size, %(<col#{slash}>))
-        else
-          node.columns.each do |col|
-            result << (col.attributes['autowidth-option'] ? %(<col#{slash}>) : %(<col style="width: #{col.attr 'colpcwidth'}%;"#{slash}>))
-          end
+        node.columns.each do |col|
+          result << ((col.option? 'autowidth') ? %(<col#{slash}>) : %(<col style="width: #{col.attr 'colpcwidth'}%;"#{slash}>))
         end
-        result << '</colgroup>'
-        node.rows.by_section.each do |tsec, rows|
-          next if rows.empty?
-          result << %(<t#{tsec}>)
-          rows.each do |row|
-            result << '<tr>'
-            row.each do |cell|
-              if tsec == :head
-                cell_content = cell.text
+      end
+      result << '</colgroup>'
+      node.rows.to_h.each do |tsec, rows|
+        next if rows.empty?
+        result << %(<t#{tsec}>)
+        rows.each do |row|
+          result << '<tr>'
+          row.each do |cell|
+            if tsec == :head
+              cell_content = cell.text
+            else
+              case cell.style
+              when :asciidoc
+                cell_content = %(<div class="content">#{cell.content}</div>)
+              when :literal
+                cell_content = %(<div class="literal"><pre>#{cell.text}</pre></div>)
               else
-                case cell.style
-                when :asciidoc
-                  cell_content = %(<div class="content">#{cell.content}</div>)
-                when :verse
-                  cell_content = %(<div class="verse">#{cell.text}</div>)
-                when :literal
-                  cell_content = %(<div class="literal"><pre>#{cell.text}</pre></div>)
-                else
-                  cell_content = (cell_content = cell.content).empty? ? '' : %(<p class="tableblock">#{cell_content.join '</p>
+                cell_content = (cell_content = cell.content).empty? ? '' : %(<p class="tableblock">#{cell_content.join '</p>
 <p class="tableblock">'}</p>)
-                end
               end
-              cell_tag_name = (tsec == :head || cell.style == :header ? 'th' : 'td')
-              cell_class_attribute = %( class="tableblock halign-#{cell.attr 'halign'} valign-#{cell.attr 'valign'}")
-              cell_colspan_attribute = cell.colspan ? %( colspan="#{cell.colspan}") : ''
-              cell_rowspan_attribute = cell.rowspan ? %( rowspan="#{cell.rowspan}") : ''
-              cell_style_attribute = (node.document.attr? 'cellbgcolor') ? %( style="background-color: #{node.document.attr 'cellbgcolor'};") : ''
-              result << %(<#{cell_tag_name}#{cell_class_attribute}#{cell_colspan_attribute}#{cell_rowspan_attribute}#{cell_style_attribute}>#{cell_content}</#{cell_tag_name}>)
             end
-            result << '</tr>'
+            cell_tag_name = (tsec == :head || cell.style == :header ? 'th' : 'td')
+            cell_class_attribute = %( class="tableblock halign-#{cell.attr 'halign'} valign-#{cell.attr 'valign'}")
+            cell_colspan_attribute = cell.colspan ? %( colspan="#{cell.colspan}") : ''
+            cell_rowspan_attribute = cell.rowspan ? %( rowspan="#{cell.rowspan}") : ''
+            cell_style_attribute = (node.document.attr? 'cellbgcolor') ? %( style="background-color: #{node.document.attr 'cellbgcolor'};") : ''
+            result << %(<#{cell_tag_name}#{cell_class_attribute}#{cell_colspan_attribute}#{cell_rowspan_attribute}#{cell_style_attribute}>#{cell_content}</#{cell_tag_name}>)
           end
-          result << %(</t#{tsec}>)
+          result << '</tr>'
         end
+        result << %(</t#{tsec}>)
       end
-      result << '</table>'
-      result.join LF
     end
+    result << '</table>'
+    result.join LF
+  end
-    def toc node
-      unless (doc = node.document).attr?('toc-placement', 'macro') && doc.sections? && (doc.attr? 'toc')
-        return '<!-- toc disabled -->'
-      end
+  def convert_toc node
+    unless (doc = node.document).attr?('toc-placement', 'macro') && doc.sections? && (doc.attr? 'toc')
+      return '<!-- toc disabled -->'
+    end
-      if node.id
-        id_attr = %( id="#{node.id}")
-        title_id_attr = %( id="#{node.id}title")
-      else
-        id_attr = ' id="toc"'
-        title_id_attr = ' id="toctitle"'
-      end
-      title = node.title? ? node.title : (doc.attr 'toc-title')
-      levels = (node.attr? 'levels') ? (node.attr 'levels').to_i : nil
-      role = node.role? ? node.role : (doc.attr 'toc-class', 'toc')
+    if node.id
+      id_attr = %( id="#{node.id}")
+      title_id_attr = %( id="#{node.id}title")
+    else
+      id_attr = ' id="toc"'
+      title_id_attr = ' id="toctitle"'
+    end
+    title = node.title? ? node.title : (doc.attr 'toc-title')
+    levels = (node.attr? 'levels') ? (node.attr 'levels').to_i : nil
+    role = node.role? ? node.role : (doc.attr 'toc-class', 'toc')
-      %(<div#{id_attr} class="#{role}">
+    %(<div#{id_attr} class="#{role}">
 <div#{title_id_attr} class="title">#{title}</div>
-#{outline doc, :toclevels => levels}
+#{doc.converter.convert doc, 'outline', toclevels: levels}
 </div>)
-    end
+  end
-    def ulist node
-      result = []
-      id_attribute = node.id ? %( id="#{node.id}") : ''
-      div_classes = ['ulist', node.style, node.role].compact
-      marker_checked = marker_unchecked = ''
-      if (checklist = node.option? 'checklist')
-        div_classes.unshift div_classes.shift, 'checklist'
-        ul_class_attribute = ' class="checklist"'
-        if node.option? 'interactive'
-          if @xml_mode
-            marker_checked = '<input type="checkbox" data-item-complete="1" checked="checked"/> '
-            marker_unchecked = '<input type="checkbox" data-item-complete="0"/> '
-          else
-            marker_checked = '<input type="checkbox" data-item-complete="1" checked> '
-            marker_unchecked = '<input type="checkbox" data-item-complete="0"> '
-          end
+  def convert_ulist node
+    result = []
+    id_attribute = node.id ? %( id="#{node.id}") : ''
+    div_classes = ['ulist', node.style, node.role].compact
+    marker_checked = marker_unchecked = ''
+    if (checklist = node.option? 'checklist')
+      div_classes.unshift div_classes.shift, 'checklist'
+      ul_class_attribute = ' class="checklist"'
+      if node.option? 'interactive'
+        if @xml_mode
+          marker_checked = '<input type="checkbox" data-item-complete="1" checked="checked"/> '
+          marker_unchecked = '<input type="checkbox" data-item-complete="0"/> '
         else
-          if node.document.attr? 'icons', 'font'
-            marker_checked = '<i class="fa fa-check-square-o"></i> '
-            marker_unchecked = '<i class="fa fa-square-o"></i> '
-          else
-            marker_checked = '&#10003; '
-            marker_unchecked = '&#10063; '
-          end
+          marker_checked = '<input type="checkbox" data-item-complete="1" checked> '
+          marker_unchecked = '<input type="checkbox" data-item-complete="0"> '
         end
+      elsif node.document.attr? 'icons', 'font'
+        marker_checked = '<i class="fa fa-check-square-o"></i> '
+        marker_unchecked = '<i class="fa fa-square-o"></i> '
       else
-        ul_class_attribute = node.style ? %( class="#{node.style}") : ''
+        marker_checked = '&#10003; '
+        marker_unchecked = '&#10063; '
       end
-      result << %(<div#{id_attribute} class="#{div_classes.join ' '}">)
-      result << %(<div class="title">#{node.title}</div>) if node.title?
-      result << %(<ul#{ul_class_attribute}>)
-      node.items.each do |item|
+    else
+      ul_class_attribute = node.style ? %( class="#{node.style}") : ''
+    end
+    result << %(<div#{id_attribute} class="#{div_classes.join ' '}">)
+    result << %(<div class="title">#{node.title}</div>) if node.title?
+    result << %(<ul#{ul_class_attribute}>)
+    node.items.each do |item|
+      if item.id
+        result << %(<li id="#{item.id}"#{item.role ? %[ class="#{item.role}"] : ''}>)
+      elsif item.role
+        result << %(<li class="#{item.role}">)
+      else
         result << '<li>'
-        if checklist && (item.attr? 'checkbox')
-          result << %(<p>#{(item.attr? 'checked') ? marker_checked : marker_unchecked}#{item.text}</p>)
-        else
-          result << %(<p>#{item.text}</p>)
-        end
-        result << item.content if item.blocks?
-        result << '</li>'
       end
-      result << '</ul>'
-      result << '</div>'
-      result.join LF
-    end
-    def verse node
-      id_attribute = node.id ? %( id="#{node.id}") : ''
-      classes = ['verseblock', node.role].compact
-      class_attribute = %( class="#{classes.join ' '}")
-      title_element = node.title? ? %(\n<div class="title">#{node.title}</div>) : ''
-      attribution = (node.attr? 'attribution') ? (node.attr 'attribution') : nil
-      citetitle = (node.attr? 'citetitle') ? (node.attr 'citetitle') : nil
-      if attribution || citetitle
-        cite_element = citetitle ? %(<cite>#{citetitle}</cite>) : ''
-        attribution_text = attribution ? %(&#8212; #{attribution}#{citetitle ? "<br#{@void_element_slash}>\n" : ''}) : ''
-        attribution_element = %(\n<div class="attribution">\n#{attribution_text}#{cite_element}\n</div>)
+      if checklist && (item.attr? 'checkbox')
+        result << %(<p>#{(item.attr? 'checked') ? marker_checked : marker_unchecked}#{item.text}</p>)
       else
-        attribution_element = ''
+        result << %(<p>#{item.text}</p>)
       end
+      result << item.content if item.blocks?
+      result << '</li>'
+    end
-      %(<div#{id_attribute}#{class_attribute}>#{title_element}
+    result << '</ul>'
+    result << '</div>'
+    result.join LF
+  end
+  def convert_verse node
+    id_attribute = node.id ? %( id="#{node.id}") : ''
+    classes = ['verseblock', node.role].compact
+    class_attribute = %( class="#{classes.join ' '}")
+    title_element = node.title? ? %(\n<div class="title">#{node.title}</div>) : ''
+    attribution = (node.attr? 'attribution') ? (node.attr 'attribution') : nil
+    citetitle = (node.attr? 'citetitle') ? (node.attr 'citetitle') : nil
+    if attribution || citetitle
+      cite_element = citetitle ? %(<cite>#{citetitle}</cite>) : ''
+      attribution_text = attribution ? %(&#8212; #{attribution}#{citetitle ? "<br#{@void_element_slash}>\n" : ''}) : ''
+      attribution_element = %(\n<div class="attribution">\n#{attribution_text}#{cite_element}\n</div>)
+    else
+      attribution_element = ''
+    end
+    %(<div#{id_attribute}#{class_attribute}>#{title_element}
 <pre class="content">#{node.content}</pre>#{attribution_element}
 </div>)
-    end
+  end
-    def video node
-      xml = @xml_mode
-      id_attribute = node.id ? %( id="#{node.id}") : ''
-      classes = ['videoblock']
-      classes << (node.attr 'float') if node.attr? 'float'
-      classes << %(text-#{node.attr 'align'}) if node.attr? 'align'
-      classes << node.role if node.role
-      class_attribute = %( class="#{classes.join ' '}")
-      title_element = node.title? ? %(\n<div class="title">#{node.title}</div>) : ''
-      width_attribute = (node.attr? 'width') ? %( width="#{node.attr 'width'}") : ''
-      height_attribute = (node.attr? 'height') ? %( height="#{node.attr 'height'}") : ''
-      case node.attr 'poster'
-      when 'vimeo'
-        unless (asset_uri_scheme = (node.document.attr 'asset-uri-scheme', 'https')).empty?
-          asset_uri_scheme = %(#{asset_uri_scheme}:)
-        end
-        start_anchor = (node.attr? 'start', nil, false) ? %(#at=#{node.attr 'start'}) : ''
-        delimiter = '?'
-        if node.option? 'autoplay'
-          autoplay_param = %(#{delimiter}autoplay=1)
-          delimiter = '&amp;'
-        else
-          autoplay_param = ''
-        end
-        loop_param = (node.option? 'loop') ? %(#{delimiter}loop=1) : ''
-        %(<div#{id_attribute}#{class_attribute}>#{title_element}
+  def convert_video node
+    xml = @xml_mode
+    id_attribute = node.id ? %( id="#{node.id}") : ''
+    classes = ['videoblock']
+    classes << (node.attr 'float') if node.attr? 'float'
+    classes << %(text-#{node.attr 'align'}) if node.attr? 'align'
+    classes << node.role if node.role
+    class_attribute = %( class="#{classes.join ' '}")
+    title_element = node.title? ? %(\n<div class="title">#{node.title}</div>) : ''
+    width_attribute = (node.attr? 'width') ? %( width="#{node.attr 'width'}") : ''
+    height_attribute = (node.attr? 'height') ? %( height="#{node.attr 'height'}") : ''
+    case node.attr 'poster'
+    when 'vimeo'
+      unless (asset_uri_scheme = (node.document.attr 'asset-uri-scheme', 'https')).empty?
+        asset_uri_scheme = %(#{asset_uri_scheme}:)
+      end
+      start_anchor = (node.attr? 'start') ? %(#at=#{node.attr 'start'}) : ''
+      delimiter = ['?']
+      target, hash = (node.attr 'target').split '/', 2
+      hash_param = (hash ||= node.attr 'hash') ? %(#{delimiter.pop || '&amp;'}h=#{hash}) : ''
+      autoplay_param = (node.option? 'autoplay') ? %(#{delimiter.pop || '&amp;'}autoplay=1) : ''
+      loop_param = (node.option? 'loop') ? %(#{delimiter.pop || '&amp;'}loop=1) : ''
+      muted_param = (node.option? 'muted') ? %(#{delimiter.pop || '&amp;'}muted=1) : ''
+      %(<div#{id_attribute}#{class_attribute}>#{title_element}
 <div class="content">
-<iframe#{width_attribute}#{height_attribute} src="#{asset_uri_scheme}//player.vimeo.com/video/#{node.attr 'target'}#{start_anchor}#{autoplay_param}#{loop_param}" frameborder="0"#{(node.option? 'nofullscreen') ? '' : (append_boolean_attribute 'allowfullscreen', xml)}></iframe>
+<iframe#{width_attribute}#{height_attribute} src="#{asset_uri_scheme}//player.vimeo.com/video/#{target}#{hash_param}#{autoplay_param}#{loop_param}#{muted_param}#{start_anchor}" frameborder="0"#{(node.option? 'nofullscreen') ? '' : (append_boolean_attribute 'allowfullscreen', xml)}></iframe>
 </div>
 </div>)
-      when 'youtube'
-        unless (asset_uri_scheme = (node.document.attr 'asset-uri-scheme', 'https')).empty?
-          asset_uri_scheme = %(#{asset_uri_scheme}:)
-        end
-        rel_param_val = (node.option? 'related') ? 1 : 0
-        # NOTE start and end must be seconds (t parameter allows XmYs where X is minutes and Y is seconds)
-        start_param = (node.attr? 'start', nil, false) ? %(&amp;start=#{node.attr 'start'}) : ''
-        end_param = (node.attr? 'end', nil, false) ? %(&amp;end=#{node.attr 'end'}) : ''
-        autoplay_param = (node.option? 'autoplay') ? '&amp;autoplay=1' : ''
-        loop_param = (has_loop_param = node.option? 'loop') ? '&amp;loop=1' : ''
-        controls_param = (node.option? 'nocontrols') ? '&amp;controls=0' : ''
-        # cover both ways of controlling fullscreen option
-        if node.option? 'nofullscreen'
-          fs_param = '&amp;fs=0'
-          fs_attribute = ''
-        else
-          fs_param = ''
-          fs_attribute = append_boolean_attribute 'allowfullscreen', xml
-        end
-        modest_param = (node.option? 'modest') ? '&amp;modestbranding=1' : ''
-        theme_param = (node.attr? 'theme', nil, false) ? %(&amp;theme=#{node.attr 'theme'}) : ''
-        hl_param = (node.attr? 'lang') ? %(&amp;hl=#{node.attr 'lang'}) : ''
-        # parse video_id/list_id syntax where list_id (i.e., playlist) is optional
-        target, list = (node.attr 'target').split '/', 2
-        if (list ||= (node.attr 'list', nil, false))
-          list_param = %(&amp;list=#{list})
+    when 'youtube'
+      unless (asset_uri_scheme = (node.document.attr 'asset-uri-scheme', 'https')).empty?
+        asset_uri_scheme = %(#{asset_uri_scheme}:)
+      end
+      rel_param_val = (node.option? 'related') ? 1 : 0
+      # NOTE start and end must be seconds (t parameter allows XmYs where X is minutes and Y is seconds)
+      start_param = (node.attr? 'start') ? %(&amp;start=#{node.attr 'start'}) : ''
+      end_param = (node.attr? 'end') ? %(&amp;end=#{node.attr 'end'}) : ''
+      autoplay_param = (node.option? 'autoplay') ? '&amp;autoplay=1' : ''
+      loop_param = (has_loop_param = node.option? 'loop') ? '&amp;loop=1' : ''
+      mute_param = (node.option? 'muted') ? '&amp;mute=1' : ''
+      controls_param = (node.option? 'nocontrols') ? '&amp;controls=0' : ''
+      # cover both ways of controlling fullscreen option
+      if node.option? 'nofullscreen'
+        fs_param = '&amp;fs=0'
+        fs_attribute = ''
+      else
+        fs_param = ''
+        fs_attribute = append_boolean_attribute 'allowfullscreen', xml
+      end
+      modest_param = (node.option? 'modest') ? '&amp;modestbranding=1' : ''
+      theme_param = (node.attr? 'theme') ? %(&amp;theme=#{node.attr 'theme'}) : ''
+      hl_param = (node.attr? 'lang') ? %(&amp;hl=#{node.attr 'lang'}) : ''
+      # parse video_id/list_id syntax where list_id (i.e., playlist) is optional
+      target, list = (node.attr 'target').split '/', 2
+      if (list ||= (node.attr 'list'))
+        list_param = %(&amp;list=#{list})
+      else
+        # parse dynamic playlist syntax: video_id1,video_id2,...
+        target, playlist = target.split ',', 2
+        if (playlist ||= (node.attr 'playlist'))
+          # INFO playlist bar doesn't appear in Firefox unless showinfo=1 and modestbranding=1
+          list_param = %(&amp;playlist=#{target},#{playlist})
         else
-          # parse dynamic playlist syntax: video_id1,video_id2,...
-          target, playlist = target.split ',', 2
-          if (playlist ||= (node.attr 'playlist', nil, false))
-            # INFO playlist bar doesn't appear in Firefox unless showinfo=1 and modestbranding=1
-            list_param = %(&amp;playlist=#{playlist})
-          else
-            # NOTE for loop to work, playlist must be specified; use VIDEO_ID if there's no explicit playlist
-            list_param = has_loop_param ? %(&amp;playlist=#{target}) : ''
-          end
+          # NOTE for loop to work, playlist must be specified; use VIDEO_ID if there's no explicit playlist
+          list_param = has_loop_param ? %(&amp;playlist=#{target}) : ''
         end
+      end
-        %(<div#{id_attribute}#{class_attribute}>#{title_element}
+      %(<div#{id_attribute}#{class_attribute}>#{title_element}
 <div class="content">
-<iframe#{width_attribute}#{height_attribute} src="#{asset_uri_scheme}//www.youtube.com/embed/#{target}?rel=#{rel_param_val}#{start_param}#{end_param}#{autoplay_param}#{loop_param}#{controls_param}#{list_param}#{fs_param}#{modest_param}#{theme_param}#{hl_param}" frameborder="0"#{fs_attribute}></iframe>
+<iframe#{width_attribute}#{height_attribute} src="#{asset_uri_scheme}//www.youtube.com/embed/#{target}?rel=#{rel_param_val}#{start_param}#{end_param}#{autoplay_param}#{loop_param}#{mute_param}#{controls_param}#{list_param}#{fs_param}#{modest_param}#{theme_param}#{hl_param}" frameborder="0"#{fs_attribute}></iframe>
 </div>
 </div>)
-      else
-        poster_attribute = (val = node.attr 'poster', nil, false).nil_or_empty? ? '' : %( poster="#{node.media_uri val}")
-        preload_attribute = (val = node.attr 'preload', nil, false).nil_or_empty? ? '' : %( preload="#{val}")
-        start_t = node.attr 'start', nil, false
-        end_t = node.attr 'end', nil, false
-        time_anchor = (start_t || end_t) ? %(#t=#{start_t || ''}#{end_t ? ",#{end_t}" : ''}) : ''
-        %(<div#{id_attribute}#{class_attribute}>#{title_element}
+    else
+      poster_attribute = (val = node.attr 'poster').nil_or_empty? ? '' : %( poster="#{node.media_uri val}")
+      preload_attribute = (val = node.attr 'preload').nil_or_empty? ? '' : %( preload="#{val}")
+      start_t = node.attr 'start'
+      end_t = node.attr 'end'
+      time_anchor = (start_t || end_t) ? %(#t=#{start_t || ''}#{end_t ? ",#{end_t}" : ''}) : ''
+      %(<div#{id_attribute}#{class_attribute}>#{title_element}
 <div class="content">
-<video src="#{node.media_uri(node.attr 'target')}#{time_anchor}"#{width_attribute}#{height_attribute}#{poster_attribute}#{(node.option? 'autoplay') ? (append_boolean_attribute 'autoplay', xml) : ''}#{(node.option? 'nocontrols') ? '' : (append_boolean_attribute 'controls', xml)}#{(node.option? 'loop') ? (append_boolean_attribute 'loop', xml) : ''}#{preload_attribute}>
+<video src="#{node.media_uri(node.attr 'target')}#{time_anchor}"#{width_attribute}#{height_attribute}#{poster_attribute}#{(node.option? 'autoplay') ? (append_boolean_attribute 'autoplay', xml) : ''}#{(node.option? 'muted') ? (append_boolean_attribute 'muted', xml) : ''}#{(node.option? 'nocontrols') ? '' : (append_boolean_attribute 'controls', xml)}#{(node.option? 'loop') ? (append_boolean_attribute 'loop', xml) : ''}#{preload_attribute}>
 Your browser does not support the video tag.
 </video>
 </div>
 </div>)
-      end
     end
+  end
-    def inline_anchor node
-      case node.type
-      when :xref
-        if (path = node.attributes['path'])
-          attrs = (append_link_constraint_attrs node, node.role ? [%( class="#{node.role}")] : []).join
-          text = node.text || path
-        else
-          attrs = node.role ? %( class="#{node.role}") : ''
-          unless (text = node.text)
-            refid = node.attributes['refid']
-            if AbstractNode === (ref = (@refs ||= node.document.catalog[:refs])[refid])
-              text = (ref.xreftext node.attr('xrefstyle')) || %([#{refid}])
+  def convert_inline_anchor node
+    case node.type
+    when :xref
+      if (path = node.attributes['path'])
+        attrs = (append_link_constraint_attrs node, node.role ? [%( class="#{node.role}")] : []).join
+        text = node.text || path
+      else
+        attrs = node.role ? %( class="#{node.role}") : ''
+        unless (text = node.text)
+          if AbstractNode === (ref = (@refs ||= node.document.catalog[:refs])[refid = node.attributes['refid']] || (refid.nil_or_empty? ? (top = get_root_document node) : nil))
+            if (@resolving_xref ||= (outer = true)) && outer
+              if (text = ref.xreftext node.attr 'xrefstyle', nil, true)
+                text = text.gsub DropAnchorRx, '' if text.include? '<a'
+              else
+                text = top ? '[^top]' : %([#{refid}])
+              end
+              @resolving_xref = nil
             else
-              text = %([#{refid}])
+              text = top ? '[^top]' : %([#{refid}])
             end
+          else
+            text = %([#{refid}])
           end
         end
-        %(<a href="#{node.target}"#{attrs}>#{text}</a>)
-      when :ref
-        %(<a id="#{node.id}"></a>)
-      when :link
-        attrs = node.id ? [%( id="#{node.id}")] : []
-        attrs << %( class="#{node.role}") if node.role
-        attrs << %( title="#{node.attr 'title'}") if node.attr? 'title', nil, false
-        %(<a href="#{node.target}"#{(append_link_constraint_attrs node, attrs).join}>#{node.text}</a>)
-      when :bibref
-        # NOTE technically node.text should be node.reftext, but subs have already been applied to text
-        %(<a id="#{node.id}"></a>#{node.text})
-      else
-        logger.warn %(unknown anchor type: #{node.type.inspect})
-        nil
       end
+      %(<a href="#{node.target}"#{attrs}>#{text}</a>)
+    when :ref
+      %(<a id="#{node.id}"></a>)
+    when :link
+      attrs = node.id ? [%( id="#{node.id}")] : []
+      attrs << %( class="#{node.role}") if node.role
+      attrs << %( title="#{node.attr 'title'}") if node.attr? 'title'
+      %(<a href="#{node.target}"#{(append_link_constraint_attrs node, attrs).join}>#{node.text}</a>)
+    when :bibref
+      %(<a id="#{node.id}"></a>[#{node.reftext || node.id}])
+    else
+      logger.warn %(unknown anchor type: #{node.type.inspect})
+      nil
     end
+  end
-    def inline_break node
-      %(#{node.text}<br#{@void_element_slash}>)
-    end
+  def convert_inline_break node
+    %(#{node.text}<br#{@void_element_slash}>)
+  end
-    def inline_button node
-      %(<b class="button">#{node.text}</b>)
-    end
+  def convert_inline_button node
+    %(<b class="button">#{node.text}</b>)
+  end
-    def inline_callout node
-      if node.document.attr? 'icons', 'font'
-        %(<i class="conum" data-value="#{node.text}"></i><b>(#{node.text})</b>)
-      elsif node.document.attr? 'icons'
-        src = node.icon_uri("callouts/#{node.text}")
-        %(<img src="#{src}" alt="#{node.text}"#{@void_element_slash}>)
-      else
-        %(#{node.attributes['guard']}<b class="conum">(#{node.text})</b>)
-      end
+  def convert_inline_callout node
+    if node.document.attr? 'icons', 'font'
+      %(<i class="conum" data-value="#{node.text}"></i><b>(#{node.text})</b>)
+    elsif node.document.attr? 'icons'
+      src = node.icon_uri("callouts/#{node.text}")
+      %(<img src="#{src}" alt="#{node.text}"#{@void_element_slash}>)
+    elsif ::Array === (guard = node.attributes['guard'])
+      %(&lt;!--<b class="conum">(#{node.text})</b>--&gt;)
+    else
+      %(#{guard}<b class="conum">(#{node.text})</b>)
     end
+  end
-    def inline_footnote node
-      if (index = node.attr 'index', nil, false)
-        if node.type == :xref
-          %(<sup class="footnoteref">[<a class="footnote" href="#_footnotedef_#{index}" title="View footnote.">#{index}</a>]</sup>)
-        else
-          id_attr = node.id ? %( id="_footnote_#{node.id}") : ''
-          %(<sup class="footnote"#{id_attr}>[<a id="_footnoteref_#{index}" class="footnote" href="#_footnotedef_#{index}" title="View footnote.">#{index}</a>]</sup>)
-        end
-      elsif node.type == :xref
-        %(<sup class="footnoteref red" title="Unresolved footnote reference.">[#{node.text}]</sup>)
+  def convert_inline_footnote node
+    if (index = node.attr 'index')
+      if node.type == :xref
+        %(<sup class="footnoteref">[<a class="footnote" href="#_footnotedef_#{index}" title="View footnote.">#{index}</a>]</sup>)
+      else
+        id_attr = node.id ? %( id="_footnote_#{node.id}") : ''
+        %(<sup class="footnote"#{id_attr}>[<a id="_footnoteref_#{index}" class="footnote" href="#_footnotedef_#{index}" title="View footnote.">#{index}</a>]</sup>)
       end
+    elsif node.type == :xref
+      %(<sup class="footnoteref red" title="Unresolved footnote reference.">[#{node.text}]</sup>)
     end
+  end
-    def inline_image node
-      if (type = node.type) == 'icon' && (node.document.attr? 'icons', 'font')
-        class_attr_val = %(fa fa-#{node.target})
-        {'size' => 'fa-', 'rotate' => 'fa-rotate-', 'flip' => 'fa-flip-'}.each do |key, prefix|
-          class_attr_val = %(#{class_attr_val} #{prefix}#{node.attr key}) if node.attr? key
+  def convert_inline_image node
+    target = node.target
+    if (type = node.type || 'image') == 'icon'
+      if (icons = node.document.attr 'icons') == 'font'
+        i_class_attr_val = %(fa fa-#{target})
+        i_class_attr_val = %(#{i_class_attr_val} fa-#{node.attr 'size'}) if node.attr? 'size'
+        if node.attr? 'flip'
+          i_class_attr_val = %(#{i_class_attr_val} fa-flip-#{node.attr 'flip'})
+        elsif node.attr? 'rotate'
+          i_class_attr_val = %(#{i_class_attr_val} fa-rotate-#{node.attr 'rotate'})
         end
-        title_attr = (node.attr? 'title') ? %( title="#{node.attr 'title'}") : ''
-        img = %(<i class="#{class_attr_val}"#{title_attr}></i>)
-      elsif type == 'icon' && !(node.document.attr? 'icons')
-        img = %([#{node.alt}])
+        attrs = (node.attr? 'title') ? %( title="#{node.attr 'title'}") : ''
+        img = %(<i class="#{i_class_attr_val}"#{attrs}></i>)
+      elsif icons
+        attrs = (node.attr? 'width') ? %( width="#{node.attr 'width'}") : ''
+        attrs = %(#{attrs} height="#{node.attr 'height'}") if node.attr? 'height'
+        attrs = %(#{attrs} title="#{node.attr 'title'}") if node.attr? 'title'
+        img = %(<img src="#{node.icon_uri target}" alt="#{encode_attribute_value node.alt}"#{attrs}#{@void_element_slash}>)
       else
-        target = node.target
-        attrs = ['width', 'height', 'title'].map {|name| (node.attr? name) ? %( #{name}="#{node.attr name}") : '' }.join
-        if type != 'icon' && ((node.attr? 'format', 'svg', false) || (target.include? '.svg')) &&
-            node.document.safe < SafeMode::SECURE && ((svg = (node.option? 'inline')) || (obj = (node.option? 'interactive')))
-          if svg
-            img = (read_svg_contents node, target) || %(<span class="alt">#{node.alt}</span>)
-          elsif obj
-            fallback = (node.attr? 'fallback') ? %(<img src="#{node.image_uri(node.attr 'fallback')}" alt="#{encode_quotes node.alt}"#{attrs}#{@void_element_slash}>) : %(<span class="alt">#{node.alt}</span>)
-            img = %(<object type="image/svg+xml" data="#{node.image_uri target}"#{attrs}>#{fallback}</object>)
-          end
-        end
-        img ||= %(<img src="#{type == 'icon' ? (node.icon_uri target) : (node.image_uri target)}" alt="#{encode_quotes node.alt}"#{attrs}#{@void_element_slash}>)
-      end
-      if node.attr? 'link', nil, false
-        img = %(<a class="image" href="#{node.attr 'link'}"#{(append_link_constraint_attrs node).join}>#{img}</a>)
+        img = %([#{node.alt}&#93;)
       end
-      if (role = node.role)
-        if node.attr? 'float'
-          class_attr_val = %(#{type} #{node.attr 'float'} #{role})
+    else
+      attrs = (node.attr? 'width') ? %( width="#{node.attr 'width'}") : ''
+      attrs = %(#{attrs} height="#{node.attr 'height'}") if node.attr? 'height'
+      attrs = %(#{attrs} title="#{node.attr 'title'}") if node.attr? 'title'
+      if ((node.attr? 'format', 'svg') || (target.include? '.svg')) && node.document.safe < SafeMode::SECURE
+        if node.option? 'inline'
+          img = (read_svg_contents node, target) || %(<span class="alt">#{node.alt}</span>)
+        elsif node.option? 'interactive'
+          fallback = (node.attr? 'fallback') ? %(<img src="#{node.image_uri node.attr 'fallback'}" alt="#{encode_attribute_value node.alt}"#{attrs}#{@void_element_slash}>) : %(<span class="alt">#{node.alt}</span>)
+          img = %(<object type="image/svg+xml" data="#{node.image_uri target}"#{attrs}>#{fallback}</object>)
         else
-          class_attr_val = %(#{type} #{role})
+          img = %(<img src="#{node.image_uri target}" alt="#{encode_attribute_value node.alt}"#{attrs}#{@void_element_slash}>)
         end
-      elsif node.attr? 'float'
-        class_attr_val = %(#{type} #{node.attr 'float'})
       else
-        class_attr_val = type
+        img = %(<img src="#{node.image_uri target}" alt="#{encode_attribute_value node.alt}"#{attrs}#{@void_element_slash}>)
       end
-      %(<span class="#{class_attr_val}">#{img}</span>)
     end
+    img = %(<a class="image" href="#{node.attr 'link'}"#{(append_link_constraint_attrs node).join}>#{img}</a>) if node.attr? 'link'
+    class_attr_val = type
+    if (role = node.role)
+      class_attr_val = (node.attr? 'float') ? %(#{class_attr_val} #{node.attr 'float'} #{role}) : %(#{class_attr_val} #{role})
+    elsif node.attr? 'float'
+      class_attr_val = %(#{class_attr_val} #{node.attr 'float'})
+    end
+    %(<span class="#{class_attr_val}">#{img}</span>)
+  end
-    def inline_indexterm node
-      node.type == :visible ? node.text : ''
+  def convert_inline_indexterm node
+    node.type == :visible ? node.text : ''
+  end
+  def convert_inline_kbd node
+    if (keys = node.attr 'keys').size == 1
+      %(<kbd>#{keys[0]}</kbd>)
+    else
+      %(<span class="keyseq"><kbd>#{keys.join '</kbd>+<kbd>'}</kbd></span>)
     end
+  end
-    def inline_kbd node
-      if (keys = node.attr 'keys').size == 1
-        %(<kbd>#{keys[0]}</kbd>)
+  def convert_inline_menu node
+    caret = (node.document.attr? 'icons', 'font') ? '&#160;<i class="fa fa-angle-right caret"></i> ' : '&#160;<b class="caret">&#8250;</b> '
+    submenu_joiner = %(</b>#{caret}<b class="submenu">)
+    menu = node.attr 'menu'
+    if (submenus = node.attr 'submenus').empty?
+      if (menuitem = node.attr 'menuitem')
+        %(<span class="menuseq"><b class="menu">#{menu}</b>#{caret}<b class="menuitem">#{menuitem}</b></span>)
       else
-        %(<span class="keyseq"><kbd>#{keys.join '</kbd>+<kbd>'}</kbd></span>)
+        %(<b class="menuref">#{menu}</b>)
       end
+    else
+      %(<span class="menuseq"><b class="menu">#{menu}</b>#{caret}<b class="submenu">#{submenus.join submenu_joiner}</b>#{caret}<b class="menuitem">#{node.attr 'menuitem'}</b></span>)
     end
+  end
-    def inline_menu node
-      caret = (node.document.attr? 'icons', 'font') ? '&#160;<i class="fa fa-angle-right caret"></i> ' : '&#160;<b class="caret">&#8250;</b> '
-      submenu_joiner = %(</b>#{caret}<b class="submenu">)
-      menu = node.attr 'menu'
-      if (submenus = node.attr 'submenus').empty?
-        if (menuitem = node.attr 'menuitem', nil, false)
-          %(<span class="menuseq"><b class="menu">#{menu}</b>#{caret}<b class="menuitem">#{menuitem}</b></span>)
-        else
-          %(<b class="menuref">#{menu}</b>)
-        end
+  def convert_inline_quoted node
+    open, close, tag = QUOTE_TAGS[node.type]
+    if node.id
+      class_attr = node.role ? %( class="#{node.role}") : ''
+      if tag
+        %(#{open.chop} id="#{node.id}"#{class_attr}>#{node.text}#{close})
+      else
+        %(<span id="#{node.id}"#{class_attr}>#{open}#{node.text}#{close}</span>)
+      end
+    elsif node.role
+      if tag
+        %(#{open.chop} class="#{node.role}">#{node.text}#{close})
       else
-        %(<span class="menuseq"><b class="menu">#{menu}</b>#{caret}<b class="submenu">#{submenus.join submenu_joiner}</b>#{caret}<b class="menuitem">#{node.attr 'menuitem'}</b></span>)
+        %(<span class="#{node.role}">#{open}#{node.text}#{close}</span>)
       end
+    else
+      %(#{open}#{node.text}#{close})
     end
+  end
-    def inline_quoted node
-      open, close, is_tag = QUOTE_TAGS[node.type]
-      class_attr = %( class="#{node.role}") if node.role
-      id_attr = %( id="#{node.id}") if node.id
-      if class_attr || id_attr
-        if is_tag
-          %(#{open.chop}#{id_attr || ''}#{class_attr || ''}>#{node.text}#{close})
-        else
-          %(<span#{id_attr || ''}#{class_attr || ''}>#{open}#{node.text}#{close}</span>)
+  # NOTE expose read_svg_contents for Bespoke converter
+  def read_svg_contents node, target
+    if (svg = node.read_contents target, start: (node.document.attr 'imagesdir'), normalize: true, label: 'SVG', warn_if_empty: true)
+      return if svg.empty?
+      svg = svg.sub SvgPreambleRx, '' unless svg.start_with? '<svg'
+      old_start_tag = new_start_tag = start_tag_match = nil
+      # NOTE width, height and style attributes are removed if either width or height is specified
+      ['width', 'height'].each do |dim|
+        next unless node.attr? dim
+        unless new_start_tag
+          next if (start_tag_match ||= (svg.match SvgStartTagRx) || :no_match) == :no_match
+          new_start_tag = (old_start_tag = start_tag_match[0]).gsub DimensionAttributeRx, ''
         end
-      else
-        %(#{open}#{node.text}#{close})
+        # NOTE a unitless value in HTML is assumed to be px, so we can pass the value straight through
+        new_start_tag = %(#{new_start_tag.chop} #{dim}="#{node.attr dim}">)
       end
+      svg = %(#{new_start_tag}#{svg[old_start_tag.length..-1]}) if new_start_tag
     end
+    svg
+  end
-    def append_boolean_attribute name, xml
-      xml ? %( #{name}="#{name}") : %( #{name})
-    end
+  private
+  def append_boolean_attribute name, xml
+    xml ? %( #{name}="#{name}") : %( #{name})
+  end
-    def encode_quotes val
-      (val.include? '"') ? (val.gsub '"', '&quot;') : val
+  def append_link_constraint_attrs node, attrs = []
+    rel = 'nofollow' if node.option? 'nofollow'
+    if (window = node.attributes['window'])
+      attrs << %( target="#{window}")
+      attrs << (rel ? %( rel="#{rel} noopener") : ' rel="noopener"') if window == '_blank' || (node.option? 'noopener')
+    elsif rel
+      attrs << %( rel="#{rel}")
     end
+    attrs
+  end
-    def generate_manname_section node
-      manname_title = node.attr 'manname-title', 'Name'
-      if (next_section = node.sections[0]) && (next_section_title = next_section.title) == next_section_title.upcase
-        manname_title = manname_title.upcase
-      end
-      manname_id_attr = (manname_id = node.attr 'manname-id') ? %( id="#{manname_id}") : ''
-      %(<h2#{manname_id_attr}>#{manname_title}</h2>
+  def encode_attribute_value val
+    (val.include? '"') ? (val.gsub '"', '&quot;') : val
+  end
+  def generate_manname_section node
+    manname_title = node.attr 'manname-title', 'Name'
+    if (next_section = node.sections[0]) && (next_section_title = next_section.title) == next_section_title.upcase
+      manname_title = manname_title.upcase
+    end
+    manname_id_attr = (manname_id = node.attr 'manname-id') ? %( id="#{manname_id}") : ''
+    %(<h2#{manname_id_attr}>#{manname_title}</h2>
 <div class="sectionbody">
-<p>#{node.attr 'manname'} - #{node.attr 'manpurpose'}</p>
+<p>#{(node.attr 'mannames').join ', '} - #{node.attr 'manpurpose'}</p>
 </div>)
-    end
+  end
-    def append_link_constraint_attrs node, attrs = []
-      rel = 'nofollow' if node.option? 'nofollow'
-      if (window = node.attributes['window'])
-        attrs << %( target="#{window}")
-        attrs << (rel ? %( rel="#{rel} noopener") : ' rel="noopener"') if window == '_blank' || (node.option? 'noopener')
-      elsif rel
-        attrs << %( rel="#{rel}")
-      end
-      attrs
+  def get_root_document node
+    while (node = node.document).nested?
+      node = node.parent_document
     end
+    node
+  end
-    def read_svg_contents node, target
-      if (svg = node.read_contents target, :start => (node.document.attr 'imagesdir'), :normalize => true, :label => 'SVG')
-        svg = svg.sub SvgPreambleRx, '' unless svg.start_with? '<svg'
-        old_start_tag = new_start_tag = nil
-        # NOTE width, height and style attributes are removed if either width or height is specified
-        ['width', 'height'].each do |dim|
-          if node.attr? dim
-            new_start_tag = (old_start_tag = (svg.match SvgStartTagRx)[0]).gsub DimensionAttributeRx, '' unless new_start_tag
-            # QUESTION should we add px since it's already the default?
-            new_start_tag = %(#{new_start_tag.chop} #{dim}="#{node.attr dim}px">)
-          end
-        end
-        svg = %(#{new_start_tag}#{svg[old_start_tag.length..-1]}) if new_start_tag
-      end
-      svg
-    end
+  # NOTE adapt to older converters that relied on unprefixed method names
+  def method_missing id, *args
+    !((name = id.to_s).start_with? 'convert_') && (handles? name) ? (send %(convert_#{name}), *args) : super
   end
+  def respond_to_missing? id, *options
+    !((name = id.to_s).start_with? 'convert_') && (handles? name)
+  end
+end
 end