metanorma-iso 1.4.2 → 1.5.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d1cf4345d777fb37031e719c6121a5f27fd23dc56ebacab1a099aa2c108a82d2
-  data.tar.gz: d571ce7dcd5a38ebc7e19460b7ab65e2f77499ab46a836d74857d7f6eb78f88d
+  metadata.gz: 7dc868b1792a227210079cc57a26f3d6a149738feb8cc1003a081f2db6a8c035
+  data.tar.gz: 4ce69ed98d486e5618ad68bbac05b6b8589d8ac7b1b76bff90c4bed08b242315
 SHA512:
-  metadata.gz: 8ed62ccec92b596bb8063267750c04e1df0ffc6376d2339b5771b1780400c526041793d37a1cb115117dafb35e45d1f680244d1ce1bd975a010703ec9bbaff25
-  data.tar.gz: 97a5255d0a7ee3992dde8b88b005aa3aab743ed03f2b0983cb7c02bea1b010c988f28ad1f1bbf9086356ff32f2a6eb8fed164b65b20887a83fa58da2e49500d9
+  metadata.gz: 8a759e049bbc37f0b3027a7ff7ed012e123645c28099e9b4c9af86cc3da964e7b121f69c4ae0d4b0d9d9a804009bb93c368716ad115ff45a761fa0d3cec89245
+  data.tar.gz: cc1c85767b13826f10d1289621379892722166aa38008009577be1c6703b3ad194870db780f050457e73e0f76b301186d64469c935007c56539c23f78651bc17

data/.github/workflows/ubuntu.yml

@@ -39,7 +39,7 @@ jobs:
           polling_interval_seconds: 5
           timeout_minutes: 5
           max_attempts: 3
-          command: sudo bash -c "curl -L https://github.com/metanorma/plantuml-install/raw/master/ubuntu.sh | bash"
+          command: sudo apt-get update -y && sudo bash -c "curl -L https://github.com/metanorma/plantuml-install/raw/master/ubuntu.sh | bash"
       - name: Run specs
         run: |
           bundle exec rake

data/lib/asciidoctor/iso/base.rb

@@ -3,7 +3,6 @@ require "nokogiri"
 require "json"
 require "pathname"
 require "open-uri"
-require "pp"
 require "isodoc"
 require "fileutils"
 require 'asciidoctor/iso/macros'
@@ -53,26 +52,16 @@ module Asciidoctor
       def outputs(node, ret)
           File.open(@filename + ".xml", "w:UTF-8") { |f| f.write(ret) }
           presentation_xml_converter(node).convert(@filename + ".xml")
-          html_converter_alt(node).convert(@filename + ".presentation.xml", nil, false, "#{@filename}_alt.html")
-          html_converter(node).convert(@filename + ".presentation.xml", nil, false, "#{@filename}.html")
-          doc_converter(node).convert(@filename + ".presentation.xml", nil, false, "#{@filename}.doc")
-          pdf_converter(node)&.convert(@filename + ".presentation.xml", nil, false, "#{@filename}.pdf")
+          html_converter_alt(node).convert(@filename + ".presentation.xml", 
+                                           nil, false, "#{@filename}_alt.html")
+          html_converter(node).convert(@filename + ".presentation.xml", 
+                                       nil, false, "#{@filename}.html")
+          doc_converter(node).convert(@filename + ".presentation.xml", 
+                                      nil, false, "#{@filename}.doc")
+          pdf_converter(node)&.convert(@filename + ".presentation.xml", 
+                                       nil, false, "#{@filename}.pdf")
           #sts_converter(node)&.convert(@filename + ".xml")
       end
-
-      def load_yaml(lang, script)
-        y = if @i18nyaml then YAML.load_file(@i18nyaml)
-            elsif lang == "en"
-              YAML.load_file(File.join(File.dirname(__FILE__), "i18n-en.yaml"))
-            elsif lang == "fr"
-              YAML.load_file(File.join(File.dirname(__FILE__), "i18n-fr.yaml"))
-            elsif lang == "zh" && script == "Hans"
-              YAML.load_file(File.join(File.dirname(__FILE__), "i18n-zh-Hans.yaml"))
-            else
-              YAML.load_file(File.join(File.dirname(__FILE__), "i18n-en.yaml"))
-            end
-        super.merge(y)
-      end
     end
   end
 end

