metanorma-standoc 3.1.9 → 3.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: de01a94e3cb7bcfb9a89059997ab380a4ad0e4bc1b978e9564b1c6e868e1b4d2
-  data.tar.gz: 92d49d407c518a7296398da6c24ad78d8d05a97216a6019469574325762a2acc
+  metadata.gz: b31a7d2190d00f77453583314cf1fd4169b2a7d54c8a9c875c1aee18c0036c83
+  data.tar.gz: 7d827880dc836092ed06347a2b008597645416dbd50ecee20000e06f3b245b53
 SHA512:
-  metadata.gz: bc5941a5e7f2a3736b23ec67b9a54418570e0cbabaec1ee178c4685497db541c3db15788bff3ac0a3a49a068e367d71144bb8b2dbcff7fea82b7c26bb945fd76
-  data.tar.gz: 9ddd293a80d0947882a033cec025e2d7cf26de022bb86791c80f8eb4f51df994aebdf72be5c492f711dbc4a52b196ab156e70cc5854d7b78b8d78f5039d9b7b7
+  metadata.gz: 667dae14d6d8fa22c20d531cfbadf6a5df8678b6180edcadc021dad25b1b63fdffe71d89d24ba5ed3af90f82f3661b12fcd943b31e611f76e211458c95db4235
+  data.tar.gz: b4eb5852322aab31ba5afe54508c9f3fdcdb6664718667124de3e2031902b2d27511f8459ad64b43267f13f9cb74efb9d3284acec2566a930a4acff5819443bd

data/lib/metanorma/standoc/base.rb

@@ -22,7 +22,7 @@ module Metanorma
   module Standoc
     module Base
       include IsolatedConverter
-      
+
       # XML_ROOT_TAG = "standard-document".freeze
       # XML_NAMESPACE = "https://www.metanorma.org/ns/standoc".freeze
       FONTS_MANIFEST = "fonts-manifest".freeze
@@ -44,7 +44,7 @@ module Metanorma
         clean_exit
         ret
       rescue StandardError => e
-        @log.add("Fatal Error", nil, e.message, severity: 0)
+        @log.add("STANDOC_50", nil, params: [e.message])
         clean_exit
         raise e
       end

data/lib/metanorma/standoc/blocks.rb

@@ -244,9 +244,8 @@ module Metanorma
       # as it may be fragment, e.g. unterminated start of element markup
       def passthrough_validate(node, content, encoded_content)
         valid, = validate_document_fragment(content.dup)
-        err = "Invalid passthrough content: #{encoded_content}\n#{PASSTHRU_ERR}"
         !valid and
-          @log.add("Metanorma XML Syntax", node, err, severity: 0)
+          @log.add("STANDOC_42", node, params: [encoded_content])
       end
     end
   end

data/lib/metanorma/standoc/cleanup.rb

@@ -83,7 +83,7 @@ module Metanorma
         ext_contributor_cleanup(xmldoc) # feeds: bibdata_cleanup
         ext_dochistory_cleanup(xmldoc) # feeds: bibdata_cleanup
         bibdata_cleanup(xmldoc) # feeds: boilerplate_cleanup
-        boilerplate_cleanup(xmldoc) # feeds: xref_cleanup for new <<>> 
+        boilerplate_cleanup(xmldoc) # feeds: xref_cleanup for new <<>>
         # introduced, pres_metadata_cleanup
         pres_metadata_cleanup(xmldoc)
         xref_cleanup(xmldoc)
@@ -106,21 +106,21 @@ module Metanorma
       def relaton_iev_cleanup(xmldoc)
         _, err = RelatonIev::iev_cleanup(xmldoc, @bibdb)
         err.each do |e|
-          @log.add("Bibliography", nil, e, severity: 0)
+          @log.add("RELATON_5", nil, params: e)
         end
       end
 
       RELATON_SEVERITIES =
-        { "INFO": 3, "WARN": 2, "ERROR": 1, "FATAL": 0,
-          "UNKNOWN": 3 }.freeze
+        { "INFO": "RELATON_4", "WARN":  "RELATON_3", "ERROR":  "RELATON_2",
+          "FATAL": "RELATON_1", "UNKNOWN":  "RELATON_4" }.freeze
 
       def relaton_log_cleanup(_xmldoc)
         @relaton_log or return
         @relaton_log.rewind
         @relaton_log.string.split(/(?<=})\n(?={)/).each do |l|
           e = JSON.parse(l)
-          @log.add("Relaton", e["key"], e["message"],
-                   severity: RELATON_SEVERITIES[e["severity"].to_sym])
+          @log.add(RELATON_SEVERITIES[e["severity"].to_sym], e["key"],
+                   params: [e["message"]])
         end
       end
 

data/lib/metanorma/standoc/cleanup_asciibib.rb

@@ -26,9 +26,7 @@ module Metanorma
         id = bib["id"]
         id ||= clause["anchor"] unless /^_/.match?(clause["anchor"])
         unless id
-          @log.add("Anchors", clause,
-                   "The following reference is missing an anchor:\n" \
-                   "#{clause.to_xml}", severity: 1)
+          @log.add("STANDOC_10", clause, params: [clause.to_xml])
           return
         end
         @refids << id
@@ -36,13 +34,12 @@ module Metanorma
       end
 
       def validate_ref_dl1(bib, id, clause)
-        bib["title"] or
-          @log.add("Bibliography", clause, "Reference #{id} is missing a title",
-                   severity: 1)
-        bib["docid"] or
-          @log.add("Bibliography", clause,
-                   "Reference #{id} is missing a document identifier (docid)",
-                   severity: 1)
+        if !bib["title"]
+          @log.add("STANDOC_11", clause, params: [id])
+        end
+        if !bib["docid"]
+          @log.add("STANDOC_12", clause, params: [id])
+        end
       end
 
       def extract_from_p(tag, bib, key)

data/lib/metanorma/standoc/cleanup_attachment.rb

@@ -53,8 +53,7 @@ module Metanorma
       def valid_attachment?(path, bib)
         File.exist?(path) and return true
         p = Pathname.new(path).cleanpath
-        @log.add("Bibliography", bib, "Attachment #{p} does not exist",
-                 severity: 0)
+        @log.add("STANDOC_9", bib, params: [p])
         false
       end
 

data/lib/metanorma/standoc/cleanup_bibitem.rb

