metanorma-standoc 1.3.26 → 1.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 775bf1c752d3200f542014ac45b50d4d71cf4f660a8c25e80cae21f234cbf219
-  data.tar.gz: 50d5cdbbdf778a7a470c2e58bd9c1c6a46c0c7d522f7ac80c984511540ac0325
+  metadata.gz: ec38f1dc395a1d89eb57193772856d31e40e0d4e725f449884529f794a77c341
+  data.tar.gz: be6615f68c933d6028ef70aad058e4ec042d7ff5eabdf489c13abe7743aa1010
 SHA512:
-  metadata.gz: 3d427d6d3525c635a5303b1f4ac2078bd789ada7268f8493c26e112f985ff249a4b9d74fe466d14177962132c7903a64162a52f41d8e439a5170e2c96e3b1380
-  data.tar.gz: 7e052c9a72d6f530fd0de026012e3cfaed6813256ed7e979076af4da02fc05f04884e30fc69e27eb2246d721e200c6a4d368a19d1d32cd9c6344a9fbf3e6b7cf
+  metadata.gz: 425e48990782c8de5e70d18fb3404eebdfa9b7c0bf1e6e454e89451e4593266d80b87981162881eac9e17aa5dcf6f711e3f2c4c4d61141be15b396446163bb30
+  data.tar.gz: 4d534831af15ebdd19c9e81ea000a13022cd1ed2ff0e9c1bedab90a829cbb105dd454adfe72befedd3341d5a47ca6920925ea6de77266259f93a17f25287a62a

data/.github/workflows/macos.yml

@@ -6,15 +6,23 @@ on:
   push:
     branches: [ master ]
   pull_request:
+    paths-ignore:
+      - .github/workflows/ubuntu.yml
+      - .github/workflows/windows.yml
 
 jobs:
   test-macos:
     name: Test on Ruby ${{ matrix.ruby }} macOS
     runs-on: macos-latest
+    continue-on-error: ${{ matrix.experimental }}
     strategy:
       fail-fast: false
       matrix:
         ruby: [ '2.6', '2.5', '2.4' ]
+        experimental: [false]
+        include:
+          - ruby: '2.7'
+            experimental: true
     steps:
       - uses: actions/checkout@master
       - name: Use Ruby

data/.github/workflows/ubuntu.yml

@@ -6,15 +6,23 @@ on:
   push:
     branches: [ master ]
   pull_request:
+    paths-ignore:
+      - .github/workflows/macos.yml
+      - .github/workflows/windows.yml
 
 jobs:
   test-linux:
     name: Test on Ruby ${{ matrix.ruby }} Ubuntu
     runs-on: ubuntu-latest
+    continue-on-error: ${{ matrix.experimental }}
     strategy:
       fail-fast: false
       matrix:
         ruby: [ '2.6', '2.5', '2.4' ]
+        experimental: [false]
+        include:
+          - ruby: '2.7'
+            experimental: true
     steps:
       - uses: actions/checkout@master
       - name: Use Ruby

data/.github/workflows/windows.yml

@@ -6,15 +6,23 @@ on:
   push:
     branches: [ master ]
   pull_request:
+    paths-ignore:
+      - .github/workflows/macos.yml
+      - .github/workflows/ubuntu.yml
 
 jobs:
   test-windows:
     name: Test on Ruby ${{ matrix.ruby }} Windows
     runs-on: windows-latest
+    continue-on-error: ${{ matrix.experimental }}
     strategy:
       fail-fast: false
       matrix:
         ruby: [ '2.6', '2.5', '2.4' ]
+        experimental: [false]
+        include:
+          - ruby: '2.7'
+            experimental: true
     steps:
       - uses: actions/checkout@master
       - name: Use Ruby

data/.gitignore

@@ -9,3 +9,4 @@ spec/examples/rice.doc
 spec/examples/rice.html
 spec/examples/rice.xml
 spec/examples/rice_files/
+Gemfile.lock

data/lib/asciidoctor/standoc/base.rb

@@ -15,6 +15,8 @@ module Asciidoctor
       XML_NAMESPACE = "https://www.metanorma.org/ns/standoc".freeze
 
       Asciidoctor::Extensions.register do
+        preprocessor Asciidoctor::Standoc::Datamodel::AttributesTablePreprocessor
+        preprocessor Asciidoctor::Standoc::Datamodel::DiagramPreprocessor
         preprocessor Asciidoctor::Standoc::Yaml2TextPreprocessor
         inline_macro Asciidoctor::Standoc::AltTermInlineMacro
         inline_macro Asciidoctor::Standoc::DeprecatedTermInlineMacro
@@ -43,7 +45,7 @@ module Asciidoctor
       def skip(node, name = nil)
         name = name || node.node_name
         w = "converter missing for #{name} node in Metanorma backend"