data/lib/asciidoctor/iso/cleanup.rb

@@ -4,20 +4,19 @@ require "htmlentities"
 require "json"
 require "pathname"
 require "open-uri"
-require "pp"
 require "asciidoctor/iso/term_lookup_cleanup"
 
 module Asciidoctor
   module ISO
     class Converter < Standoc::Converter
       PRE_NORMREF_FOOTNOTES = "//preface//fn | "\
-        "//clause[title = 'Scope']//fn".freeze
+        "//clause[@type = 'scope']//fn".freeze
 
       NORMREF_FOOTNOTES =
         "//references[@normative = 'true']//fn".freeze
 
       POST_NORMREF_FOOTNOTES =
-        "//sections//clause[not(title = 'Scope')]//fn | "\
+        "//sections//clause[not(@type = 'scope')]//fn | "\
         "//annex//fn | "\
         "//references[@normative = 'false']//fn".freeze
 

data/lib/asciidoctor/iso/front.rb

@@ -4,7 +4,6 @@ require "htmlentities"
 require "json"
 require "pathname"
 require "open-uri"
-require "pp"
 require_relative "front_id"
 
 module Asciidoctor
@@ -35,7 +34,7 @@ module Asciidoctor
 
       def metadata_author(node, xml)
         publishers = node.attr("publisher") || "ISO"
-        publishers.split(/,[ ]?/).each do |p|
+        csv_split(publishers).each do |p|
           xml.contributor do |c|
             c.role **{ type: "author" }
             c.organization { |a| organization(a, p) }
@@ -45,7 +44,7 @@ module Asciidoctor
 
       def metadata_publisher(node, xml)
         publishers = node.attr("publisher") || "ISO"
-        publishers.split(/,[ ]?/).each do |p|
+        csv_split(publishers).each do |p|
           xml.contributor do |c|
             c.role **{ type: "publisher" }
             c.organization { |a| organization(a, p) }
@@ -54,8 +53,8 @@ module Asciidoctor
       end
 
       def metadata_copyright(node, xml)
-        publishers = node.attr("publisher") || "ISO"
-        publishers.split(/,[ ]?/).each do |p|
+        publishers = node.attr("copyright-holder") || node.attr("publisher") || "ISO"
+        csv_split(publishers).each do |p|
           xml.copyright do |c|
             c.from (node.attr("copyright-year") || Date.today.year)
             c.owner do |owner|

data/lib/asciidoctor/iso/front_id.rb

@@ -133,7 +133,7 @@ module Asciidoctor
       end
 
       def id_stage_abbr(stage, substage, node)
-        ret = IsoDoc::Iso::Metadata.new("en", "Latn", {}).
+        ret = IsoDoc::Iso::Metadata.new("en", "Latn", @i18n).
           status_abbrev(stage_abbr(stage, substage, node.attr("doctype")),
                         substage, node.attr("iteration"),
                         node.attr("draft"), node.attr("doctype"))

data/lib/asciidoctor/iso/isodoc.rng

@@ -922,6 +922,9 @@
       <optional>
         <attribute name="script"/>
       </optional>
+      <optional>
+        <attribute name="type"/>
+      </optional>
       <optional>
         <attribute name="obligation">
           <choice>
@@ -961,9 +964,6 @@
   </define>
   <define name="content-subsection">
     <element name="clause">
-      <optional>
-        <attribute name="type"/>
-      </optional>
       <ref name="Content-Section"/>
     </element>
   </define>
@@ -992,6 +992,9 @@
         </choice>
       </attribute>
     </optional>
+    <optional>
+      <attribute name="type"/>
+    </optional>
     <optional>
       <ref name="section-title"/>
     </optional>
@@ -1011,9 +1014,6 @@
   </define>
   <define name="clause">
     <element name="clause">
-      <optional>
-        <attribute name="type"/>
-      </optional>
       <ref name="Clause-Section"/>
     </element>
   </define>
@@ -1042,6 +1042,9 @@
         </choice>
       </attribute>
     </optional>