@@ -16,13 +16,14 @@ module Metanorma
       def new_bibitem_from_formattedref_spans(bib)
         ret = SpansToBibitem.new(bib).convert
         ret.err.each do |e|
-          @log.add("Bibliography", bib, e[:msg], severity: e[:fatal] ? 0 : 1)
+          @log.add(e[:fatal] ? "STANDOC_52" : "STANDOC_53",
+                   bib, params: [e[:msg]])
         end
         ret.out
       end
 
       def merge_bibitem_from_formattedref_spans(bib, new)
-        new["type"] and bib["type"] = new["type"]
+        merge_bibitem_from_formattedref_span_attrs(bib, new)
         if bib.at("./title") && bib["amend"]
           # there already is a fetched record here: merge
           bib.children = MergeBibitems
@@ -33,6 +34,12 @@ module Metanorma
         end
       end
 
+      def merge_bibitem_from_formattedref_span_attrs(bib, new)
+        %w(type).each do |k|
+          new[k] and bib[k] = new[k]
+        end
+      end
+
       def fold_notes_into_biblio(refs)
         refs.xpath("./bibitem").each do |r|
           while r&.next_element&.name == "note"
@@ -194,6 +201,25 @@ module Metanorma
         bibitem.parent["normative"] == "true"
       end
 
+      def bibitem_i18n(xmldoc)
+        xmldoc.xpath("//references/bibitem").each do |b|
+          s = b.at("./script")
+          l = b.at("./language")
+          s && l and next
+          ins = bibitem_i18n_insert(b)
+          s or ins.next = "<script>#{@script}</script>"
+          l or ins.next = "<language>#{@lang}</language>"
+        end
+      end
+
+      def bibitem_i18n_insert(bib)
+        bib.at("./note[last()]") || bib.at("./version[last()]") ||
+          bib.at("./edition[last()]") || bib.at("./contributor[last()]") ||
+          bib.at("./date[last()]") || bib.at("./docnumber[last()]") ||
+          bib.at("./docidentifier[last()]") || bib.at("./source[last()]") ||
+          bib.at("./title[last()]") || bib.children.first
+      end
+
       def bibitem_cleanup(xmldoc)
         bibitem_nested_id(xmldoc) # feeds remove_dup_bibtem_id
         ref_dl_cleanup(xmldoc)
@@ -202,6 +228,7 @@ module Metanorma
         remove_empty_docid(xmldoc)
         empty_docid_to_title(xmldoc)
         remove_dup_bibtem_id(xmldoc)
+        bibitem_i18n(xmldoc)
         attachment_cleanup(xmldoc)
       end
     end

data/lib/metanorma/standoc/cleanup_block.rb

@@ -233,8 +233,7 @@ module Metanorma
       def ol_cleanup(doc)
         doc.xpath("//ol[@explicit-type]").each do |x|
           x.delete("explicit-type")
-          @log.add("Style", x,
-                   "Style override set for ordered list", display: false)
+          @log.add("STANDOC_14", x, display: false)
         end
       end
 

data/lib/metanorma/standoc/cleanup_boilerplate.rb

@@ -116,8 +116,7 @@ module Metanorma
         filename.nil? || filename.empty? and return
         filename = filename.strip
         unless File.exist?(filename)
-          msg = "Specified boilerplate file does not exist: #{filename}"
-          @log.add("Include", nil, msg, severity: 0)
+          @log.add("STANDOC_1", nil, params: [filename])
           return
         end
 

data/lib/metanorma/standoc/cleanup_footnotes.rb

@@ -112,8 +112,7 @@ module Metanorma
       end
 
       def footnote_block_error(fnote)
-        @log.add("Crossreferences", fnote,
-                 "Could not resolve footnoteblock:[#{fnote.text}]", severity: 1)
+        @log.add("STANDOC_15", fnote, params: [fnote.text])
         fnote.children = "[ERROR]"
       end
 

data/lib/metanorma/standoc/cleanup_inline.rb

@@ -174,8 +174,7 @@ module Metanorma
         xmldoc.xpath("//link[@target]").each do |l|
           l["target"] = Addressable::URI.parse(l["target"]).to_s
         rescue Addressable::URI::InvalidURIError
-          err = "Malformed URI: #{l['target']}"
-          @log.add("Anchors", l, err, severity: 0)
+          @log.add("STANDOC_8", l, params: [l["target"]])
         end
       end
 

data/lib/metanorma/standoc/cleanup_maths.rb

@@ -39,15 +39,15 @@ module Metanorma
           expr.strip.empty? and return
           unitsml = if expr.include?("unitsml")
                       { unitsml: { xml: true, multiplier: :space } }
-                    else {} end
+                    else {}
+                    end
           Plurimath::Math.parse(expr, "asciimath")
             .to_mathml(**{ display_style: elem["block"] }.merge(unitsml))
         end
       end
 
       def asciimath2mathml_err(text, expr)
-        err = "Malformed MathML: #{expr}\n#{text}"
-        @log.add("Maths", nil, err, severity: 0)
+        @log.add("STANDOC_6", nil, params: [expr, text])
       end
 
       def asciimath2mathml_wrap(xml)

data/lib/metanorma/standoc/cleanup_terms_boilerplate.rb

@@ -30,9 +30,7 @@ module Metanorma
       def verify_term_defs_source(source)
         source.each do |s|
           @anchors[s["bibitemid"]] or
-            @log.add("Crossreferences", nil,
-                     "term source #{s['bibitemid']} not referenced",
-                     severity: 1)
+            @log.add("STANDOC_28", nil, params: [s["bibitemid"]])
         end
       end
 

data/lib/metanorma/standoc/cleanup_terms_designations.rb

@@ -116,8 +116,7 @@ module Metanorma
       def dl_to_designation(dlist)
         prev = dlist.previous_element
         unless %w(preferred admitted deprecates related).include? prev&.name
-          @log.add("AsciiDoc Input", dlist, "Metadata definition list does " \
-                                            "not follow a term designation")
+          @log.add("STANDOC_20", dlist)
           return nil
         end
         prev
@@ -182,7 +181,7 @@ module Metanorma
           DESIGNATOR.each do |n|
             t.xpath("./#{n}/expression/name").each_with_object([]) do |d, m|
               if m.include?(d.text)
