metanorma-iso 2.0.8.1 → 2.1.2

data/lib/isodoc/iso/sections.rb

@@ -1,7 +1,7 @@
 module IsoDoc
   module Iso
     module BaseConvert
-      def middle_title(isoxml, out)
+      def middle_title(_isoxml, out)
         middle_title_main(out)
         middle_title_amd(out)
       end
@@ -9,9 +9,9 @@ module IsoDoc
       def middle_title_main(out)
         out.p(**{ class: "zzSTDTitle1" }) do |p|
           p << @meta.get[:doctitleintro]
-          p << " &mdash; " if @meta.get[:doctitleintro] && @meta.get[:doctitlemain]
+          p << " &#x2014; " if @meta.get[:doctitleintro] && @meta.get[:doctitlemain]
           p << @meta.get[:doctitlemain]
-          p << " &mdash; " if @meta.get[:doctitlemain] && @meta.get[:doctitlepart]
+          p << " &#x2014; " if @meta.get[:doctitlemain] && @meta.get[:doctitlepart]
         end
         a = @meta.get[:doctitlepart] and out.p(**{ class: "zzSTDTitle2" }) do |p|
           b = @meta.get[:doctitlepartlabel] and p << "#{b}: "

data/lib/isodoc/iso/word_cleanup.rb

@@ -44,6 +44,9 @@ module IsoDoc
         docxml.xpath("//*[@class = 'example']").each do |p|
           p["class"] = "Example"
         end
+        docxml.xpath("//*[@class = 'zzHelp']/p[not(@class)]").each do |p|
+          p["class"] = "zzHelp"
+        end
       end
 
       def authority_hdr_cleanup(docxml)
@@ -81,6 +84,7 @@ module IsoDoc
           p["class"] = "zzCopyright1"
         end
         auth and insert and insert.children = auth
+        coverpage_note_cleanup(docxml)
       end
 
       def word_cleanup(docxml)
@@ -89,6 +93,19 @@ module IsoDoc
         style_cleanup(docxml)
         docxml
       end