-        @log.add("Asciidoctor Input", node, w)
+        @log.add("AsciiDoc Input", node, w)
         nil
       end
 
@@ -109,7 +111,7 @@ module Asciidoctor
         @fontheader = default_fonts(node)
         @files_to_delete = []
         @filename = node.attr("docfile") ?
-          node.attr("docfile").gsub(/\.adoc$/, "").gsub(%r{^.*/}, "") : ""
+          File.basename(node.attr("docfile")).gsub(/\.adoc$/, "") : ""
         @localdir = Utils::localdir(node)
         @no_isobib_cache = node.attr("no-isobib-cache")
         @no_isobib = node.attr("no-isobib")
@@ -125,31 +127,6 @@ module Asciidoctor
         i18n_init(lang, script)
       end
 
-      def init_bib_caches(node)
-        return if @no_isobib
-        global = !@no_isobib_cache && !node.attr("local-cache-only")
-        local = node.attr("local-cache") || node.attr("local-cache-only")
-        local = nil if @no_isobib_cache
-        @bibdb = Relaton::DbCache.init_bib_caches(
-          local_cache: local,
-          flush_caches: node.attr("flush-caches"),
-          global_cache: global)
-      end
-
-      def init_iev_caches(node)
-        unless (@no_isobib_cache || @no_isobib)
-          node.attr("local-cache-only") or
-            @iev_globalname = global_ievcache_name
-          @iev_localname = local_ievcache_name(node.attr("local-cache") ||
-                                               node.attr("local-cache-only"))
-          if node.attr("flush-caches")
-            FileUtils.rm_f @iev_globalname unless @iev_globalname.nil?
-            FileUtils.rm_f @iev_localname unless @iev_localname.nil?
-          end
-        end
-        #@iev = Iev::Db.new(globalname, localname) unless @no_isobib
-      end
-
       def default_fonts(node)
         b = node.attr("body-font") ||
           (node.attr("script") == "Hans" ? '"SimSun",serif' :
@@ -169,9 +146,13 @@ module Asciidoctor
           html_converter(node).convert(@filename + ".xml")
           doc_converter(node).convert(@filename + ".xml")
         end
+        clean_exit
+        ret
+      end
+
+      def clean_exit
         @log.write(@localdir + @filename + ".err") unless @novalid
         @files_to_delete.each { |f| FileUtils.rm f }
-        ret
       end
 
       def makexml1(node)
@@ -211,7 +192,7 @@ module Asciidoctor
         end
       end
 
-      def term_source_attr(seen_xref)
+      def term_source_attrs(seen_xref)
         { bibitemid: seen_xref.children[0]["target"],
           format: seen_xref.children[0]["format"],
           type: "inline" }
@@ -222,7 +203,7 @@ module Asciidoctor
           xml_t.origin { |o| o << seen_xref.children[0].to_xml }
         else
           xml_t.origin seen_xref.children[0].content,
-            **attr_code(term_source_attr(seen_xref))
+            **attr_code(term_source_attrs(seen_xref))
         end
         m[:text] && xml_t.modification do |mod|
           mod.p { |p| p << m[:text].sub(/^\s+/, "") }
@@ -241,7 +222,7 @@ module Asciidoctor
       def extract_termsource_refs(text, node)
         matched = TERM_REFERENCE_RE.match text
         matched.nil? and
-          @log.add("Asciidoctor Input", node, "term reference not in expected format: #{text}")
+          @log.add("AsciiDoc Input", node, "term reference not in expected format: #{text}")
         matched
       end
 

data/lib/asciidoctor/standoc/biblio.rng

@@ -88,7 +88,7 @@
       <text/>
     </element>
   </define>
-  <define name="LocalizedString">
+  <define name="LocalizedString1">
     <optional>
       <!-- multiple languages and scripts possible: comma delimit them if so -->
       <attribute name="language"/>
@@ -98,6 +98,16 @@
     </optional>
     <text/>
   </define>
+  <define name="LocalizedString">
+    <choice>
+      <ref name="LocalizedString1"/>
+      <oneOrMore>
+        <element name="variant">
+          <ref name="LocalizedString1"/>
+        </element>
+      </oneOrMore>
+    </choice>
+  </define>
   <!--
     Unlike UML, change type to format: type is overloaded
     Would be need if plain were default value and could omit the attribute
@@ -121,7 +131,7 @@
     </optional>
     <ref name="LocalizedStringOrXsAny"/>
   </define>
-  <define name="LocalizedStringOrXsAny">
+  <define name="LocalizedStringOrXsAny1">
     <optional>
       <!-- multiple languages and scripts possible: comma delimit them if so -->
       <attribute name="language"/>
@@ -136,6 +146,16 @@
       </choice>
     </oneOrMore>
   </define>
+  <define name="LocalizedStringOrXsAny">
+    <choice>
+      <ref name="LocalizedStringOrXsAny1"/>
+      <oneOrMore>
+        <element name="variant">
+          <ref name="LocalizedStringOrXsAny1"/>
+        </element>
+      </oneOrMore>
+    </choice>
+  </define>
   <define name="contributor">
     <element name="contributor">
       <zeroOrMore>
@@ -512,7 +532,7 @@
   </define>
   <define name="LocalityType">
     <data type="string">
-      <param name="pattern">section|clause|part|paragraph|chapter|page|whole|table|annex|figure|note|list|example|volume|issue|time|locality:[a-zA-Z0-9_]+</param>
+      <param name="pattern">section|clause|part|paragraph|chapter|page|whole|table|annex|figure|note|list|example|volume|issue|time|anchor|locality:[a-zA-Z0-9_]+</param>
     </data>
   </define>
   <define name="referenceFrom">
@@ -641,9 +661,9 @@
     <optional>
       <ref name="status"/>
     </optional>
-    <optional>
+    <zeroOrMore>
       <ref name="copyright"/>
-    </optional>
+    </zeroOrMore>
     <zeroOrMore>
       <ref name="docrelation"/>
     </zeroOrMore>
@@ -1001,7 +1021,17 @@
       <optional>
         <ref name="to"/>
       </optional>
-      <ref name="owner"/>
+      <oneOrMore>
+        <ref name="owner"/>
+      </oneOrMore>
+      <optional>
+        <ref name="copyright_scope"/>
+      </optional>
+    </element>
+  </define>
+  <define name="copyright_scope">
+    <element name="scope">
+      <text/>
     </element>
   </define>
   <define name="from">

data/lib/asciidoctor/standoc/blocks.rb

@@ -1,5 +1,6 @@
 require "htmlentities"
 require "uri"
+require_relative "./blocks_notes"
 
 module Asciidoctor
   module Standoc
@@ -8,24 +9,27 @@ module Asciidoctor
         { id: Utils::anchor_or_uuid(node) }
       end
 
-      def id_unnum_attr(node)
+      def id_unnum_attrs(node)
         attr_code( id: Utils::anchor_or_uuid(node),
                   unnumbered: node.option?("unnumbered") ? "true" : nil,
+                  number: node.attr("number"),
                   subsequence: node.attr("subsequence") )
       end
 
-      def formula_attr(node)
-        attr_code( id: Utils::anchor_or_uuid(node),
-                  inequality: node.option?("inequality") ? "true" : nil,
-                  unnumbered: node.option?("unnumbered") ? "true" : nil,
-                  subsequence: node.attr("subsequence") )
+      def formula_attrs(node)
+        attr_code(id_unnum_attrs(node).merge(keep_attrs(node).merge(
+          inequality: node.option?("inequality") ? "true" : nil)))
+      end
+
+      def keep_attrs(node)
+        { "keep-with-next": node.attr("keep-with-next"),
+          "keep-lines-together": node.attr("keep-lines-together") }
       end
 
       # We append each contained block to its parent
       def open(node)
         role = node.role || node.attr("style")
-        Utils::reqt_subpart(role) and
-          return requirement_subpart(node)
+        Utils::reqt_subpart(role) and return requirement_subpart(node)
         result = []
         node.blocks.each do |b|
           result << send(b.context, b)
@@ -34,7 +38,7 @@ module Asciidoctor
       end
 
       def literal_attrs(node)
-        attr_code(id_attr(node))
+        attr_code(id_attr(node).merge(keep_attrs(node)))
       end
 
       def literal(node)
@@ -49,84 +53,13 @@ module Asciidoctor
 
       # NOTE: html escaping is performed by Nokogiri
       def stem(node)
-        stem_content = node.lines.join("\n")
-        noko do |xml|
-          xml.formula **formula_attr(node) do |s|
-            stem_parse(stem_content, s, node.style.to_sym)
-          end
-        end
-      end
-
-      def sidebar_attrs(node)
-        todo_attrs(node).merge(attr_code(
-          from: node.attr("from"),
-          to: node.attr("to") || node.attr("from") ))
-      end
-
-      def sidebar(node)
-        return unless draft?
         noko do |xml|
-          xml.review **(sidebar_attrs(node)) do |r|
-            wrap_in_para(node, r)
+          xml.formula **formula_attrs(node) do |s|
+            stem_parse(node.lines.join("\n"), s, node.style.to_sym)
           end
         end
       end
 
-      def todo_attrs(node)
-        date = node.attr("date") || Date.today.iso8601.gsub(/\+.*$/, "")
-        date += "T00:00:00Z" unless /T/.match date
-        attr_code(
-          id: Utils::anchor_or_uuid(node),
-          reviewer: node.attr("reviewer") || node.attr("source") || "(Unknown)",
-          date: date )
-      end
-
-      def todo(node)
-        noko do |xml|
-          xml.review **(todo_attrs(node)) do |r|
-            wrap_in_para(node, r)
-          end
-        end
-      end
-
-      def termnote(n)
-        noko do |xml|
-          xml.termnote **id_attr(n) do |ex|
-            wrap_in_para(n, ex)
-          end
-        end.join("\n")
-      end
-
-      def note(n)
-        noko do |xml|
-          xml.note **id_attr(n) do |c|
-            wrap_in_para(n, c)
-          end
-        end.join("\n")
-      end
-
-      def admonition_attrs(node)
-        name = node.attr("name")
-        if type = node.attr("type")
-          ["danger", "safety precautions"].each do |t|
-            name = t if type.casecmp(t).zero?
-          end
-        end
-        attr_code(id: Utils::anchor_or_uuid(node), type: name)
-      end
-
-      def admonition(node)
-        return termnote(node) if in_terms?
-        return note(node) if node.attr("name") == "note"
-        return todo(node) if node.attr("name") == "todo"
-        noko do |xml|
-          xml.admonition **admonition_attrs(node) do |a|
-            node.title.nil? or a.name { |name| name << node.title }
-            wrap_in_para(node, a)
-          end
-        end.join("\n")
-      end
-
       def term_example(node)
         noko do |xml|
           xml.termexample **id_attr(node) do |ex|
@@ -145,9 +78,10 @@ module Asciidoctor
       end
 
       def pseudocode_example(node)
+        # prevent A's and other subs inappropriate for pseudocode
+        node.blocks.each { |b| b.remove_sub(:replacements) }
         noko do |xml|
-          xml.figure **{id: Asciidoctor::Standoc::Utils::anchor_or_uuid(node),
-                        class: "pseudocode"} do |ex|
+          xml.figure **example_attrs(node).merge(class: "pseudocode") do |ex|
             figure_title(node, ex)
             wrap_in_para(node, ex)
           end
@@ -155,7 +89,7 @@ module Asciidoctor
       end
 
       def example_attrs(node)
-        attr_code(id_unnum_attr(node))
+        attr_code(id_unnum_attrs(node).merge(keep_attrs(node)))
       end
 
       def example_proper(node)
@@ -173,7 +107,7 @@ module Asciidoctor
       end
 
       def figure_attrs(node)
-        attr_code(id_unnum_attr(node))
+        attr_code(id_unnum_attrs(node).merge(keep_attrs(node)))
       end
 
       def image(node)
@@ -186,8 +120,8 @@ module Asciidoctor
       end
 
       def para_attrs(node)
-        attr_code(align: node.attr("align"),
-                  id: Utils::anchor_or_uuid(node))
+        attr_code(keep_attrs(node).merge(align: node.attr("align"), 
+                                        id: Utils::anchor_or_uuid(node)))
       end
 
       def paragraph(node)
@@ -200,7 +134,8 @@ module Asciidoctor
       end
 
       def quote_attrs(node)
-        attr_code(id: Utils::anchor_or_uuid(node), align: node.attr("align"))
+        attr_code(keep_attrs(node).merge(align: node.attr("align"), 
+                                        id: Utils::anchor_or_uuid(node)))
       end
 
       def quote_attribution(node, out)
@@ -210,9 +145,8 @@ module Asciidoctor
             s <<  m[:text]
           end
         end
-        if node.attr("attribution")
+        node.attr("attribution") and
           out.author { |a| a << node.attr("attribution") }
-        end
       end
 
       def quote(node)
@@ -225,10 +159,11 @@ module Asciidoctor
       end
 
       def listing_attrs(node)
-        attr_code(lang: node.attr("language"),
-                  id: Utils::anchor_or_uuid(node),
-                  unnumbered: node.option?("unnumbered") ? "true" : nil,
-                  filename: node.attr("filename"))
+        attr_code(keep_attrs(node).merge(lang: node.attr("language"),
+                                        id: Utils::anchor_or_uuid(node),
+                                        unnumbered: node.option?("unnumbered") ? "true" : nil,
+                                        number: node.attr("number"),
+                                        filename: node.attr("filename")))
       end
 
       # NOTE: html escaping is performed by Nokogiri
@@ -244,7 +179,12 @@ module Asciidoctor
       end
 
       def pass(node)
-        node.content
+        noko do |xml|
+          xml.passthrough **attr_code(formats: 
+                                      node.attr("format") || "metanorma") do |p|
+            p << HTMLEntities.new.encode(node.content, :basic, :hexadecimal)
+          end
+        end
       end
     end
   end