-                @log.add("Terms", t, "Removed duplicate designation #{d.text}")
+                @log.add("STANDOC_21", t, params: [d.text])
                 d.parent.parent.remove
               end
               m << d.text

data/lib/metanorma/standoc/cleanup_xref.rb

@@ -91,9 +91,7 @@ module Metanorma
       def xref_to_eref1(elem)
         elem["citeas"] = ""
         @internal_eref_namespaces.include?(elem["type"]) or
-          @log.add("Crossreferences", elem,
-                   "#{elem['target']} does not have a corresponding " \
-                   "anchor ID in the bibliography!")
+          @log.add("STANDOC_30", elem, params: [elem["target"]])
       end
 
       def xref_cleanup(xmldoc)
@@ -161,8 +159,7 @@ module Metanorma
           y.size == 1 and
             y.unshift(l.dig(i + 1, 0) == "to" ? "from" : "and")
           %w(and from to or).include?(y[0]) or
-            @log.add("Crossreferences", xref,
-                     "Illegal cross-reference connective: #{y[0]}", severity: 0)
+            @log.add("STANDOC_31", xref, params: [y[0]])
           y
         end
       end
@@ -220,9 +217,7 @@ module Metanorma
         end
         xmldoc.xpath("//origin").each do |x|
           x["citeas"] = @anchors&.dig(x["bibitemid"], :xref) or
-            @log.add("Crossreferences", x,
-                     "#{x['bibitemid']} does not have a corresponding anchor " \
-                     "ID in the bibliography!")
+            @log.add("STANDOC_32", x, params: [x["bibitemid"]])
           extract_localities(x)
         end
       end

data/lib/metanorma/standoc/converter.rb

@@ -14,6 +14,7 @@ require_relative "utils"
 require_relative "cleanup"
 require_relative "reqt"
 require_relative "macros"
+require_relative "log"
 
 module Metanorma
   module Standoc
@@ -117,9 +118,11 @@ module Metanorma
       end
 
       def local_log(doc)
-        @log = doc&.options&.dig(:log) and return
-        @log = Metanorma::Utils::Log.new
-        @local_log = true
+        unless @log = doc&.options&.dig(:log)
+          @log = Metanorma::Utils::Log.new
+          @local_log = true
+        end
+        @log.add_msg(log_messages)
       end
 
       class << self
@@ -141,8 +144,7 @@ module Metanorma
 
       def skip(node, name = nil)
         name = name || node.node_name
-        w = "converter missing for #{name} node in Metanorma backend"
-        @log.add("AsciiDoc Input", node, w, severity: 1)
+        @log.add("STANDOC_29", node, params: [name])
         nil
       end
 

data/lib/metanorma/standoc/front.rb

@@ -186,6 +186,7 @@ module Metanorma
       # English plain title: :title: or implicit, typed as main
       def title_main(node, xml)
         title = node.attr("title")
+        title.nil? || title.empty? and return
         node.attr("title-en") and return
         add_title_xml(xml, title, "en", "main")
       end

data/lib/metanorma/standoc/inline.rb

@@ -34,9 +34,7 @@ module Metanorma
         results = Plurimath::Math.parse(lxm_input, "latex")
           .to_mathml(display_style: block)
         if results.nil?
-          @log.add("Maths", nil,
-                   "latexmlmath failed to process equation:\n#{lxm_input}",
-                   severity: 1)
+          @log.add("STANDOC_51", nil, params: [lxm_input])
           return
         end
         results.sub(%r{<math ([^>]+ )?display="block"}, "<math \\1")

data/lib/metanorma/standoc/localbib.rb

@@ -48,24 +48,20 @@ module Metanorma
       end
 
       def file_error(config)
-        msg = "Cannot process file #{config['file']} for local relaton " \
-              "data source #{config['key']}"
-        @parent.log.add("Bibliography", nil, msg, severity: 0)
+        @parent.log.add("STANDOC_54", nil,
+                        params: [config["file"], config["key"]])
         ""
       end
 
       def format_error(config)
-        msg = "Cannot process format #{config['format']} for local relaton " \
-              "data source #{config['key']}"
-        @parent.log.add("Bibliography", nil, msg, severity: 0)
+        @parent.log.add("STANDOC_37", nil,
+                        params: [config["format"], config["key"]])
         {}
       end
 
       def get(id, file = default)
         ret = @file_bibdb.dig(file, id) and return ret
-        msg = "Cannot find reference #{id} for local relaton " \
-              "data source #{file}"
-        @parent.log.add("Bibliography", nil, msg, severity: 0)
+        @parent.log.add("STANDOC_19", nil, params: [id, file])
         Nokogiri::XML("<bibitem/>")
       end
     end

data/lib/metanorma/standoc/log.rb