+    <optional>
+      <attribute name="type"/>
+    </optional>
     <optional>
       <ref name="section-title"/>
     </optional>
@@ -1180,6 +1183,9 @@
       <optional>
         <attribute name="script"/>
       </optional>
+      <optional>
+        <attribute name="type"/>
+      </optional>
       <optional>
         <attribute name="obligation">
           <choice>

data/lib/asciidoctor/iso/section.rb

@@ -5,13 +5,15 @@ module Asciidoctor
   module ISO
     class Converter < Standoc::Converter
       def clause_parse(attrs, xml, node)
-        title = node&.attr("heading")&.downcase ||
-          node.title.gsub(/<[^>]+>/, "").downcase
-        title == "scope" and return scope_parse(attrs, xml, node)
         node.option? "appendix" and return appendix_parse(attrs, xml, node)
         super
       end
 
+      def scope_parse(attrs, xml, node)
+        attrs = attrs.merge(type: "scope") unless @amd 
+        clause_parse(attrs, xml, node)
+      end
+
       def appendix_parse(attrs, xml, node)
         attrs["inline-header".to_sym] = node.option? "inline-header"
         set_obligation(attrs, node)
@@ -28,14 +30,6 @@ module Asciidoctor
         xml << node.content
       end
 
-      def scope_parse(attrs, xml, node)
-        xml.clause **attr_code(attrs) do |xml_section|
-          xml_section.title { |t| t << "Scope" }
-          content = node.content
-          xml_section << content
-        end
-      end
-
       def section_attributes(node)
         super.merge(
           change: @amd ? node.attr("change") : nil,

data/lib/asciidoctor/iso/term_lookup_cleanup.rb

@@ -75,7 +75,6 @@ module Asciidoctor
 
       def unique_text_id(text)
         return "term-#{text}" if xmldoc.at("//*[@id = 'term-#{text}']").nil?
-
         (1..Float::INFINITY).lazy.each do |index|
           if xmldoc.at("//*[@id = 'term-#{text}-#{index}']").nil?
             break("term-#{text}-#{index}")

data/lib/asciidoctor/iso/validate_section.rb

@@ -7,6 +7,7 @@ module Asciidoctor
         foreword_validate(doc.root)
         normref_validate(doc.root)
         symbols_validate(doc.root)
+        sections_presence_validate(doc.root)
         sections_sequence_validate(doc.root)
         section_style(doc.root)
         subclause_validate(doc.root)
@@ -46,46 +47,44 @@ module Asciidoctor
       end
 
       def seqcheck(names, msg, accepted)
-        n = names.shift
-        unless accepted.include? n
+        n = names.shift 
+        return [] if n.nil?
+        test = accepted.map { |a| n.at(a) }
+        if test.all? { |a| a.nil? }
           @log.add("Style", nil, msg)
-          names = []
         end
         names
       end
 
+      def sections_presence_validate(root)
+        root.at("//sections/clause[@type = 'scope']") or
+          @log.add("Style", nil, "Scope clause missing")
+        root.at("//references[@normative = 'true']") or
+          @log.add("Style", nil, "Normative references missing")
+        root.at("//terms") or
+          @log.add("Style", nil, "Terms & definitions missing")
+      end
+
       # spec of permissible section sequence
       # we skip normative references, it goes to end of list
       SEQ =
         [
           {
             msg: "Initial section must be (content) Foreword",
-            val:  [{ tag: "foreword", title: "Foreword" }],
+            val:  ["./self::foreword"]
           },
           {
             msg: "Prefatory material must be followed by (clause) Scope",
-            val:  [{ tag: "introduction", title: "Introduction" },
-                   { tag: "clause", title: "Scope" }],
+            val: ["./self::introduction", "./self::clause[@type = 'scope']" ]
           },
           {
             msg: "Prefatory material must be followed by (clause) Scope",
-            val: [{ tag: "clause", title: "Scope" }],
+            val: ["./self::clause[@type = 'scope']" ]
           },
           {
             msg: "Normative References must be followed by "\
             "Terms and Definitions",
-            val: [
-              { tag: "terms", title: "Terms and definitions" },
-              { tag: "clause", title: "Terms and definitions" },
-              {
-                tag: "terms",
-                title: "Terms, definitions, symbols and abbreviated terms",
-              },
-              {
-                tag: "clause",
-                title: "Terms, definitions, symbols and abbreviated terms",
-              },
-            ],
+            val: ["./self::terms | .//terms"]
           },
       ].freeze
 
@@ -95,50 +94,47 @@ module Asciidoctor
         "//clause[descendant::references][not(parent::clause)]".freeze
 
       def sections_sequence_validate(root)
-        f = root.xpath(SECTIONS_XPATH)
-        names = f.map { |s| { tag: s.name, title: s&.at("./title")&.text } }
-        names = seqcheck(names, SEQ[0][:msg], SEQ[0][:val]) || return
+        names = root.xpath(SECTIONS_XPATH)
+        names = seqcheck(names, SEQ[0][:msg], SEQ[0][:val]) 
         n = names[0]
-        names = seqcheck(names, SEQ[1][:msg], SEQ[1][:val]) || return
-        if n == { tag: "introduction", title: "Introduction" }
-          names = seqcheck(names, SEQ[2][:msg], SEQ[2][:val]) || return
+        names = seqcheck(names, SEQ[1][:msg], SEQ[1][:val]) 
+        if n&.at("./self::introduction")
+          names = seqcheck(names, SEQ[2][:msg], SEQ[2][:val]) 
         end
-        names = seqcheck(names, SEQ[3][:msg], SEQ[3][:val]) || return
+        names = seqcheck(names, SEQ[3][:msg], SEQ[3][:val]) 
         n = names.shift
-        if n == { tag: "definitions", title: nil }
-          n = names.shift || return
+        if n&.at("./self::definitions")
+          n = names.shift
         end
-        unless n
+        if n.nil? || n.name != "clause"
           @log.add("Style", nil, "Document must contain at least one clause")
-          return
         end
-        n[:tag] == "clause" ||
+        n&.at("./self::clause") ||
           @log.add("Style", nil, "Document must contain clause after "\
                "Terms and Definitions")
-        n == { tag: "clause", title: "Scope" } &&
+        n&.at("./self::clause[@type = 'scope']") &&
           @log.add("Style", nil, "Scope must occur before Terms and Definitions")
-        n = names.shift || return
-        while n[:tag] == "clause"
-          n[:title] == "Scope" &&
+        n = names.shift 
+        while n&.name == "clause"
+          n&.at("./self::clause[@type = 'scope']")
             @log.add("Style", nil, "Scope must occur before Terms and Definitions")
-          n = names.shift || return
+          n = names.shift 
         end
-        unless n[:tag] == "annex" || n[:tag] == "references"
+        unless %w(annex references).include? n&.name
           @log.add("Style", nil, "Only annexes and references can follow clauses")
         end
-        while n[:tag] == "annex"
+        while n&.name == "annex"
           n = names.shift
           if n.nil?
             @log.add("Style", nil, "Document must include (references) "\
                  "Normative References")
-            return
           end
         end
-        n == { tag: "references", title: "Normative References" } ||
+        n&.at("./self::references[@normative = 'true']") ||
           @log.add("Style", nil, "Document must include (references) "\
                "Normative References")
-        n = names.shift
-        n == { tag: "references", title: "Bibliography" } ||
+        n = names&.shift
+        n&.at("./self::references[@normative = 'false']") ||
           @log.add("Style", nil, "Final section must be (references) Bibliography")
         names.empty? ||
           @log.add("Style", nil, "There are sections after the final Bibliography")
@@ -157,8 +153,8 @@ module Asciidoctor
       def section_style(root)
         foreword_style(root.at("//foreword"))
         introduction_style(root.at("//introduction"))
-        scope_style(root.at("//clause[title = 'Scope']"))
-        scope = root.at("//clause[title = 'Scope']/clause")
+        scope_style(root.at("//clause[@type = 'scope']"))
+        scope = root.at("//clause[@type = 'scope']/clause")
         # ISO/IEC DIR 2, 14.4
         scope.nil? || style_warning(scope, SCOPE_WARN, nil)
       end

data/lib/isodoc/iso/base_convert.rb

@@ -1,25 +1,10 @@
 require "isodoc"
-require_relative "metadata"
 require_relative "sections"
-require_relative "xref"
 require "fileutils"
 
 module IsoDoc
   module Iso
     module BaseConvert
-      def metadata_init(lang, script, labels)
-        @meta = Metadata.new(lang, script, labels)
-      end
-
-      def xref_init(lang, script, klass, labels, options)
-        @xrefs = Xref.new(lang, script, klass, labels, options)
-      end
-
-      def amd(docxml)
-        doctype = docxml&.at(ns("//bibdata/ext/doctype"))&.text
-        %w(amendment technical-corrigendum).include? doctype
-      end
-
       def convert1(docxml, filename, dir)
         if amd(docxml)
           @oldsuppressheadingnumbers = @suppressheadingnumbers
@@ -41,46 +26,10 @@ module IsoDoc
         end
       end
 
-      def eref_localities1_zh(target, type, from, to, delim)
-        subsection = from&.text&.match(/\./)
-        ret = (delim == ";") ? ";" : (type == "list") ? "" : delim
-        ret += " 第#{from.text}" if from
-        ret += "–#{to}" if to
-        loc = (@locality[type] || type.sub(/^locality:/, "").capitalize )
-        ret += " #{loc}" unless subsection && type == "clause" ||
-          type == "list" || target.match(/^IEV$|^IEC 60050-/)
-        ret += ")" if type == "list"
-        ret
-      end
-
-      def eref_localities1(target, type, from, to, delim, lang = "en")
-        return "" if type == "anchor"
-        subsection = from&.text&.match(/\./)
-        type = type.downcase
-        return l10n(eref_localities1_zh(target, type, from, to, delim)) if lang == "zh"
-        ret = (delim == ";") ? ";" : (type == "list") ? "" : delim
-        loc = @locality[type] || type.sub(/^locality:/, "").capitalize
-        ret += " #{loc}" unless subsection && type == "clause" ||
-          type == "list" || target.match(/^IEV$|^IEC 60050-/)
-        ret += " #{from.text}" if from
-        ret += "–#{to.text}" if to
-        ret += ")" if type == "list"
-        l10n(ret)
-      end
-
-      def prefix_container(container, linkend, target)
-        delim = @xrefs.anchor(target, :type) == "listitem" ? " " : ", "
-        l10n(@xrefs.anchor(container, :xref) + delim + linkend)
-      end
-
       def example_span_label(node, div, name)
-        n = @xrefs.get[node["id"]]
+        return if name.nil?
         div.span **{ class: "example_label" } do |p|
-          lbl = (n.nil? || n[:label].nil? || n[:label].empty?) ? @example_lbl :
-            l10n("#{@example_lbl} #{n[:label]}")
-          p << lbl
-          name and !lbl.nil? and p << "&nbsp;&mdash; "
-          name and name.children.each { |n| parse(n, div) }
+          name.children.each { |n| parse(n, div) }
         end
       end
 
@@ -142,10 +91,6 @@ module IsoDoc
         super
       end
 
-      def clausedelim
-        ""
-      end
-
       def cleanup(docxml)
         super
         table_th_center(docxml)
@@ -165,7 +110,7 @@ module IsoDoc
                              dl&.at(ns("./dd"))&.elements&.size == 1 &&
                              dl&.at(ns("./dd/p")))
         out.span **{ class: "zzMoveToFollowing" } do |s|
-          s << "#{@where_lbl} "
+          s << "#{@i18n.where} "
           dl.at(ns("./dt")).children.each { |n| parse(n, s) }
           s << " "
         end
@@ -202,13 +147,7 @@ module IsoDoc
       end
 
       def figure_name_parse(node, div, name)
-        lbl = @xrefs.anchor(node['id'], :label, false)
-        lbl = nil if labelled_ancestor(node) && node.ancestors("figure").empty?
-        return if lbl.nil? && name.nil?
         div.p **{ class: "FigureTitle", style: "text-align:center;" } do |p|
-          figname = node.parent.name == "figure" ? "" : "#{@figure_lbl} "
-          lbl.nil? or p << l10n("#{figname}#{lbl}")
-          name and !lbl.nil? and p << "&nbsp;&mdash; "
           name and name.children.each { |n| parse(n, div) }
         end
       end