+
+      # supply missing annex title
+      def make_WordToC(docxml, level)
+        toc = ""
+        xpath = (1..level).each.map { |i| "//h#{i}" }.join (" | ")
+        docxml.xpath(xpath).each do |h|
+          x = ""
+          x = @anchor[h.parent["id"]][:xref] if h["class"] == "ANNEX"
+          toc += word_toc_entry(h.name[1].to_i, x + header_strip(h))
+        end
+        toc.sub(/(<p class="MsoToc1">)/,
+                %{\\1#{word_toc_preface(level)}}) + WORD_TOC_SUFFIX1
+      end
     end
   end
 end

data/lib/isodoc/iso/word_convert.rb

@@ -2,6 +2,7 @@ require_relative "base_convert"
 require "isodoc"
 require_relative "init"
 require_relative "word_cleanup"
+require_relative "word_dis_convert"
 
 module IsoDoc
   module Iso
@@ -13,6 +14,12 @@ module IsoDoc
         @wordToClevels = 3 if @wordToClevels.zero?
         @htmlToClevels = options[:htmltoclevels].to_i
         @htmlToClevels = 3 if @htmlToClevels.zero?
+        init_dis(options)
+      end
+
+      def init_dis(options)
+        @wordtemplate = options[:isowordtemplate]
+        @dis = ::IsoDoc::Iso::WordDISConvert.new(options)
       end
 
       def font_choice(options)
@@ -45,16 +52,18 @@ module IsoDoc
           olstyle: "l2" }
       end
 
-      def convert1(docxml, filename, dir)
-        @dis = /^[45].$/.match?(docxml&.at(ns("//bibdata/status/stage"))&.text)
-        if @dis
-          @wordstylesheet_name = html_doc_path("wordstyle-dis.scss")
-          @standardstylesheet_name = html_doc_path("isodoc-dis.scss")
-          @wordcoverpage = html_doc_path("word_iso_titlepage-dis.html")
-          @wordintropage = html_doc_path("word_iso_intro-dis.html")
-          @header = html_doc_path("header-dis.html")
+      def convert(input_filename, file = nil, debug = false,
+                output_filename = nil)
+        file = File.read(input_filename, encoding: "utf-8") if file.nil?
+        docxml = Nokogiri::XML(file) { |config| config.huge }
+        stage = docxml&.at(ns("//bibdata/status/stage"))&.text
+        if @dis &&
+            ((/^[4569].$/.match?(stage) && @wordtemplate != "simple") ||
+            (/^[0-3].$/.match?(stage) && @wordtemplate == "dis"))
+          @dis.convert(input_filename, file, debug, output_filename)
+        else
+          super
         end
-        super
       end
 
       def make_body(xml, docxml)
@@ -82,8 +91,8 @@ module IsoDoc
           <span lang="EN-GB"><span
             style='mso-element:field-begin'></span><span
             style='mso-spacerun:yes'>&#xA0;</span>TOC
-            \\o &quot;1-#{level}&quot; \\h \\z \\t &quot;Heading
-            1;1;ANNEX;1;Biblio Title;1;Foreword Title;1;Intro Title;1&quot; <span
+            \\o "1-#{level}" \\h \\z \\t "Heading
+            1;1;ANNEX;1;Biblio Title;1;Foreword Title;1;Intro Title;1" <span
             style='mso-element:field-separator'></span></span>
         TOC
       end
@@ -171,11 +180,22 @@ module IsoDoc
 
         name&.at(ns("./strong"))&.remove # supplied by CSS list numbering
         div.h1 **{ class: "Annex" } do |t|
-          name.children.each { |c2| parse(c2, t) }
+          annex_name1(name, t)
           clause_parse_subtitle(name, t)
         end
       end
 
+      def annex_name1(name, out)
+        name.children.each do |c2|
+          if c2.name == "span" && c2["class"] == "obligation"
+            out.span **{ style: "font-weight:normal;" } do |s|
+              c2.children.each { |c3| parse(c3, s) }
+            end
+          else parse(c2, out)
+          end
+        end
+      end
+
       include BaseConvert
       include Init
     end

data/lib/isodoc/iso/word_dis_cleanup.rb

@@ -0,0 +1,235 @@
+module IsoDoc
+  module Iso
+    class WordDISConvert < WordConvert
+      def style_cleanup(docxml)
+        super
+        dis_styles(docxml)
+      end
+
+      STYLESMAP = {
+        AltTerms: "AdmittedTerm",
+        TableFootnote: "Tablefootnote",
+        formula: "Formula",
+        note: "Note",
+        example: "Example",
+        admonition: "Admonition",
+        admonitiontitle: "AdmonitionTitle",
+        sourcetitle: "SourceTitle",
+        tabletitle: "TableTitle",
+        titlepagesbhead: "TablePageSubhead",
+        NormRef: "RefNorm",
+        Biblio: "BiblioEntry",
+        MsoNormal: "MsoBodyText",
+        FigureTitle: "Figuretitle",
+        zzwarning: "zzWarning",
+        zzwarninghdr: "zzWarningHdr",
+        quoteattribution: "QuoteAttribution",
+        Sourcecode: "Code",
+        zzSTDTitle1: "zzSTDTitle",
+        zzSTDTitle2: "zzSTDTitle",
+        zzCopyright1: "zzCopyright",
+      }.freeze
+
+      def dis_styles(docxml)
+        STYLESMAP.each do |k, v|
+          docxml.xpath("//*[@class = '#{k}']").each { |s| s["class"] = v }
+        end
+        docxml.xpath("//h1[@class = 'ForewordTitle' or @class = 'IntroTitle']")
+          .each { |h| h.name = "p" }
+        dis_styles1(docxml)
+        docxml.xpath("//p[not(@class)]").each { |p| p["class"] = "MsoBodyText" }
+      end
+
+      def dis_styles1(docxml)
+        amd_style(docxml)
+        code_style(docxml)
+        figure_style(docxml)
+        note_style(docxml)
+        example_style(docxml)
+        quote_style(docxml)
+        dis_style_interactions(docxml)
+      end
+
+      def dis_style_interactions(docxml)
+        docxml.xpath("//p[@class = 'Code' or @class = 'Code-' or "\
+                     "@class = 'Code--']"\
+                     "[following::p[@class = 'Examplecontinued']]").each do |p|
+          p["style"] ||= ""
+          p["style"] = "margin-bottom:12pt;#{p['style']}"
+        end
+      end
+
+      def amd_style(docxml)
+        return unless @meta.get[:doctype] == "Amendment"
+
+        docxml.xpath("//div[@class = 'WordSection3']//h1").each do |h|
+          h.name = "p"
+          h["style"] = "font-style:italic;page-break-after:avoid;"
+        end
+      end
+
+      def quote_style(docxml)
+        docxml.xpath("//div[@class = 'Quote' or @class = 'Note' or "\
+                     "@class = 'Example' or @class = 'Admonition']").each do |d|
+                       quote_style1(d)
+                     end
+      end
+
+      def para_style_change(div, class1, class2)
+        s = class1 ? "@class = '#{class1}'" : "not(@class)"
+        div.xpath(".//p[#{s}]").each do |p|
+          p["class"] = class2
+        end
+      end
+
+      def quote_style1(div)
+        para_style_change(div, nil, "BodyTextindent1")
+        para_style_change(div, "Code-", "Code--")
+        para_style_change(div, "Code", "Code-")
+        if div["class"] != "Example"
+          para_style_change(div, "Example", "Exampleindent")
+          para_style_change(div, "Examplecontinued", "Exampleindentcontinued")
+        end
+        if div["class"] != "Note"
+          para_style_change(div, "Note", "Noteindent")
+          para_style_change(div, "Notecontinued", "Noteindentcontinued")
+        end
+        div.xpath(".//table[@class = 'dl']").each do |t|
+          t["style"] = "margin-left: 1cm;"
+        end
+      end
+
+      def remove_note_label(doc)
+        doc.xpath("//span[@class = 'note_label' or @class = 'example_label']")
+          .each do |s|
+          s.replace(s.children)
+        end
+      end
+
+      def note_style(docxml)
+        remove_note_label(docxml)
+        note_continued_style(docxml)
+      end
+
+      def example_style(docxml)
+        example_continued_style(docxml)
+      end
+
+      def example_continued_style(docxml)
+        docxml.xpath("//div[@class = 'Example']").each do |d|
+          d.xpath("./p").each_with_index do |p, i|
+            next if p["class"] && p["class"] != "Example"
+
+            p["class"] = (i.zero? ? "Example" : "Examplecontinued")
+          end
+        end
+      end
+
+      def note_continued_style(docxml)
+        docxml.xpath("//div[@class = 'Note']").each do |d|
+          d.xpath("./p").each_with_index do |p, i|
+            next if p["class"] && p["class"] != "Note"
+
+            p["class"] = (i.zero? ? "Note" : "Notecontinued")
+          end
+        end
+      end
+
+      FIGURE_NESTED_STYLES =
+        { Note: "Figurenote", example: "Figureexample" }.freeze
+
+      def figure_style(docxml)
+        docxml.xpath("//div[@class = 'figure']").each do |f|
+          FIGURE_NESTED_STYLES.each do |k, v|
+            f.xpath(".//*[@class = '#{k}']").each { |n| n["class"] = v }
+          end
+          f.xpath("./img").each do |i|
+            i.replace("<p class='FigureGraphic'>#{i.to_xml}</p>")
+          end
+        end
+      end
+
+      def code_style(doc)
+        span_style((doc.xpath("//tt//b") - doc.xpath("//tt//i//b")),
+                   "ISOCodebold")
+        span_style((doc.xpath("//tt//i") - doc.xpath("//tt//b//i")),
+                   "ISOCodeitalic")
+        span_style((doc.xpath("//b//tt") - doc.xpath("//b//i//tt")),
+                   "ISOCodebold")
+        span_style((doc.xpath("//i//tt") - doc.xpath("//i//b//tt")),
+                   "ISOCodeitalic")
+        span_style(doc.xpath("//tt"), "ISOCode")
+      end
+
+      def span_style(xpath, style)
+        xpath.each do |elem|
+          elem.name = "span"
+          elem["class"] = style
+        end
+      end
+
+      def word_annex_cleanup1(docxml, lvl)
+        docxml.xpath("//h#{lvl}[ancestor::*[@class = 'Section3']]").each do |h2|
+          h2.name = "p"
+          h2["class"] = "a#{lvl}"
+        end
+      end
+
+      def word_cleanup(docxml)
+        word_table_cell_para(docxml)
+        super
+        word_section_end_empty_para(docxml)
+        docxml
+      end
+
+      def authority_cleanup(docxml)
+        super
+        if @meta.get[:stage_int].to_s[0] == "9" ||
+            @meta.get[:stage_int].to_s[0] == "6"
+          copyright_prf(docxml)
+        else
+          copyright_dis(docxml)
+        end
+      end
+
+      def copyright_prf(docxml)
+        docxml.xpath("//p[@id = 'boilerplate-address']")&.each do |p|
+          p["class"] = "zzCopyright"
+          p["style"] = "text-indent:20.15pt;"
+          p.replace(p.to_xml.gsub(%r{<br/>}, "</p>\n<p class='zzCopyright' "\
+                                             "style='text-indent:20.15pt;'>"))
+        end
+        docxml.xpath("//p[@class = 'zzCopyrightHdr']")&.each do |p|
+          # p["class"] = "zzCopyright"
+          p.remove
+        end
+      end
+
+      def copyright_dis(docxml)
+        docxml.xpath("//p[@id = 'boilerplate-address']")&.each do |p|
+          p["class"] = "zzCopyright"
+          p.replace(p.to_xml.gsub(%r{<br/>}, "</p>\n<p class='zzCopyright'>"))
+        end
+        docxml.xpath("//p[@class = 'zzCopyrightHdr']")&.each do |p|
+          p.remove
+        end
+      end
+
+      def word_section_end_empty_para(docxml)
+        docxml.at("//div[@class='WordSection1']/p[last()]").remove
+      end
+
+      def word_table_cell_para(docxml)
+        docxml.xpath("//td | //th").each do |t|
+          s = t["header"] == "true" ? "Tableheader" : "Tablebody"
+          t.delete("header")
+          if t.at("./p |./div")
+            t.xpath("./p | ./div").each { |p| p["class"] = s }
+          else
+            t.children = "<div class='#{s}'>#{t.children.to_xml}</div>"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/isodoc/iso/word_dis_convert.rb

@@ -0,0 +1,122 @@
+require_relative "word_dis_cleanup"
+
+module IsoDoc
+  module Iso
+    class WordDISConvert < WordConvert
+      def default_file_locations(_options)
+        { wordstylesheet: html_doc_path("wordstyle-dis.scss"),
+          standardstylesheet: html_doc_path("isodoc-dis.scss"),
+          header: html_doc_path("header-dis.html"),
+          wordcoverpage: html_doc_path("word_iso_titlepage-dis.html"),
+          wordintropage: html_doc_path("word_iso_intro-dis.html"),
+          ulstyle: "l3",
+          olstyle: "l2" }
+      end
+
+      def initialize(options)
+        @libdir ||= File.dirname(__FILE__) # rubocop:disable Lint/DisjunctiveAssignmentInConstructor
+        options.merge!(default_file_locations(options))
+        super
+      end
+
+      def init_dis(options); end
+
+      def convert1(docxml, filename, dir)
+        update_coverpage(docxml)
+        super
+      end
+
+      def update_coverpage(docxml)
+        stage = docxml.at(ns("//bibdata/status/stage"))&.text
+        substage = docxml.at(ns("//bibdata/status/substage"))&.text
+        if /^9/.match?(stage) || (stage == "60" && substage == "60")
+          @wordcoverpage = html_doc_path("word_iso_titlepage.html")
+        elsif stage == "60" && substage == "00"
+          @wordcoverpage = html_doc_path("word_iso_titlepage-prf.html")
+        end
+      end
+
+      def figure_name_attrs(_node)
+        { class: "FigureTitle", style: "text-align:center;" }
+      end
+
+      def table_title_attrs(_node)
+        { class: "Tabletitle", style: "text-align:center;" }
+      end
+
+      def span_parse(node, out)
+        out.span **{ class: node["class"] } do |x|
+          node.children.each { |n| parse(n, x) }
+        end
+      end
+
+      def word_toc_preface(level)
+        <<~TOC.freeze
+          <span lang="EN-GB"><span
+          style='mso-element:field-begin'></span><span
+          style='mso-spacerun:yes'>&#xA0;</span>TOC \\o "2-#{level}" \\h \\z \\t
+          "Heading 1,1,ANNEX,1,Biblio Title,1,Foreword Title,1,Intro Title,1,ANNEXN,1,ANNEXZ,1,na2,1,na3,1,na4,1,na5,1,na6,1,Title,1,Base_Heading,1,Box-title,1,Front Head,1,Index Head,1,AMEND Terms Heading,1,AMEND Heading 1 Unnumbered,1"
+           <span style='mso-element:field-separator'></span></span>
+        TOC
+      end
+
+      def render_identifier(ident)
+        ret = super
+        ret[:sdo] = std_docid_semantic(ret[:sdo])
+        ret
+      end
+
+      def make_tr_attr(cell, row, totalrows, header)
+        super.merge(header: header)
+      end
+
+      def toWord(result, filename, dir, header)
+        result = from_xhtml(word_cleanup(to_xhtml(result)))
+          .gsub(/-DOUBLE_HYPHEN_ESCAPE-/, "--")
+        @wordstylesheet = wordstylesheet_update
+        ::Html2Doc::IsoDIS.new(
+          filename: filename,
+          imagedir: @localdir,
+          stylesheet: @wordstylesheet&.path,
+          header_file: header&.path, dir: dir,
+          asciimathdelims: [@openmathdelim, @closemathdelim],
+          liststyles: { ul: @ulstyle, ol: @olstyle }
+        ).process(result)
+        header&.unlink
+        @wordstylesheet.unlink if @wordstylesheet.is_a?(Tempfile)
+      end
+
+      def middle_title(_isoxml, out)
+        middle_title_dis(out)
+      end
+
+      def middle_title_dis(out)
+        out.p(**{ class: "zzSTDTitle" }) do |p|
+          p << @meta.get[:doctitleintro]
+          @meta.get[:doctitleintro] && @meta.get[:doctitlemain] and p << " &#x2014; "
+          p << @meta.get[:doctitlemain]
+          @meta.get[:doctitlemain] && @meta.get[:doctitlepart] and p << " &#x2014; "
+          if @meta.get[:doctitlepart]
+            b = @meta.get[:doctitlepartlabel] and
+              p << "<span style='font-weight:normal'>#{b}</span> "
+            p << " #{@meta.get[:doctitlepart]}"
+          end
+          @meta.get[:doctitleamdlabel] || @meta.get[:doctitleamd] ||
+            @meta.get[:doctitlecorrlabel] and middle_title_dis_amd(p)
+        end
+      end
+
+      def middle_title_dis_amd(para)
+        para.span(**{ style: "font-weight:normal" }) do |p|
+          if a = @meta.get[:doctitleamdlabel]
+            p << " #{a}"
+            a = @meta.get[:doctitleamd] and p << ": #{a}"
+          end
+          if a = @meta.get[:doctitlecorrlabel]
+            p << " #{a}"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/isodoc/iso/xref.rb

@@ -10,36 +10,48 @@ module IsoDoc
         else
           initial_anchor_names1(doc)
         end
-        introduction_names(doc.at(ns("//introduction")))
+        if @parse_settings.empty? || @parse_settings[:clauses]
+          introduction_names(doc.at(ns("//introduction")))
+        end
       end
 
       def initial_anchor_names_amd(doc)
-        doc.xpath(ns("//preface/*")).each do |c|
-          c.element? and preface_names(c)
+        if @parse_settings.empty? || @parse_settings[:clauses]
+          doc.xpath(ns("//preface/*")).each do |c|
+            c.element? and preface_names(c)
+          end
+          doc.xpath(ns("//sections/clause")).each do |c|
+            c.element? and preface_names(c)
+          end
         end
-        sequential_asset_names(doc.xpath(ns("//preface/*")))
-        doc.xpath(ns("//sections/clause")).each do |c|
-          c.element? and preface_names(c)
+        if @parse_settings.empty?
+          sequential_asset_names(doc.xpath(ns("//preface/*")))
+          middle_section_asset_names(doc)
+          termnote_anchor_names(doc)
+          termexample_anchor_names(doc)
         end
-        middle_section_asset_names(doc)
-        termnote_anchor_names(doc)
-        termexample_anchor_names(doc)
       end
 
       def initial_anchor_names1(doc)
-        doc.xpath(ns("//preface/*")).each { |c| c.element? and preface_names(c) }
-        # potentially overridden in middle_section_asset_names()
-        sequential_asset_names(doc.xpath(ns("//preface/*")))
-        n = Counter.new
-        n = section_names(doc.at(ns("//clause[@type = 'scope']")), n, 1)
-        n = section_names(doc.at(ns(@klass.norm_ref_xpath)), n, 1)
-        doc.xpath(ns("//sections/clause[not(@type = 'scope')] | "\
-                     "//sections/terms | //sections/definitions")).each do |c|
-          n = section_names(c, n, 1)
+        if @parse_settings.empty? || @parse_settings[:clauses]
+          doc.xpath(ns("//preface/*")).each do |c|
+            c.element? and preface_names(c)
+          end
+          # potentially overridden in middle_section_asset_names()
+          sequential_asset_names(doc.xpath(ns("//preface/*")))
+          n = Counter.new
+          n = section_names(doc.at(ns("//clause[@type = 'scope']")), n, 1)
+          n = section_names(doc.at(ns(@klass.norm_ref_xpath)), n, 1)
+          doc.xpath(ns("//sections/clause[not(@type = 'scope')] | "\
+                       "//sections/terms | //sections/definitions")).each do |c|
+            n = section_names(c, n, 1)
+          end
+        end
+        if @parse_settings.empty?
+          middle_section_asset_names(doc)
+          termnote_anchor_names(doc)
+          termexample_anchor_names(doc)
         end
-        middle_section_asset_names(doc)
-        termnote_anchor_names(doc)
-        termexample_anchor_names(doc)
       end
 
       # we can reference 0-number clauses in introduction
@@ -65,10 +77,10 @@ module IsoDoc
         i = Counter.new
         clause.xpath(ns("./appendix")).each do |c|
           i.increment(c)
-          @anchors[c["id"]] = anchor_struct(i.print, nil, @labels["appendix"],
-                                            "clause")
-          @anchors[c["id"]][:level] = 2
-          @anchors[c["id"]][:container] = clause["id"]
+          @anchors[c["id"]] =
+            anchor_struct(i.print, nil, @labels["appendix"],
+                          "clause").merge(level: 2, subtype: "annex",
+                                          container: clause["id"])
           j = Counter.new
           c.xpath(ns("./clause | ./references")).each do |c1|
             j.increment(c1)
@@ -78,10 +90,11 @@ module IsoDoc
         end
       end
 
+      # subclauses are not prefixed with "Clause"
+      # retaining subtype for the semantics
       def section_names1(clause, num, level)
         @anchors[clause["id"]] =
-          { label: num, level: level, xref: num }
-        # subclauses are not prefixed with "Clause"
+          { label: num, level: level, xref: num, subtype: "clause" }
         i = Counter.new
         clause.xpath(ns("./clause | ./terms | ./term | ./definitions | "\
                         "./references"))
@@ -92,7 +105,8 @@ module IsoDoc
       end
 
       def annex_names1(clause, num, level)
-        @anchors[clause["id"]] = { label: num, xref: num, level: level }
+        @anchors[clause["id"]] = { label: num, xref: num, level: level,
+                                   subtype: "annex" }
         i = Counter.new
         clause.xpath(ns("./clause | ./references")).each do |c|
           i.increment(c)
@@ -166,7 +180,42 @@ module IsoDoc
 
       def back_anchor_names(docxml)
         super
-        docxml.xpath(ns("//indexsect")).each { |b| preface_names(b) }
+        if @parse_settings.empty? || @parse_settings[:clauses]
+          docxml.xpath(ns("//indexsect")).each { |b| preface_names(b) }
+        end
+      end
+
+      def annex_name_lbl(clause, num)
+        super.sub(%r{<br/>(.*)$}, "<br/><span class='obligation'>\\1</span>")
+      end
+
+      def list_anchor_names(sections)
+        sections.each do |s|
+          notes = s.xpath(ns(".//ol")) - s.xpath(ns(".//clause//ol")) -
+            s.xpath(ns(".//appendix//ol")) - s.xpath(ns(".//ol//ol"))
+          c = Counter.new
+          notes.reject { |n| blank?(n["id"]) }.each do |n|
+            @anchors[n["id"]] = anchor_struct(increment_label(notes, n, c), n,
+                                              @labels["list"], "list", false)
+            list_item_anchor_names(n, @anchors[n["id"]], 1, "",
+                                   !single_ol_for_xrefs?(notes))
+          end
+          list_anchor_names(s.xpath(ns(CHILD_SECTIONS)))
+        end
+      end
+
+      # all li in the ol in lists are consecutively numbered through @start
+      def single_ol_for_xrefs?(lists)
+        return true if lists.size == 1
+
+        start = 0
+        lists.each_with_index do |l, i|
+          next if i.zero?
+
+          start += lists[i - 1].xpath(ns("./li")).size
+          return false unless l["start"]&.to_i == start + 1
+        end
+        true
       end
     end
   end