@@ -0,0 +1,195 @@
+module Metanorma
+  module Standoc
+    class Converter
+      # rubocop:disable Naming/VariableNumber
+      STANDOC_LOG_MESSAGES = {
+        "STANDOC_1": { category: "Include",
+                       error: "Specified boilerplate file does not exist: %s",
+                       severity: 0 },
+        "STANDOC_2": { category: "Table", error: "Empty table",
+                       severity: 0 },
+        "STANDOC_3": { category: "Crossreferences",
+                       error: "invalid index \"%s\" cross-reference: " \
+                       "wrong number of attributes in `index:%s[%s]`",
+                       severity: 0 },
+        "STANDOC_4": { category: "Table",
+                       error: "Table rows in table %s: check rowspan",
+                       severity: 0 },
+        "STANDOC_5": { category: "Table",
+                       error: "Table exceeds maximum number of columns defined (%s)",
+                       severity: 0 },
+        "STANDOC_6": { category: "Maths",
+                       error: "Malformed MathML: %s\n%s",
+                       severity: 0 },
+        "STANDOC_7": { category: "Metanorma XML Syntax", error: "%s",
+                       severity: 2 },
+        "STANDOC_8": { category: "Anchors", error: "Malformed URI: %s",
+                       severity: 0 },
+        "STANDOC_9": { category: "Bibliography",
+                       error: "Attachment %s does not exist",
+                       severity: 0 },
+        "STANDOC_10": { category: "Anchors",
+                        error: "The following reference is missing an anchor:\n%s",
+                        severity: 1 },
+        "STANDOC_11": { category: "Bibliography",
+                        error: "Reference %s is missing a title",
+                        severity: 1 },
+        "STANDOC_12": { category: "Bibliography",
+                        error: "Reference %s is missing a document identifier (docid)",
+                        severity: 1 },
+        "STANDOC_13": { category: "AsciiDoc Input",
+                        error: "term reference not in expected format:%s",
+                        severity: 1 },
+        "STANDOC_14": { category: "Style",
+                        error: "Style override set for ordered list",
+                        severity: 2 },
+        "STANDOC_15": { category: "Crossreferences",
+                        error: "Could not resolve footnoteblock:[%s]",
+                        severity: 1 },
+        "STANDOC_16": { category: "AsciiDoc Input",
+                        error: "Section not marked up as [bibliography]!",
+                        severity: 2 },
+        "STANDOC_17": { category: "Bibliography",
+                        error: "ERROR: No document identifier retrieved for %s",
+                        severity: 2 },
+        "STANDOC_18": { category: "Bibliography",
+                        error: "ERROR: No title retrieved for %s", severity: 2 },
+        "STANDOC_19": { category: "Bibliography",
+                        error: "Cannot find reference %s for local Relaton " \
+                                "data source %s", severity: 0 },
+        "STANDOC_20": { category: "AsciiDoc Input",
+                        error: "Metadata definition list does not follow a term designation",
+                        severity: 2 },
+        "STANDOC_21": { category: "Terms",
+                        error: "Removed duplicate designation %s",
+                        severity: 2 },
+        "STANDOC_22": { category: "Bibliography",
+                        error: "Term \"%s\" does not match IEV %s \"%s\"",
+                        severity: 1 },
+        "STANDOC_23": { category: "Anchors",
+                        error: "Concept cross-reference error: %s",
+                        severity: 0 },
+        "STANDOC_24": { category: "Terms",
+                        error: "Term %s occurs twice as preferred designation: %s",
+                        severity: 1 },
+        "STANDOC_25": { category: "Terms", severity: 0,
+                        error: <<~ERROR.freeze },
+                          Clause not recognised as a term clause, but contains designation markup
+                           (<code>preferred:[], admitted:[], alt:[], deprecated:[]</code>):<br/>
+                          %s</br>
+                          Ensure the parent clause is recognised as a terms clause by inserting <code>[heading=terms and definitions]</code> above the title,
+                          in case the heading is not automatically recognised. See also <a href="https://www.metanorma.org/author/topics/sections/concepts/#clause-title">Metanorma documentation</a>.
+                        ERROR
+        "STANDOC_26": { category: "AsciiDoc Input",
+                        error: "Error: Symbol reference in `symbol[%s]` missing: \"%s\" is not defined in document",
+                        severity: 1 },
+        "STANDOC_27": { category: "AsciiDoc Input",
+                        error: "Error: Term reference to `%s` missing: \"%s\" is not defined in document%s",
+                        severity: 1 },
+        "STANDOC_28": { category: "Crossreferences",
+                        error: "term source %s not referenced",
+                        severity: 1 },
+        "STANDOC_29": { category: "AsciiDoc Input",
+                        error: "converter missing for %s node in Metanorma backend",
+                        severity: 1 },
+        "STANDOC_30": { category: "Crossreferences",
+                        error: "%s does not have a corresponding anchor ID in the bibliography!",
+                        severity: 2 },
+        "STANDOC_31": { category: "Crossreferences",
+                        error: "Illegal cross-reference connective: %s",
+                        severity: 0 },
+        "STANDOC_32": { category: "Crossreferences",
+                        error: "%s does not have a corresponding anchor ID in the bibliography!",
+                        severity: 2 },
+        "STANDOC_33": { category: "Maths",
+                        error: "Invalid MathML: %s\n %s%s",
+                        severity: 0 },
+        "STANDOC_34": { category: "Style",
+                        error: "There is an instance of %s nested within %s",
+                        severity: 2 },
+        "STANDOC_35": { category: "Style",
+                        error: "There is a crossreference to an instance of %s nested within %s: %s",
+                        severity: 2 },
+        "STANDOC_36": { category: "Anchors",
+                        error: "ID %s has already been used at line %s",
+                        severity: 0 },
+        "STANDOC_37": { category: "Bibliography",
+                        error: "Cannot process format %s for local Relaton data source %s",
+                        severity: 0 },
+        "STANDOC_38": { category: "Anchors",
+                        error: "Crossreference target %s is undefined",
+                        severity: 1 },
+        "STANDOC_39": { category: "Blocks",
+                        error: "%s is empty",
+                        severity: 1 },
+        "STANDOC_40": { category: "Bibliography",
+                        error: "Could not retrieve %s: no access to online site",
+                        severity: 1 },
+        "STANDOC_41": { category: "Include",
+                        error: "Unresolved directive %s",
+                        severity: 0 },
+        "STANDOC_42": { category: "Metanorma XML Syntax",
+                        error: "Invalid passthrough content: %s\n" \
+                      "This is not valid Metanorma XML. If you intended a different format, such as HTML, you need to specify `format=` on the pass markup;\n" \
+                      "refer to https://www.metanorma.org/author/topics/blocks/passthroughs/",
+                        severity: 0 },
+        "STANDOC_43": { category: "AsciiDoc Input",
+                        error: <<~REF.freeze, severity: 1 },
+                          no anchor on reference, markup may be malformed: see
+                          https://www.metanorma.org/author/topics/sections/bibliography/ ,
+                          https://www.metanorma.org/author/iso/topics/markup/#bibliographies : %s
+                        REF
+        "STANDOC_44": { category: "Images", error: "Image not found: %s",
+                        severity: 0 },
+        "STANDOC_45": { category: "Images",
+                        error: "Corrupt PNG image detected: %s",
+                        severity: 2 },
+        "STANDOC_46": { category: "Images",
+                        error: "Image too large for Data URI encoding: disable Data URI encoding (`:data-uri-image: false`), or set `:data-uri-maxsize: 0`",
+                        severity: 0 },
+        "STANDOC_47": { category: "Crossreferences",
+                        error: "mismatch of callouts (%s) and annotations (%s)",
+                        severity: 0 },
+        "STANDOC_48": { category: "Style", error: "(generic warning) %s",
+                        severity: 2 },
+        "STANDOC_49": { category: "Bibliography",
+                        error: "Numeric reference in normative references",
+                        severity: 1 },
+        "STANDOC_50": { category: "Fatal Error", error: "%s", severity: 0 },
+        "STANDOC_51": { category: "Maths",
+                        error: "latexmlmath failed to process equation:\n%s",
+                        severity: 1 },
+        "STANDOC_52": { category: "Bibliography",
+                        error: "Bibliographic spans: %s",
+                        severity: 0 },
+        "STANDOC_53": { category: "Bibliography",
+                        error: "Bibliographic spans: %s",
+                        severity: 1 },
+        "STANDOC_54": { category: "Bibliography",
+                        error: "Cannot process file %s for local Relaton data source %s",
+                        severity: 0 },
+        "RELATON_1": { category: "Relaton",
+                       error: "(Error from Relaton) %s",
+                       severity: 0 },
+        "RELATON_2": { category: "Relaton",
+                       error: "(Error from Relaton) %s",
+                       severity: 1 },
+        "RELATON_3": { category: "Relaton",
+                       error: "(Error from Relaton) %s",
+                       severity: 2 },
+        "RELATON_4": { category: "Relaton",
+                       error: "(Error from Relaton) %s",
+                       severity: 3 },
+        "RELATON_5": { category: "Relaton",
+                       error: "(Error from Relaton IEV) %s",
+                       severity: 0 },
+
+      }.freeze
+      # rubocop:enable Naming/VariableNumber
+
+      def log_messages
+        STANDOC_LOG_MESSAGES
+      end
+    end
+  end
+end

