isodoc 1.6.1 → 1.6.6

data/lib/isodoc/gem_tasks.rb

@@ -12,12 +12,10 @@ module IsoDoc
 
     def install
       rule ".css" => [proc { |tn| tn.sub(/\.css$/, ".scss") }] do |current_task|
-        begin
-          puts(current_task)
-          compile_scss_task(current_task)
-        rescue StandardError => e
-          notify_borken_compilation(e, current_task)
-        end
+        puts(current_task)
+        compile_scss_task(current_task)
+      rescue StandardError => e
+        notify_borken_compilation(e, current_task)
       end
 
       scss_files = Rake::FileList["lib/**/*.scss"]
@@ -88,7 +86,7 @@ module IsoDoc
       text
         .gsub("/* LIQUID_COMMENT", "")
         .gsub("LIQUID_COMMENT */", "")
-        .gsub('"{{', '{{').gsub('}}"', "}}")
+        .gsub('"{{', "{{").gsub('}}"', "}}")
     end
 
     def fonts_placeholder
@@ -107,7 +105,8 @@ module IsoDoc
       require "sassc"
 
       isodoc_path = if Gem.loaded_specs["isodoc"]
-                      File.join(Gem.loaded_specs["isodoc"].full_gem_path, "lib", "isodoc")
+                      File.join(Gem.loaded_specs["isodoc"].full_gem_path,
+                                "lib", "isodoc")
                     else
                       File.join("lib", "isodoc")
                     end
@@ -119,7 +118,7 @@ module IsoDoc
       SassC::Engine.new(fonts_placeholder + sheet_content,
                         syntax: :scss,
                         importer: SasscImporter)
-                   .render
+        .render
     end
 
     def compile_scss_task(current_task)

data/lib/isodoc/headlesshtml_convert.rb

@@ -1,11 +1,10 @@
-require_relative "html_function/comments.rb"
-require_relative "html_function/footnotes.rb"
-require_relative "html_function/html.rb"
+require_relative "html_function/comments"
+require_relative "html_function/footnotes"
+require_relative "html_function/html"
 require "fileutils"
 
 module IsoDoc
   class HeadlessHtmlConvert < ::IsoDoc::Convert
-
     include HtmlFunction::Comments
     include HtmlFunction::Footnotes
     include HtmlFunction::Html
@@ -26,16 +25,18 @@ module IsoDoc
       docxml, filename, dir = convert_init(file, input_filename, debug)
       result = convert1(docxml, filename, dir)
       return result if debug
-      postprocess(result, filename + ".tmp.html", dir)
+
+      postprocess(result, "#{filename}.tmp.html", dir)
       FileUtils.rm_rf dir
-      strip_head(filename + ".tmp.html", output_filename || "#{filename}.#{@suffix}")
+      strip_head("#{filename}.tmp.html",
+                 output_filename || "#{filename}.#{@suffix}")
       FileUtils.rm_rf ["#{filename}.tmp.html", tmpimagedir]
     end
 
     def strip_head(input, output)
       file = File.read(input, encoding: "utf-8")
       doc = Nokogiri::XML(file)
-      doc.xpath("//head").each { |x| x.remove }
+      doc.xpath("//head").each(&:remove)
       doc.xpath("//html").each { |x| x.name = "div" }
       body = doc.at("//body")
       body.replace(body.children)

data/lib/isodoc/html_convert.rb

@@ -2,12 +2,15 @@ require_relative "html_function/comments"
 require_relative "html_function/footnotes"
 require_relative "html_function/html"
 require_relative "html_function/postprocess"
+require_relative "html_function/sectionsplit"
+require_relative "html_function/form"
 
 module IsoDoc
   class HtmlConvert < ::IsoDoc::Convert
 
     include HtmlFunction::Comments
     include HtmlFunction::Footnotes
+    include HtmlFunction::Form
     include HtmlFunction::Html
 
     def tmpimagedir_suffix
@@ -21,6 +24,9 @@ module IsoDoc
     end
 
     def convert(filename, file = nil, debug = false, output_filename = nil)
+      @sectionsplit and
+        return sectionsplit_convert(filename, file, debug, output_filename)
+
       ret = super
       Dir.exists?(tmpimagedir) and Dir["#{tmpimagedir}/*"].empty? and
         FileUtils.rm_r tmpimagedir