data/lib/metanorma/standoc/macros_embed.rb

@@ -15,8 +15,9 @@ module Asciidoctor
         n = peek_line(true)
         /^Unresolved directive in/.match?(n) and
           @document.converter.log
-            &.add("Include", nil,
-                  HTMLEntities.new.encode(n, :basic), severity: 0)
+            &.add("STANDOC_41", nil, params: [HTMLEntities.new.encode(
+              n.sub(/^Unresolved directive /, ""), :basic
+            )])
       end
       [inc_path, target_type, relpath]
     end
@@ -86,7 +87,8 @@ module Metanorma
           if l.is_a?(Hash)
             acc, m = update_embeds(acc, m, emb)
             flatten_embeds(l).each { |x| m << x }
-          else acc << l end
+          else acc << l
+          end
         end
         acc, ret = update_embeds(acc, ret, emb)
         ret

data/lib/metanorma/standoc/macros_link.rb

@@ -13,9 +13,8 @@ module Metanorma
 
       def validate(parent, target, attrs)
         attrs.size > 1 && attrs.size < 5 and return true
-        e = "invalid index \"#{target}\" cross-reference: wrong number of " \
-            "attributes in `index:#{target}[#{attrs.values.join(',')}]`"
-        parent.converter.log.add("Crossreferences", parent, e, severity: 0)
+        parent.converter.log.add("STANDOC_3", parent,
+                                 params: [target, target, attrs.values.join(",")])
         false
       end
 

data/lib/metanorma/standoc/ref.rb

@@ -158,8 +158,7 @@ module Metanorma
       def refitemcode(item, node)
         m = NON_ISO_REF.match(item) and return refitem1code(item, m).compact
         m = NON_ISO_REF1.match(item) and return refitem1code(item, m).compact
-        @log.add("AsciiDoc Input", node, "#{MALFORMED_REF}: #{item}",
-                 severity: 1)
+        @log.add("STANDOC_43", node, params: [item])
         {}
       end
 

data/lib/metanorma/standoc/ref_queue.rb

@@ -42,10 +42,9 @@ module Metanorma
           ref, i, doc = results.pop
           m[i.to_i] = { ref: }
           if doc.is_a?(RelatonBib::RequestError)
-            @log.add("Bibliography", nil,
-                     "Could not retrieve #{ref[:code]}: " \
-                     "no access to online site", severity: 1)
-          else m[i.to_i][:doc] = doc end
+            @log.add("STANDOC_40", nil, params: [ref[:code]])
+          else m[i.to_i][:doc] = doc
+          end
         end
       end
 
@@ -136,8 +135,7 @@ module Metanorma
         xml.parent.add_child(smart_render_xml(hit, code, opts))
         xml
       rescue RelatonBib::RequestError
-        @log.add("Bibliography", nil, "Could not retrieve #{code}: " \
-                                      "no access to online site", severity: 1)
+        @log.add("STANDOC_40", nil, params: [code])
         nil
       end
 

data/lib/metanorma/standoc/ref_sect.rb

@@ -47,8 +47,7 @@ module Metanorma
           bibitem_parse(attrs, xml, node)
         else
           node.attr("style") == "bibliography" or
-            @log.add("AsciiDoc Input", node,
-                     "Section not marked up as [bibliography]!")
+            @log.add("STANDOC_16", node)
           nil
         end
       end
@@ -63,8 +62,7 @@ module Metanorma
       def emend_biblio_id(xml, code)
         unless xml.at("/bibitem/docidentifier[not(@type = 'DOI')][text()]") ||
             /^doi:/.match?(code)
-          @log.add("Bibliography", nil,
-                   "ERROR: No document identifier retrieved for #{code}")
+          @log.add("STANDOC_17", nil, params: [code])
           xml.root << "<docidentifier>#{code}</docidentifier>"
         end
       end
@@ -74,8 +72,7 @@ module Metanorma
       def emend_biblio_title(xml, code, title)
         fmt = /<span class=|<fn/.match?(title)
         unless xml.at("/bibitem/title[text()]")
-          @log.add("Bibliography", nil,
-                   "ERROR: No title retrieved for #{code}")
+          @log.add("STANDOC_18", nil, params: [code])
           !fmt and
             xml.root << "<title>#{title || '(MISSING TITLE)'}</title>"
         end

data/lib/metanorma/standoc/ref_utility.rb

@@ -80,7 +80,8 @@ module Metanorma
                  if type == :attachment then "(#{ret[type]})"
                  else ret[type].sub(%r{^[^/]+/}, "")
                  end
-               else ret[:id] end
+               else ret[:id]
+               end
           ret.merge!(id: id, type: type.to_s, key: ret[type], nofetch: true)
         end
         ret
@@ -201,12 +202,6 @@ module Metanorma
           suppress_identifier: code[:dropid] || nil }
       end
 
-      MALFORMED_REF = <<~REF.freeze
-        no anchor on reference, markup may be malformed: see
-        https://www.metanorma.org/author/topics/sections/bibliography/ ,
-        https://www.metanorma.org/author/iso/topics/markup/#bibliographies
-      REF
-
       def ref_normalise(ref)
         ref.gsub("&amp;amp;", "&amp;").gsub(%r{^<em>(.*)</em>}, "\\1")
       end

data/lib/metanorma/standoc/spans_to_bibitem.rb

@@ -36,7 +36,9 @@ module Metanorma
         def convert
           ret = spans_to_bibitem(@spans)
           @out = Nokogiri::XML("<bibitem>#{ret}</bibitem>").root
-          @spans[:type] and @out["type"] = @spans[:type]
+          %i(type language script locale).each do |k|
+            @spans[k] and @out[k.to_s] = @spans[k]
+          end
           self
         end
 
@@ -46,6 +48,7 @@ module Metanorma
           ret += spans_to_bibitem_docid(spans)
           ret += spans_to_contribs(spans)
           ret += spans_to_bibitem_edn(spans)
+          ret += spans_to_bibitem_i18n(spans)
           spans[:abstract] and ret += "<abstract>#{spans[:abstract]}</abstract>"
           ret += spans_to_series(spans)
           spans[:pubplace] and ret += "<place>#{spans[:pubplace]}</place>"
@@ -63,6 +66,14 @@ module Metanorma
           ret
         end
 
+        def spans_to_bibitem_i18n(spans)
+          ret = ""
+          spans[:language] and ret += "<language>#{spans[:language]}</language>"
+          spans[:script] and ret += "<script>#{spans[:script]}</script>"
+          spans[:locale] and ret += "<locale>#{spans[:locale]}</locale>"
+          ret
+        end
+
         def spans_to_series(spans)
           spans[:series] or return ""
           "<series><title>#{spans[:series]}</title></series>"

data/lib/metanorma/standoc/spans_to_bibitem_preprocessing.rb

@@ -37,7 +37,7 @@ module Metanorma
         def spans_preprocess(spans)
           ret = empty_span_hash
           spans.each { |s| span_preprocess1(s, ret) }
-          host_rearrange(ret)
+          spans_defaults(host_rearrange(ret))
         end
 
         def span_preprocess1(span, ret)
@@ -52,7 +52,7 @@ module Metanorma
             ret[:extent][span[:key].to_sym] ||= []
             ret[:extent][span[:key].to_sym] << span[:val]
           when "pubplace", "title", "type", "series", "edition", "version",
-            "abstract"
+            "abstract", "language", "script", "locale"
             ret[span[:key].to_sym] = span[:val]
           when "image"
             ret[span[:key].to_sym] << { type: span[:type], val: span[:val] }
@@ -92,17 +92,21 @@ module Metanorma
           end
         end
 
+        def spans_defaults(spans)
+          spans[:language] && !spans[:script] and
+            spans[:script] = ::Metanorma::Utils.default_script(spans[:language])
+          spans
+        end
+
         def host_rearrange(ret)
           ret[:in][:title] or return ret
-          ret[:in].merge!(empty_span_hash, { type: "misc" }) do |_, old, _|
-            old
-          end
+          ret[:in].merge!(empty_span_hash, { type: "misc" }) { |_, o, _| o }
           %i(series).each do |k|
             ret[:in][k] = ret[k]
             ret.delete(k)
           end
-          /^in/.match?(ret[:type]) and ret[:in][:type] =
-                                         ret[:type].sub(/^in/, "")
+          /^in/.match?(ret[:type]) and
+            ret[:in][:type] = ret[:type].sub(/^in/, "")
           ret
         end
 

data/lib/metanorma/standoc/term_lookup_cleanup.rb

@@ -110,33 +110,22 @@ module Metanorma
 
       def remove_missing_ref(node, target)
         if node.at("./parent::concept[@type = 'symbol']")
-          log.add("AsciiDoc Input", node,
-                  remove_missing_ref_msg(node, target, :symbol), severity: 1)
+          log.add("STANDOC_26", node, params: [target, target])
           remove_missing_ref_term(node, target, "symbol")
         else
-          log.add("AsciiDoc Input", node,
-                  remove_missing_ref_msg(node, target, :term), severity: 1)
+          log.add("STANDOC_27", node,
+                  params: [target, target, remove_missing_ref_msg1(node, target)])
           remove_missing_ref_term(node, target, "term")
         end
       end
 
-      def remove_missing_ref_msg(node, target, type)
-        type == :symbol and return <<~LOG
-          Error: Symbol reference in `symbol[#{target}]` missing: "#{target}" is not defined in document
-        LOG
-        ret = <<~LOG
-          Error: Term reference to `#{target}` missing: "#{target}" is not defined in document
-        LOG
-        remove_missing_ref_msg1(node, target, ret)
-      end
-
-      def remove_missing_ref_msg1(_node, target, ret)
+      def remove_missing_ref_msg1(_node, target)
         target2 = "_#{target.downcase.tr('-', '_')}"
         if @terms_tags[target] || @terms_tags[target2]
-          ret.strip!
-          ret += ". Did you mean to point to a subterm?"
+          ". Did you mean to point to a subterm?"
+        else
+          ""
         end
-        ret
       end
 
       def remove_missing_ref_term(node, target, type)

data/lib/metanorma/standoc/terms.rb

@@ -142,9 +142,7 @@ module Metanorma
 
       def extract_termsource_refs(text, node)
         matched = TERM_REFERENCE_RE.match text
-        matched.nil? and @log.add("AsciiDoc Input", node,
-                                  "term reference not in expected format:" \
-                                  "#{text}", severity: 1)
+        matched.nil? and @log.add("STANDOC_13", node, params: [text])
         matched
       end
 

data/lib/metanorma/standoc/validate.rb

@@ -57,8 +57,7 @@ module Metanorma
         orig = ""
         a and orig += "\n\tAsciimath original: #{@c.decode(a.children.to_xml)}"
         l and orig += "\n\tLatexmath original: #{@c.decode(l.children.to_xml)}"
-        @log.add("Maths", elem,
-                 "Invalid MathML: #{math}\n #{error}#{orig}", severity: 0)
+        @log.add("STANDOC_33", elem, params: [math, error, orig])
       end
 
       def nested_asset_validate(doc)