data/lib/isodoc/html_function/comments.rb

@@ -24,16 +24,16 @@ module IsoDoc::HtmlFunction
 =end
     end
 
-    def comment_link_attrs(fn, node)
-      { style: "MsoCommentReference", target: fn,
+    def comment_link_attrs(fnote, node)
+      { style: "MsoCommentReference", target: fnote,
         class: "commentLink", from: node["from"],
         to: node["to"] }
     end
 
     # add in from and to links to move the comment into place
-    def make_comment_link(out, fn, node)
-      out.span(**comment_link_attrs(fn, node)) do |s1|
-          s1.a **{ style: "mso-comment-reference:SMC_#{fn};"\
+    def make_comment_link(out, fnote, node)
+      out.span(**comment_link_attrs(fnote, node)) do |s1|
+          s1.a **{ style: "mso-comment-reference:SMC_#{fnote};"\
                    "mso-comment-date:#{node['date'].gsub(/[-:Z]/, '')}" }
         end
     end
@@ -44,9 +44,9 @@ module IsoDoc::HtmlFunction
         end
     end
 
-    def make_comment_text(node, fn)
+    def make_comment_text(node, fnote)
       noko do |xml|
-        xml.div **{ style: "mso-element:comment", id: fn } do |div|
+        xml.div **{ style: "mso-element:comment", id: fnote } do |div|
           div.span **{ style: %{mso-comment-author:"#{node['reviewer']}"} }
           make_comment_target(div)
           node.children.each { |n| parse(n, div) }
@@ -84,6 +84,7 @@ module IsoDoc::HtmlFunction
     def comment_attributes(docxml, x)
       fromlink = docxml.at("//*[@id='#{x['from']}']")
       return(nil) if fromlink.nil?
+
       tolink = docxml.at("//*[@id='#{x['to']}']") || fromlink
       target = docxml.at("//*[@id='#{x['target']}']")
       { from: fromlink, to: tolink, target: target }
@@ -98,13 +99,13 @@ module IsoDoc::HtmlFunction
       from["style"] != "mso-special-character:comment"
     end
 
-    def insert_comment_cont(from, to, target)
-      # includes_to = from.at(".//*[@id='#{to}']")
-      while !from.nil? && from["id"] != to
+    def insert_comment_cont(from, upto, target)
+      # includes_to = from.at(".//*[@id='#{upto}']")
+      while !from.nil? && from["id"] != upto
         following = from.xpath("./following::*")
-        (from = following.shift) && incl_to = from.at(".//*[@id='#{to}']")
+        (from = following.shift) && incl_to = from.at(".//*[@id='#{upto}']")
         while !incl_to.nil? && !from.nil? && skip_comment_wrap(from)
-          (from = following.shift) && incl_to = from.at(".//*[@id='#{to}']")
+          (from = following.shift) && incl_to = from.at(".//*[@id='#{upto}']")
         end
         wrap_comment_cont(from, target) if !from.nil?
       end
@@ -122,6 +123,7 @@ module IsoDoc::HtmlFunction
       comments = []
       docxml.xpath("//div[@style='mso-element:comment']").each do |c|
         next unless c["id"] && !link_order[c["id"]].nil?
+
         comments << { text: c.remove.to_s, id: c["id"] }
       end
       comments.sort! { |a, b| link_order[a[:id]] <=> link_order[b[:id]] }

data/lib/isodoc/html_function/footnotes.rb

@@ -3,6 +3,7 @@ module IsoDoc::HtmlFunction
 
     def footnotes(div)
       return if @footnotes.empty?
+
       @footnotes.each { |fn| div.parent << fn }
     end
 
@@ -44,15 +45,19 @@ module IsoDoc::HtmlFunction
     def get_table_ancestor_id(node)
       table = node.ancestors("table") || node.ancestors("figure")
       return UUIDTools::UUID.random_create.to_s if table.empty?
+
       table.last["id"]
     end
 
+    # @seen_footnote:
+    # do not output footnote text if we have already seen it for this table
+
     def table_footnote_parse(node, out)
       fn = node["reference"] || UUIDTools::UUID.random_create.to_s
       tid = get_table_ancestor_id(node)
       make_table_footnote_link(out, tid + fn, fn)
-      # do not output footnote text if we have already seen it for this table
       return if @seen_footnote.include?(tid + fn)
+
       @in_footnote = true
       out.aside **{ class: "footnote" } do |a|
         a << make_table_footnote_text(node, tid + fn, fn)
@@ -62,8 +67,9 @@ module IsoDoc::HtmlFunction
     end
 
     def footnote_parse(node, out)
-       return table_footnote_parse(node, out) if (@in_table || @in_figure) &&
-        !node.ancestors.map {|m| m.name }.include?("name")
+      return table_footnote_parse(node, out) if (@in_table || @in_figure) &&
+        !node.ancestors.map(&:name).include?("name")
+
       fn = node["reference"] || UUIDTools::UUID.random_create.to_s
       attrs = { class: "FootnoteRef", href: "#fn:#{fn}" }
       out.a **attrs do |a|
@@ -72,12 +78,13 @@ module IsoDoc::HtmlFunction
       make_footnote(node, fn)
     end
 
-    def make_footnote(node, fn)
-      return if @seen_footnote.include?(fn)
+    def make_footnote(node, fnote)
+      return if @seen_footnote.include?(fnote)
+
       @in_footnote = true
-      @footnotes << make_generic_footnote_text(node, fn)
+      @footnotes << make_generic_footnote_text(node, fnote)
       @in_footnote = false
-      @seen_footnote << fn
+      @seen_footnote << fnote
     end
   end
 end

data/lib/isodoc/html_function/form.rb

@@ -0,0 +1,62 @@
+module IsoDoc::HtmlFunction
+  module Form
+    def form_parse(node, out)
+      out.form **attr_code(id: node["id"], name: node["name"],
+                           action: node["action"]) do |div|
+        node.children.each do |n|
+          parse(n, div)
+        end
+      end
+    end
+
+    def input_parse(node, out)
+      out.input nil, **attr_code(
+        id: node["id"], name: node["name"], type: node["type"],
+        value: node["value"], disabled: node["disabled"],
+        readonly: node["readonly"], checked: node["checked"],
+        maxlength: node["maxlength"], minlength: node["minlength"]
+      )
+    end
+
+    def select_parse(node, out)
+      selected = node.at(ns("./option[@value = '#{node['value']}']"))
+      selected and selected["selected"] = true
+      out.select **attr_code(
+        id: node["id"], name: node["name"], size: node["size"],
+        disabled: node["disabled"], multiple: node["multiple"]
+      ) do |div|
+        node.children.each do |n|
+          parse(n, div)
+        end
+      end
+    end
+
+    def label_parse(node, out)
+      out.label **attr_code(for: node["for"]) do |div|
+        node.children.each do |n|
+          parse(n, div)
+        end
+      end
+    end
+
+    def option_parse(node, out)
+      out.option **attr_code(
+        disabled: node["disabled"], selected: node["selected"],
+        value: node["value"]
+      ) do |o|
+        node.children.each do |n|
+          parse(n, o)
+        end
+      end
+    end
+
+    def textarea_parse(node, out)
+      out.textarea **attr_code(
+        id: node["id"], name: node["name"], rows: node["rows"],
+        cols: node["cols"]
+      ) do |div|
+        node["value"] and div << node["value"]
+      end
+    end
+  end
+end

data/lib/isodoc/html_function/html.rb

@@ -5,9 +5,9 @@ module IsoDoc::HtmlFunction
   module Html
     def convert1(docxml, filename, dir)
       noko do |xml|
-        xml.html **{ lang: "#{@lang}" } do |html|
+        xml.html **{ lang: @lang.to_s } do |html|
           info docxml, nil
-          populate_css()
+          populate_css
           html.head { |head| define_head head, filename, dir }
           make_body(html, docxml)
         end
@@ -15,13 +15,17 @@ module IsoDoc::HtmlFunction
     end
 
     def make_body1(body, _docxml)
+      return if @bare
+
       body.div **{ class: "title-section" } do |div1|
         div1.p { |p| p << "&nbsp;" } # placeholder
       end
       section_break(body)
     end
 
-    def make_body2(body, docxml)
+    def make_body2(body, _docxml)
+      return if @bare
+
       body.div **{ class: "prefatory-section" } do |div2|
         div2.p { |p| p << "&nbsp;" } # placeholder
       end
@@ -43,46 +47,47 @@ module IsoDoc::HtmlFunction
       end
     end
 
-    def googlefonts()
+    def googlefonts
       <<~HEAD.freeze
-      <link href="https://fonts.googleapis.com/css?family=Overpass:300,300i,600,900" rel="stylesheet">
-    <link href="https://fonts.googleapis.com/css?family=Lato:400,400i,700,900" rel="stylesheet">
+        <link href="https://fonts.googleapis.com/css?family=Overpass:300,300i,600,900" rel="stylesheet">
+        <link href="https://fonts.googleapis.com/css?family=Lato:400,400i,700,900" rel="stylesheet">
       HEAD
     end
 
-    def html_head()
+    def html_head
       <<~HEAD.freeze
-    <title>#{@meta&.get&.dig(:doctitle)}</title>
-    <script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
-
-    <!--TOC script import-->
-    <script type="text/javascript"  src="https://cdn.rawgit.com/jgallen23/toc/0.3.2/dist/toc.min.js"></script>
-    <script type="text/javascript">#{toclevel}</script>
-
-    <!--Google fonts-->
-      <link rel="preconnect" href="https://fonts.gstatic.com"> 
-      #{googlefonts}
-    <!--Font awesome import for the link icon-->
-    <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.0.8/css/solid.css" integrity="sha384-v2Tw72dyUXeU3y4aM2Y0tBJQkGfplr39mxZqlTBDUZAb9BGoC40+rdFCG0m10lXk" crossorigin="anonymous">
-    <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.0.8/css/fontawesome.css" integrity="sha384-q3jl8XQu1OpdLgGFvNRnPdj5VIlCvgsDQTQB6owSOHWlAurxul7f+JpUOVdAiJ5P" crossorigin="anonymous">
-    <style class="anchorjs"></style>
+        <title>#{@meta&.get&.dig(:doctitle)}</title>
+        <script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
+
+        <!--TOC script import-->
+        <script type="text/javascript"  src="https://cdn.rawgit.com/jgallen23/toc/0.3.2/dist/toc.min.js"></script>
+        <script type="text/javascript">#{toclevel}</script>
+
+        <!--Google fonts-->
+        <link rel="preconnect" href="https://fonts.gstatic.com">#{' '}
+        #{googlefonts}
+        <!--Font awesome import for the link icon-->
+        <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.0.8/css/solid.css" integrity="sha384-v2Tw72dyUXeU3y4aM2Y0tBJQkGfplr39mxZqlTBDUZAb9BGoC40+rdFCG0m10lXk" crossorigin="anonymous">
+        <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.0.8/css/fontawesome.css" integrity="sha384-q3jl8XQu1OpdLgGFvNRnPdj5VIlCvgsDQTQB6owSOHWlAurxul7f+JpUOVdAiJ5P" crossorigin="anonymous">
+        <style class="anchorjs"></style>
       HEAD
     end
 
-    def html_button()
+    def html_button
       '<button onclick="topFunction()" id="myBtn" '\
         'title="Go to top">Top</button>'.freeze
     end
 
     def html_main(docxml)
-      docxml.at("//head").add_child(html_head())
+      docxml.at("//head").add_child(html_head)
       d = docxml.at('//div[@class="main-section"]')
       d.name = "main"
-      d.children.empty? or d.children.first.previous = html_button()
+      d.children.empty? or d.children.first.previous = html_button
     end
 
     def sourcecodelang(lang)
       return unless lang
+
       case lang.downcase
       when "javascript" then "lang-js"
       when "c" then "lang-c"
@@ -117,7 +122,6 @@ module IsoDoc::HtmlFunction
       end
     end
 
-    def table_long_strings_cleanup(docxml)
-    end
+    def table_long_strings_cleanup(docxml); end
   end
 end

data/lib/isodoc/html_function/postprocess.rb

@@ -1,224 +1,233 @@
 require "isodoc/html_function/mathvariant_to_plain"
 require_relative "postprocess_footnotes"
 
-module IsoDoc::HtmlFunction
-  module Html
-    def postprocess(result, filename, _dir)
-      result = from_xhtml(cleanup(to_xhtml(textcleanup(result))))
-      toHTML(result, filename)
-      @files_to_delete.each { |f| FileUtils.rm_rf f }
-    end
+module IsoDoc
+  module HtmlFunction
+    module Html
+      def postprocess(result, filename, _dir)
+        result = from_xhtml(cleanup(to_xhtml(textcleanup(result))))
+        toHTML(result, filename)
+        @files_to_delete.each { |f| FileUtils.rm_rf f }
+      end
 
-    def script_cdata(result)
-      result.gsub(%r{<script([^>]*)>\s*<!\[CDATA\[}m, "<script\\1>")
-        .gsub(%r{\]\]>\s*</script>}, "</script>")
-        .gsub(%r{<!\[CDATA\[\s*<script([^>]*)>}m, "<script\\1>")
-        .gsub(%r{</script>\s*\]\]>}, "</script>")
-    end
+      def script_cdata(result)
+        result.gsub(%r{<script([^>]*)>\s*<!\[CDATA\[}m, "<script\\1>")
+          .gsub(%r{\]\]>\s*</script>}, "</script>")
+          .gsub(%r{<!\[CDATA\[\s*<script([^>]*)>}m, "<script\\1>")
+          .gsub(%r{</script>\s*\]\]>}, "</script>")
+      end
 
-    def toHTML(result, filename)
-      result = from_xhtml(html_cleanup(to_xhtml(result)))
-      # result = populate_template(result, :html)
-      result = from_xhtml(move_images(to_xhtml(result)))
-      result = html5(script_cdata(inject_script(result)))
-      File.open(filename, "w:UTF-8") { |f| f.write(result) }
-    end
+      def toHTML(result, filename)
+        result = from_xhtml(html_cleanup(to_xhtml(result)))
+        # result = populate_template(result, :html)
+        result = from_xhtml(move_images(to_xhtml(result)))
+        result = html5(script_cdata(inject_script(result)))
+        File.open(filename, "w:UTF-8") { |f| f.write(result) }
+      end
 
-    def html5(doc)
-      doc.sub(%r{<!DOCTYPE html [^>]+>}, "<!DOCTYPE html>")
-        .sub(%r{<\?xml[^>]+>}, "")
-    end
+      def html5(doc)
+        doc.sub(%r{<!DOCTYPE html [^>]+>}, "<!DOCTYPE html>")
+          .sub(%r{<\?xml[^>]+>}, "")
+      end
 
-    def html_cleanup(x)
-      mathml(
-        footnote_format(
-          footnote_backlinks(
-            html_toc(
-              term_header(html_footnote_filter(html_preface(htmlstyle(x))))
-            )
-          )
-        )
-      )
-    end
+      def html_cleanup(html)
+        html = term_header(html_footnote_filter(html_preface(htmlstyle(html))))
+        html = footnote_format(footnote_backlinks(html_toc(html)))
+        mathml(html_list_clean(html))
+      end
 
-    def mathml(docxml)
-      IsoDoc::HtmlFunction::MathvariantToPlain.new(docxml).convert
-    end
+      def html_list_clean(html)
+        html.xpath("//ol/div | //ul/div").each do |div|
+          li = div&.xpath("./preceding-sibling::li")&.last ||
+            div.at("./following-sibling::li")
+          div.parent = li
+        end
+        html
+      end
 
-    def htmlstylesheet(file)
-      return if file.nil?
+      def mathml(docxml)
+        IsoDoc::HtmlFunction::MathvariantToPlain.new(docxml).convert
+      end
 
-      file.open if file.is_a?(Tempfile)
-      stylesheet = file.read
-      xml = Nokogiri::XML("<style/>")
-      xml.children.first << Nokogiri::XML::Comment.new(xml, "\n#{stylesheet}\n")
-      file.close
-      file.unlink if file.is_a?(Tempfile)
-      xml.root.to_s
-    end
+      def htmlstylesheet(file)
+        return if file.nil?
+
+        file.open if file.is_a?(Tempfile)
+        stylesheet = file.read
+        xml = Nokogiri::XML("<style/>")
+        xml.children.first << Nokogiri::XML::Comment
+          .new(xml, "\n#{stylesheet}\n")
+        file.close
+        file.unlink if file.is_a?(Tempfile)
+        xml.root.to_s
+      end
 
-    def htmlstyle(docxml)
-      return docxml unless @htmlstylesheet
+      def htmlstyle(docxml)
+        return docxml unless @htmlstylesheet
 
-      title = docxml.at("//*[local-name() = 'head']/*[local-name() = 'title']")
-      head = docxml.at("//*[local-name() = 'head']")
-      head << htmlstylesheet(@htmlstylesheet)
-      s = htmlstylesheet(@htmlstylesheet_override) and head << s
-      docxml
-    end
+        head = docxml.at("//*[local-name() = 'head']")
+        head << htmlstylesheet(@htmlstylesheet)
+        s = htmlstylesheet(@htmlstylesheet_override) and head << s
+        docxml
+      end
 
-    def html_preface(docxml)
-      html_cover(docxml) if @htmlcoverpage
-      html_intro(docxml) if @htmlintropage
-      docxml.at("//body") << mathjax(@openmathdelim, @closemathdelim)
-      docxml.at("//body") << sourcecode_highlighter
-      html_main(docxml)
-      authority_cleanup(docxml)
-      docxml
-    end
+      def html_preface(docxml)
+        html_cover(docxml) if @htmlcoverpage && !@bare
+        html_intro(docxml) if @htmlintropage && !@bare
+        docxml.at("//body") << mathjax(@openmathdelim, @closemathdelim)
+        docxml.at("//body") << sourcecode_highlighter
+        html_main(docxml)
+        authority_cleanup(docxml)
+        docxml
+      end
 
-    def authority_cleanup1(docxml, klass)
-      dest = docxml.at("//div[@id = 'boilerplate-#{klass}-destination']")
-      auth = docxml.at("//div[@id = 'boilerplate-#{klass}' or @class = 'boilerplate-#{klass}']")
-      auth&.xpath(".//h1[not(text())] | .//h2[not(text())]")&.each(&:remove)
-      auth&.xpath(".//h1 | .//h2")&.each { |h| h["class"] = "IntroTitle" }
-      dest and auth and dest.replace(auth.remove)
-    end
+      def authority_cleanup1(docxml, klass)
+        dest = docxml.at("//div[@id = 'boilerplate-#{klass}-destination']")
+        auth = docxml.at("//div[@id = 'boilerplate-#{klass}' or "\
+                         "@class = 'boilerplate-#{klass}']")
+        auth&.xpath(".//h1[not(text())] | .//h2[not(text())]")&.each(&:remove)
+        auth&.xpath(".//h1 | .//h2")&.each { |h| h["class"] = "IntroTitle" }
+        dest and auth and dest.replace(auth.remove)
+      end
 
-    def authority_cleanup(docxml)
-      %w(copyright license legal feedback).each do |t|
-        authority_cleanup1(docxml, t)
+      def authority_cleanup(docxml)
+        %w(copyright license legal feedback).each do |t|
+          authority_cleanup1(docxml, t)
+        end
       end
-    end
 
-    def html_cover(docxml)
-      doc = to_xhtml_fragment(File.read(@htmlcoverpage, encoding: "UTF-8"))
-      d = docxml.at('//div[@class="title-section"]')
-      # d.children.first.add_previous_sibling doc.to_xml(encoding: "US-ASCII")
-      d.children.first.add_previous_sibling(
-        populate_template(doc.to_xml(encoding: "US-ASCII"), :html)
-      )
-    end
+      def html_cover(docxml)
+        doc = to_xhtml_fragment(File.read(@htmlcoverpage, encoding: "UTF-8"))
+        d = docxml.at('//div[@class="title-section"]')
+        # d.children.first.add_previous_sibling doc.to_xml(encoding: "US-ASCII")
+        d.children.first.add_previous_sibling(
+          populate_template(doc.to_xml(encoding: "US-ASCII"), :html),
+        )
+      end
 
-    def html_intro(docxml)
-      doc = to_xhtml_fragment(File.read(@htmlintropage, encoding: "UTF-8"))
-      d = docxml.at('//div[@class="prefatory-section"]')
-      # d.children.first.add_previous_sibling doc.to_xml(encoding: "US-ASCII")
-      d.children.first.add_previous_sibling(
-        populate_template(doc.to_xml(encoding: "US-ASCII"), :html)
-      )
-    end
+      def html_intro(docxml)
+        doc = to_xhtml_fragment(File.read(@htmlintropage, encoding: "UTF-8"))
+        d = docxml.at('//div[@class="prefatory-section"]')
+        # d.children.first.add_previous_sibling doc.to_xml(encoding: "US-ASCII")
+        d.children.first.add_previous_sibling(
+          populate_template(doc.to_xml(encoding: "US-ASCII"), :html),
+        )
+      end
 
-    def html_toc_entry(level, header)
-      %(<li class="#{level}"><a href="##{header['id']}">\
+      def html_toc_entry(level, header)
+        %(<li class="#{level}"><a href="##{header['id']}">\
       #{header_strip(header)}</a></li>)
-    end
-
-    def toclevel_classes
-      (1..@htmlToClevels).reduce([]) { |m, i| m << "h#{i}" }
-    end
+      end
 
-    def toclevel
-      ret = toclevel_classes.map do |l|
-        "#{l}:not(:empty):not(.TermNum):not(.noTOC)"
+      def toclevel_classes
+        (1..@htmlToClevels).reduce([]) { |m, i| m << "h#{i}" }
       end
-      <<~HEAD.freeze
-        function toclevel() { return "#{ret.join(',')}";}
-      HEAD
-    end
 
-    # needs to be same output as toclevel
-    def html_toc(docxml)
-      (idx = docxml.at("//div[@id = 'toc']")) or (return docxml)
-      toc = "<ul>"
-      path = toclevel_classes.map do |l|
-        "//main//#{l}[not(@class = 'TermNum')][not(@class = 'noTOC')][text()]"
+      def toclevel
+        ret = toclevel_classes.map do |l|
+          "#{l}:not(:empty):not(.TermNum):not(.noTOC)"
+        end
+        <<~HEAD.freeze
+          function toclevel() { return "#{ret.join(',')}";}
+        HEAD
       end
-      docxml.xpath(path.join(" | ")).each_with_index do |h, tocidx|
-        h["id"] ||= "toc#{tocidx}"
-        toc += html_toc_entry(h.name, h)
+
+      # needs to be same output as toclevel
+      def html_toc(docxml)
+        idx = docxml.at("//div[@id = 'toc']") or return docxml
+        toc = "<ul>"
+        path = toclevel_classes.map do |l|
+          "//main//#{l}[not(@class = 'TermNum')][not(@class = 'noTOC')][text()]"
+        end
+        docxml.xpath(path.join(" | ")).each_with_index do |h, tocidx|
+          h["id"] ||= "toc#{tocidx}"
+          toc += html_toc_entry(h.name, h)
+        end
+        idx.children = "#{toc}</ul>"
+        docxml
       end
-      idx.children = "#{toc}</ul>"
-      docxml
-    end
 
-    # presupposes that the image source is local
-    def move_images(docxml)
-      FileUtils.rm_rf tmpimagedir
-      FileUtils.mkdir tmpimagedir
-      docxml.xpath("//*[local-name() = 'img']").each do |i|
-        i["width"], i["height"] = Html2Doc.image_resize(i, image_localfile(i),
-                                                        @maxheight, @maxwidth)
-        next if /^data:/.match i["src"]
+      # presupposes that the image source is local
+      def move_images(docxml)
+        FileUtils.rm_rf tmpimagedir
+        FileUtils.mkdir tmpimagedir
+        docxml.xpath("//*[local-name() = 'img']").each do |i|
+          i["width"], i["height"] = Html2Doc.image_resize(i, image_localfile(i),
+                                                          @maxheight, @maxwidth)
+          next if /^data:/.match? i["src"]
 
-        @datauriimage ? datauri(i) : move_image1(i)
+          @datauriimage ? datauri(i) : move_image1(i)
+        end
+        docxml
       end
-      docxml
-    end
 
-    def datauri(img)
-      type = img["src"].split(".")[-1]
-      supertype = type == "xml" ? "application" : "image"
-      bin = IO.binread(image_localfile(img))
-      data = Base64.strict_encode64(bin)
-      img["src"] = "data:#{supertype}/#{type};base64,#{data}"
-    end
+      def datauri(img)
+        type = img["src"].split(".")[-1]
+        supertype = type == "xml" ? "application" : "image"
+        bin = IO.binread(image_localfile(img))
+        data = Base64.strict_encode64(bin)
+        img["src"] = "data:#{supertype}/#{type};base64,#{data}"
+      end
 
-    def image_suffix(img)
-      type = img["mimetype"]&.sub(%r{^[^/*]+/}, "")
-      matched = /\.(?<suffix>[^. \r\n\t]+)$/.match img["src"]
-      type and !type.empty? and return type
+      def image_suffix(img)
+        type = img["mimetype"]&.sub(%r{^[^/*]+/}, "")
+        matched = /\.(?<suffix>[^. \r\n\t]+)$/.match img["src"]
+        type and !type.empty? and return type
 
-      !matched.nil? and matched[:suffix] and return matched[:suffix]
-      "png"
-    end
+        !matched.nil? and matched[:suffix] and return matched[:suffix]
+        "png"
+      end
 
-    def move_image1(img)
-      suffix = image_suffix(img)
-      uuid = UUIDTools::UUID.random_create.to_s
-      fname = "#{uuid}.#{suffix}"
-      new_full_filename = File.join(tmpimagedir, fname)
-      local_filename = image_localfile(img)
-      FileUtils.cp local_filename, new_full_filename
-      img["src"] = File.join(rel_tmpimagedir, fname)
-    end
+      def move_image1(img)
+        suffix = image_suffix(img)
+        uuid = UUIDTools::UUID.random_create.to_s
+        fname = "#{uuid}.#{suffix}"
+        new_full_filename = File.join(tmpimagedir, fname)
+        local_filename = image_localfile(img)
+        FileUtils.cp local_filename, new_full_filename
+        img["src"] = File.join(rel_tmpimagedir, fname)
+      end
 
-    def inject_script(doc)
-      return doc unless @scripts
+      def inject_script(doc)
+        return doc unless @scripts
 
-      scripts = File.read(@scripts, encoding: "UTF-8")
-      a = doc.split(%r{</body>})
-      a[0] + scripts + "</body>" + a[1]
-    end
+        scripts = File.read(@scripts, encoding: "UTF-8")
+        scripts_override = ""
+        @scripts_override and
+          scripts_override = File.read(@scripts_override, encoding: "UTF-8")
+        a = doc.split(%r{</body>})
+        "#{a[0]}#{scripts}#{scripts_override}</body>#{a[1]}"
+      end
 
-    def sourcecode_highlighter
-      '<script src="https://cdn.rawgit.com/google/code-prettify/master/'\
-        'loader/run_prettify.js"></script>'
-    end
+      def sourcecode_highlighter
+        '<script src="https://cdn.rawgit.com/google/code-prettify/master/'\
+          'loader/run_prettify.js"></script>'
+      end
 
-    MATHJAX_ADDR =
-      "https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/latest.js".freeze
-    MATHJAX = <<~"MATHJAX".freeze
-      <script type="text/x-mathjax-config">
-        MathJax.Hub.Config({
-          "HTML-CSS": { preferredFont: "STIX" },
-          asciimath2jax: { delimiters: [['OPEN', 'CLOSE']] }
-       });
-      </script>
-      <script src="#{MATHJAX_ADDR}?config=MML_HTMLorMML-full" async="async"></script>
-    MATHJAX
-
-    def mathjax(open, close)
-      MATHJAX.gsub("OPEN", open).gsub("CLOSE", close)
-    end
+      MATHJAX_ADDR =
+        "https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/latest.js".freeze
+      MATHJAX = <<~"MATHJAX".freeze
+        <script type="text/x-mathjax-config">
+          MathJax.Hub.Config({
+            "HTML-CSS": { preferredFont: "STIX" },
+            asciimath2jax: { delimiters: [['OPEN', 'CLOSE']] }
+         });
+        </script>
+        <script src="#{MATHJAX_ADDR}?config=MML_HTMLorMML-full" async="async"></script>
+      MATHJAX
+
+      def mathjax(open, close)
+        MATHJAX.gsub("OPEN", open).gsub("CLOSE", close)
+      end
 
-    def term_header(docxml)
-      %w(h1 h2 h3 h4 h5 h6 h7 h8).each do |h|
-        docxml.xpath("//p[@class = 'TermNum'][../#{h}]").each do |p|
-          p.name = "h#{h[1].to_i + 1}"
+      def term_header(docxml)
+        %w(h1 h2 h3 h4 h5 h6 h7 h8).each do |h|
+          docxml.xpath("//p[@class = 'TermNum'][../#{h}]").each do |p|
+            p.name = "h#{h[1].to_i + 1}"
+          end
         end
+        docxml
       end
-      docxml
     end
   end
 end