@@ -85,17 +84,13 @@ module Metanorma
 
       def nested_asset_report(outer, inner, doc)
         outer.name == "figure" && inner.name == "figure" and return
-        err =
-          "There is an instance of #{inner.name} nested within #{outer.name}"
-        @log.add("Style", inner, err)
+        @log.add("STANDOC_34", inner, params: [inner.name, outer.name])
         nested_asset_xref_report(outer, inner, doc)
       end
 
       def nested_asset_xref_report(outer, inner, _doc)
         i = @doc_xrefs[inner["anchor"]] or return
-        err2 = "There is a crossreference to an instance of #{inner.name} " \
-               "nested within #{outer.name}: #{i.to_xml}"
-        @log.add("Style", i, err2)
+        @log.add("STANDOC_35", i, params: [inner.name, outer.name, i.to_xml])
       end
 
       def validate(doc)
@@ -107,9 +102,7 @@ module Metanorma
       # since consequences are so catastrophic
       def repeat_id_validate1(elem)
         if @doc_ids[elem["id"]]
-          @log.add("Anchors", elem,
-                   "ID #{elem['id']} has already been " \
-                   "used at line #{@doc_ids[elem['id']][:line]}", severity: 0)
+          @log.add("STANDOC_36", elem, params: [elem['id'], @doc_ids[elem['id']][:line]])
         else
           @doc_ids[elem["id"]] =
             { line: elem.line, anchor: elem["anchor"] }.compact
@@ -118,9 +111,7 @@ module Metanorma
 
       def repeat_anchor_validate1(elem)
         if @doc_anchors[elem["anchor"]]
-          @log.add("Anchors", elem,
-                   "Anchor #{elem['anchor']} has already been used at line " \
-                   "#{@doc_anchors[elem['anchor']][:line]}", severity: 0)
+          @log.add("STANDOC_36", elem, params: [elem['anchor'], @doc_anchors[elem['anchor']][:line]])
         else
           @doc_anchors[elem["anchor"]] = { line: elem.line, id: elem["id"] }
           @doc_anchor_seq << elem["anchor"]
@@ -174,8 +165,7 @@ module Metanorma
           doc.xpath("//#{a[0]}/@#{a[1]}").each do |x|
             @doc_xrefs[x.text] = x.parent
             @doc_anchors[x.text] and next
-            @log.add("Anchors", x.parent,
-                     "Crossreference target #{x} is undefined", severity: 1)
+            @log.add("STANDOC_38", x.parent, params: [x.text])
           end
         end
       end
@@ -217,7 +207,7 @@ module Metanorma
         doc.xpath(tag).each do |t|
           body and t = t.at("./#{body}")
           empty_block?(t) or next
-          @log.add("Blocks", t, "#{tag.sub(/^\/\//, '')} is empty", severity: 1)
+          @log.add("STANDOC_39", t, params: [tag.sub(/^\/\//, '')])
         end
       end
 

data/lib/metanorma/standoc/validate_image.rb

@@ -14,8 +14,7 @@ module Metanorma
           Vectory::Utils::url?(i["src"]) and next
           Vectory::Utils::datauri?(i["src"]) and next
           expand_path(i["src"]) and next
-          @log.add("Images", i.parent,
-                   "Image not found: #{i['src']}", severity: 0)
+          @log.add("STANDOC_44", i.parent, params: [i["src"]])
         end
       end
 
@@ -42,19 +41,14 @@ module Metanorma
       def png_validate1(img, buffer)
         PngCheck.check_buffer(buffer)
       rescue PngCheck::CorruptPngError => e
-        @log.add("Images", img.parent,
-                 "Corrupt PNG image detected: #{e.message}")
+        @log.add("STANDOC_45", img.parent, params: [e.message])
       end
 
-      TOO_BIG_IMG_ERR = <<~ERR.freeze
-        Image too large for Data URI encoding: disable Data URI encoding (`:data-uri-image: false`), or set `:data-uri-maxsize: 0`
-      ERR
-
       def image_toobig(doc)
         @dataurimaxsize.zero? and return
         doc.xpath("//image").each do |i|
           i["src"].size > @dataurimaxsize and
-            @log.add("Images", i.parent, TOO_BIG_IMG_ERR, severity: 0)
+            @log.add("STANDOC_46", i.parent)
         end
       end
     end

data/lib/metanorma/standoc/validate_schema.rb

@@ -30,8 +30,9 @@ module Metanorma
         errors = Jing.new(schema, encoding: "UTF-8").validate(file.path)
         warn "Syntax Valid!" if errors.none?
         errors.each do |e|
-          @log.add("Metanorma XML Syntax",
-                   "XML Line #{'%06d' % e[:line]}:#{e[:column]}", e[:message])
+          @log.add("STANDOC_7",
+                   "XML Line #{'%06d' % e[:line]}:#{e[:column]}",
+                   params: [e[:message]])
         end
       end
 

data/lib/metanorma/standoc/validate_section.rb

@@ -19,16 +19,14 @@ module Metanorma
 
       def callouts_error(elem, callouts, annotations)
         if callouts.size != annotations.size && !annotations.empty?
-          err = "mismatch of callouts (#{callouts.size}) and annotations " \
-                "(#{annotations.size})"
-          @log.add("Crossreferences", elem, err, severity: 0)
+          @log.add("STANDOC_47", elem, params: [callouts.size, annotations.size])
         end
       end
 
       def style_warning(node, msg, text = nil)
         w = msg
         w += ": #{text}" if text
-        @log.add("Style", node, w)
+        @log.add("STANDOC_48", node, params: [w])
       end
 
       def reject_metanorma_extension
@@ -69,8 +67,7 @@ module Metanorma
         doc.xpath("//references[@normative = 'true']/bibitem").each do |b|
           docid = b.at("./docidentifier[@type = 'metanorma']") or next
           /^\[\d+\]$/.match?(docid.text) or next
-          @log.add("Bibliography", b,
-                   "Numeric reference in normative references", severity: 1)
+          @log.add("STANDOC_49", b)
         end
       end
     end

data/lib/metanorma/standoc/validate_table.rb

@@ -17,7 +17,7 @@ module Metanorma
       def empty_table_validate(doc)
         doc.xpath("//table[not(.//tr)]").reject(&reject_metanorma_extension)
           .each do |t|
-          @log.add("Table", t, "Empty table", severity: 0)
+          @log.add("STANDOC_2", t)
         end
       end
 
@@ -79,17 +79,15 @@ module Metanorma
       def maxrows_validate(table, cells2d, tablechild, mode)
         err = "are inconsistent"
         mode == "thead_row" and err = "cannot go outside #{tablechild}"
-        err = "Table rows in table #{err}: check rowspan"
         if cells2d.any? { |x| x.size != cells2d.first.size }
-          @log.add("Table", table, err, severity: 0)
+          @log.add("STANDOC_4", table, params: [err])
         end
       end
 
       # if maxcols or maxrows negative, do not check them
       def maxcols_check(col, maxcols, tcell)
         if maxcols.positive? && col > maxcols
-          @log.add("Table", tcell, "Table exceeds maximum number of columns "\
-                                   "defined (#{maxcols})", severity: 0)
+          @log.add("STANDOC_5", tcell, params: [maxcols])
         end
       end
     end

data/lib/metanorma/standoc/validate_term.rb

@@ -25,23 +25,20 @@ module Metanorma
       end
 
       def iev_validate1(term, loc, xmldoc)
-        require "debug"; binding.b
         iev = @iev.fetch(loc,
                          xmldoc.at("//language")&.text || "en") or return
         pref = term.xpath("./preferred//name").inject([]) do |m, x|
           m << x.text&.downcase
         end
         pref.include?(iev.downcase) or
-          @log.add("Bibliography", term, %(Term "#{pref[0]}" does not match ) +
-                   %(IEV #{loc} "#{iev}"), severity: 1)
+          @log.add("STANDOC_22", term, params: [pref[0], loc, iev])
       end
 
       def concept_validate(doc, tag, refterm)
         concept_validate_ids(doc)
         doc.xpath("//#{tag}/xref").each do |x|
           @concept_ids[x["target"]] and next
-          @log.add("Anchors", x, concept_validate_msg(doc, tag, refterm, x),
-                   severity: 0)
+          @log.add("STANDOC_23", x, params: [concept_validate_msg(doc, tag, refterm, x)])
         end
       end
 
@@ -82,8 +79,7 @@ module Metanorma
         terms.each do |k, v|
           v.size > 1 or next
           loc = v.map { |x| x["anchor"] }.join(", ")
-          err = "Term #{k} occurs twice as preferred designation: #{loc}"
-          @log.add("Terms", v.first, err, severity: 1)
+          @log.add("STANDOC_24", v.first, params: [k, loc])
         end
       end
 
@@ -106,14 +102,7 @@ module Metanorma
           desgns = v[:designations].map do |x|
             @c.encode(x.text.strip,  :basic, :hexadecimal)
           end.join(", ")
-          err = <<~ERROR
-            Clause not recognised as a term clause, but contains designation markup
-             (<code>preferred:[], admitted:[], alt:[], deprecated:[]</code>):<br/>
-            #{desgns}</br>
-            Ensure the parent clause is recognised as a terms clause by inserting <code>[heading=terms and definitions]</code> above the title,
-            in case the heading is not automatically recognised. See also <a href="https://www.metanorma.org/author/topics/sections/concepts/#clause-title">Metanorma documentation</a>.
-          ERROR
-          @log.add("Terms", v[:clause], err, severity: 0)
+          @log.add("STANDOC_25", v[:clause], params: [desgns])
         end
       end
     end

data/lib/metanorma/standoc/version.rb

@@ -19,6 +19,6 @@ module Metanorma
   end
 
   module Standoc
-    VERSION = "3.1.9".freeze
+    VERSION = "3.2.0".freeze
   end
 end

data/metanorma-standoc.gemspec

@@ -32,12 +32,12 @@ Gem::Specification.new do |spec|
   spec.add_dependency "asciidoctor", "~> 2.0.0"
   spec.add_dependency "crass", "~> 1.0.0"
   spec.add_dependency "iev", "~> 0.3.5"
-  spec.add_dependency "isodoc", "~> 3.3.0"
+  spec.add_dependency "isodoc", "~> 3.4.0"
   spec.add_dependency "metanorma", ">= 1.6.0"
   spec.add_dependency "metanorma-plugin-glossarist", "~> 0.2.3"
   spec.add_dependency "metanorma-plugin-lutaml", "~> 0.7.31"
   spec.add_dependency "metanorma-plugin-plantuml", "~> 1.0.0"
-  spec.add_dependency "metanorma-utils", "~> 1.11.0"
+  spec.add_dependency "metanorma-utils", "~> 2.0.0"
   spec.add_dependency "ruby-jing"
   # relaton-cli not just relaton, to avoid circular reference in metanorma
   spec.add_dependency "concurrent-ruby"
@@ -58,6 +58,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "timecop", "~> 0.9"
   spec.add_development_dependency "vcr", "~> 6.1.0"
   spec.add_development_dependency "webmock"
-  spec.add_development_dependency "canon"
+  spec.add_development_dependency "openssl"
+  spec.add_development_dependency "canon", "= 0.1.3"
   # spec.metadata["rubygems_mfa_required"] = "true"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: metanorma-standoc
 version: !ruby/object:Gem::Version
-  version: 3.1.9
+  version: 3.2.0
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-13 00:00:00.000000000 Z
+date: 2025-11-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -72,14 +72,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.3.0
+        version: 3.4.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.3.0
+        version: 3.4.0
 - !ruby/object:Gem::Dependency
   name: metanorma
   requirement: !ruby/object:Gem::Requirement
@@ -142,14 +142,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.11.0
+        version: 2.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.11.0
+        version: 2.0.0
 - !ruby/object:Gem::Dependency
   name: ruby-jing
   requirement: !ruby/object:Gem::Requirement
@@ -403,7 +403,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: canon
+  name: openssl
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -416,6 +416,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: canon
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.1.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.1.3
 description: |
   metanorma-standoc realises standards following the Metanorma standoc model
 
@@ -538,6 +552,7 @@ files:
 - lib/metanorma/standoc/isolated_converter.rb
 - lib/metanorma/standoc/lists.rb
 - lib/metanorma/standoc/localbib.rb
+- lib/metanorma/standoc/log.rb
 - lib/metanorma/standoc/macros.rb
 - lib/metanorma/standoc/macros_embed.rb
 - lib/metanorma/standoc/macros_form.rb