metanorma-standoc 3.1.4 → 3.1.6

data/lib/metanorma/standoc/isodoc.rng

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <grammar xmlns:a="http://relaxng.org/ns/compatibility/annotations/1.0" xmlns="http://relaxng.org/ns/structure/1.0" datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes">
-<!-- VERSION v2.1.1 -->
+<!-- VERSION v2.1.3 -->
 
   <!--
     ALERT: cannot have root comments, because of https://github.com/metanorma/metanorma/issues/437
@@ -123,6 +123,10 @@ the type attribute defaults to `review` for reviews</a:documentation>
           <a:documentation>Notes whose scope is the current block</a:documentation>
         </ref>
       </zeroOrMore>
+      <ref name="BlockSource">
+        <a:documentation>Bibliographic source for the information in the list.
+Sources are currently only rendered in metanorma-plateau</a:documentation>
+      </ref>
     </define>
     <define name="OlBody">
       <optional>
@@ -140,6 +144,10 @@ the type attribute defaults to `review` for reviews</a:documentation>
           <a:documentation>Notes whose scope is the current block</a:documentation>
         </ref>
       </zeroOrMore>
+      <ref name="BlockSource">
+        <a:documentation>Bibliographic source for the information in the list.
+Sources are currently only rendered in metanorma-plateau</a:documentation>
+      </ref>
     </define>
     <define name="OlAttributes">
       <a:documentation>NOTE: `start` attribute is not included by default, because of problems it raises with DOC output</a:documentation>
@@ -188,6 +196,10 @@ the type attribute defaults to `review` for reviews</a:documentation>
           <a:documentation>Notes whose scope is the current block</a:documentation>
         </ref>
       </zeroOrMore>
+      <ref name="BlockSource">
+        <a:documentation>Bibliographic source for the information in the list.
+Sources are currently only rendered in metanorma-plateau</a:documentation>
+      </ref>
     </define>
     <define name="dt">
       <element name="dt">
@@ -443,14 +455,7 @@ normative or informative references, some split references into sections organiz
           </ref>
         </zeroOrMore>
         <zeroOrMore>
-          <ref name="doc_bibitem">
-            <a:documentation>Bibliographic item cited in the document</a:documentation>
-          </ref>
-          <zeroOrMore>
-            <ref name="note">
-              <a:documentation>Annotation of the bibliographic item</a:documentation>
-            </ref>
-          </zeroOrMore>
+          <ref name="ReferenceEntry"/>
         </zeroOrMore>
         <zeroOrMore>
           <ref name="references">
@@ -592,18 +597,21 @@ gives an explicit page orientation</a:documentation>
         </element>
       </optional>
     </define>
-  </include>
-  <!-- end overrides -->
-  <define name="FnAttributes" combine="interleave">
-    <ref name="RequiredId"/>
-    <optional>
-      <attribute name="hiddenref">
-        <a:documentation>If true, number the footnote as normal, but suppress display of the footnote reference in the document body.
+    <define name="FnAttributes">
+      <ref name="RequiredId"/>
+      <optional>
+        <attribute name="hiddenref">
+          <a:documentation>If true, number the footnote as normal, but suppress display of the footnote reference in the document body.
 This is done if the footnote reference is already presented in some other form, e.g. within a figure image.</a:documentation>
-        <data type="boolean"/>
+          <data type="boolean"/>
+        </attribute>
+      </optional>
+      <attribute name="reference">
+        <a:documentation>The number of the footnote, used to identify it visually</a:documentation>
       </attribute>
-    </optional>
-  </define>
+    </define>
+  </include>
+  <!-- end overrides -->
   <define name="TdAttributes" combine="interleave">
     <ref name="RequiredId"/>
     <optional>
@@ -841,6 +849,17 @@ titlecase, or lowercase</a:documentation>
       <value>informative</value>
     </choice>
   </define>
+  <define name="ReferenceEntry">
+    <a:documentation>Entry in bibliography</a:documentation>
+    <ref name="doc_bibitem">
+      <a:documentation>Bibliographic item cited in the document</a:documentation>
+    </ref>
+    <zeroOrMore>
+      <ref name="note">
+        <a:documentation>Annotation of the bibliographic item</a:documentation>
+      </ref>
+    </zeroOrMore>
+  </define>
   <define name="doc_bibitem">
     <a:documentation>Standardisation document representation of bibliographic entry</a:documentation>
     <element name="bibitem">
@@ -871,6 +890,12 @@ titlecase, or lowercase</a:documentation>
       </oneOrMore>
     </element>
   </define>
+  <define name="ParagraphFnBody" combine="interleave">
+    <ref name="BlockSource">
+      <a:documentation>Bibliographic source for the information in the paragraph
+parargaph sources are currently only rendered in metanorma-plateau</a:documentation>
+    </ref>
+  </define>
   <define name="BasicBlock" combine="choice">
     <ref name="columnbreak"/>
   </define>

data/lib/metanorma/standoc/macros.rb

@@ -2,16 +2,14 @@ require "uuidtools"
 require "yaml"
 require "csv"
 require_relative "macros_inline"
-require_relative "macros_plantuml"
 require_relative "macros_terms"
 require_relative "macros_form"
 require_relative "macros_note"
 require_relative "macros_embed"
 require_relative "macros_link"
-require_relative "datamodel/attributes_table_preprocessor"
-require_relative "datamodel/diagram_preprocessor"
 require "metanorma-plugin-glossarist"
 require "metanorma-plugin-lutaml"
+require "metanorma-plugin-plantuml"
 
 module Metanorma
   module Standoc

data/lib/metanorma/standoc/ref.rb

@@ -27,7 +27,7 @@ module Metanorma
       def isorefmatchescode(match, _item)
         code = analyse_ref_code(match[:code])
         yr = norm_year(match[:year])
-        { code: match[:code], year: yr, match:,
+        { code: match[:code], year: yr, match:, fn: match[:fn],
           title: match[:text], usrlbl: match[:usrlbl] || code[:usrlabel],
           analyse_code: code, lang: @lang || :all }
       end
@@ -58,6 +58,14 @@ module Metanorma
         end
       end
 
+      def ref_fn(match, xml)
+        if match.names.include?("fn") && match[:fn]
+          xml.note(**plaintxt.merge(type: "Unpublished-Status")) do |p|
+            p << match[:fn].to_s
+          end
+        end
+      end
+
       def isorefmatches2_1(xml, match, code)
         xml.bibitem **attr_code(ref_attributes(match)) do |t|
           isorefrender1(t, match, code, "--")
@@ -65,11 +73,7 @@ module Metanorma
             d.on "--"
           end
           iso_publisher(t, match[:code])
-          unless match[:fn].nil?
-            t.note(**plaintxt.merge(type: "Unpublished-Status")) do |p|
-              p << match[:fn].to_s
-            end
-          end
+          ref_fn(match, t)
         end
       end
 
@@ -97,11 +101,7 @@ module Metanorma
           isorefrender1(t, match, code, year, " (all parts)")
           conditional_date(t, match, year == "--")
           iso_publisher(t, match[:code])
-          if match.names.include?("fn") && match[:fn]
-            t.note(**plaintxt.merge(type: "Unpublished-Status")) do |p|
-              p << match[:fn].to_s
-            end
-          end
+          ref_fn(match, t)
           t.extent type: "part" do |e|
             e.referenceFrom "all"
           end
@@ -137,6 +137,7 @@ module Metanorma
           /^\d+$|^\(.+\)$/.match?(code[:id]) or
             docnumber(t, code[:id]&.sub(/[:-](19|20)[0-9][0-9]$/, ""))
           conditional_date(t, yr_match || match, false)
+          ref_fn(match, t)
         end
       end
 
@@ -165,11 +166,11 @@ module Metanorma
       def refitem1code(_item, match)
         code = analyse_ref_code(match[:code])
         ((code[:id] && code[:numeric]) || code[:nofetch]) and
-          return { code: nil, match:, analyse_code: code,
+          return { code: nil, match:, analyse_code: code, fn: match[:fn],
                    hidden: code[:hidden] }
         { code: code[:id], analyse_code: code, localfile: code[:localfile],
           year: (m = refitem1yr(code[:id])) ? m[:year] : nil,
-          title: match[:text], match:, hidden: code[:hidden],
+          title: match[:text], match:, hidden: code[:hidden], fn: match[:fn],
           usrlbl: match[:usrlbl] || code[:usrlabel], lang: @lang || :all }
       end
 

data/lib/metanorma/standoc/ref_queue.rb

@@ -195,7 +195,7 @@ module Metanorma
       def smart_render_xml(xml, code, opts)
         xml.respond_to? :to_xml or return nil
         xml = Nokogiri::XML(xml.to_xml(lang: opts[:lang]))
-        emend_biblio(xml, code, opts[:title], opts[:usrlbl])
+        emend_biblio(xml, code, opts)
         xml.xpath("//date").each { |d| Metanorma::Utils::endash_date(d) }
         xml.traverse do |n|
           n.text? and n.replace(Metanorma::Utils::smartformat(n.text))

data/lib/metanorma/standoc/ref_sect.rb

@@ -53,10 +53,11 @@ module Metanorma
         end
       end
 
-      def emend_biblio(xml, code, title, usrlbl)
+      def emend_biblio(xml, code, opts)
         emend_biblio_id(xml, code)
-        emend_biblio_title(xml, code, title)
-        emend_biblio_usrlbl(xml, usrlbl)
+        emend_biblio_title(xml, code, opts[:title])
+        emend_biblio_usrlbl(xml, opts[:usrlbl])
+        emend_biblio_fn(xml, opts[:fn])
       end
 
       def emend_biblio_id(xml, code)
@@ -86,6 +87,11 @@ module Metanorma
         xml.at("/bibitem/docidentifier").next =
           "<docidentifier type='metanorma'>#{mn_code(usrlbl)}</docidentifier>"
       end
+
+      def emend_biblio_fn(xml, fnote)
+        fnote or return
+        xml.root << "<note type='Unpublished-Status'><p>#{fnote}</p></note>"
+      end
     end
   end
 end

data/lib/metanorma/standoc/regex.rb

@@ -53,7 +53,8 @@ module Metanorma
       ISO_REF =
         %r{^<ref\sid="(?<anchor>[^"]+)">
       \[(?<usrlbl>\(.+\))?(?<code>(?:ISO|IEC)[^0-9]*\s[0-9-]+|IEV)
-      (?::(?<year>[0-9][0-9-]+))?\]</ref>,?\s*(?<text>.*)$}xm
+      (?::(?<year>[0-9][0-9-]+))?\]</ref>,?\s*
+        (?:<fn[^>]*>\s*<p>(?<fn>[^\]]+)</p>\s*</fn>)?\s*(?<text>.*)$}xm
 
       ISO_REF_NO_YEAR =
         %r{^<ref\sid="(?<anchor>[^"]+)">
@@ -70,10 +71,12 @@ module Metanorma
 
       # These regexes allow () inside usrlbl but not inside code
       NON_ISO_REF = %r{^<ref\sid="(?<anchor>[^"]+)">
-      \[(?<usrlbl>\(.+\))?(?<code>.+?)\]</ref>,?\s*(?<text>.*)$}xm
+      \[(?<usrlbl>\(.+\))?(?<code>.+?)\]</ref>,?\s*
+      (?:<fn[^>]*>\s*<p>(?<fn>[^\]]+)</p>\s*</fn>)?(?<text>.*)$}xm
 
       NON_ISO_REF1 = %r{^<ref\sid="(?<anchor>[^"]+)">
-      (?<usrlbl>\(.+\))?(?<code>.+?)</ref>,?\s*(?<text>.*)$}xm
+      (?<usrlbl>\(.+\))?(?<code>.+?)</ref>,?\s*
+      (?:<fn[^>]*>\s*<p>(?<fn>[^\]]+)</p>\s*</fn>\s*)?(?<text>.*)$}xm
     end
   end
 end

data/lib/metanorma/standoc/utils.rb

@@ -43,9 +43,11 @@ module Metanorma
         %(id = "_#{UUIDTools::UUID.random_create}")
       end
 
-      def csv_split(text, delim = ";")
-        Metanorma::Utils::csv_split(@c.decode(text), delim)
-          .map { |x| @c.encode(x, :basic, :hexadecimal) }
+      def csv_split(text, delim = ";", encode: true)
+        ret = Metanorma::Utils::csv_split(@c.decode(text), delim)
+        encode and
+          ret.map! { |x| @c.encode(x, :basic, :hexadecimal) }
+        ret
       end
 
       # quoted strings: key="va,lue",
@@ -154,7 +156,17 @@ module Metanorma
           #{text}
         ADOC
         c = Asciidoctor.convert(doc, backend: flavour, header_footer: true)
-        Nokogiri::XML(c).at("//xmlns:sections")
+        ret = Nokogiri::XML(c).at("//xmlns:sections")
+        separate_numbering_footnotes(ret)
+      end
+
+      # separate numbering of externally sourced footnotes
+      # from that of current doc
+      def separate_numbering_footnotes(docxml)
+        docxml.xpath("//xmlns:fn").each do |f|
+          f["reference"] = "_#{UUIDTools::UUID.random_create}_#{f['reference']}"
+        end
+        docxml
       end
 
       def asciimath_key(sym)

data/lib/metanorma/standoc/validate.rb

@@ -28,7 +28,7 @@ module Metanorma
         math_validate(doc)
         fatalerrors = @log.abort_messages
         fatalerrors.empty? or
-          clean_abort("\n\nFATAL ERRROS:\n\n#{fatalerrors.join("\n\n")}", doc)
+          clean_abort("\n\nFATAL ERRORS:\n\n#{fatalerrors.join("\n\n")}", doc)
       end
 
       MATHML_NS = "http://www.w3.org/1998/Math/MathML".freeze

data/lib/metanorma/standoc/validate_section.rb

@@ -31,11 +31,21 @@ module Metanorma
         @log.add("Style", node, w)
       end
 
+      def reject_metanorma_extension
+        ->(node) {
+          node.ancestors.detect do |x|
+            x.name == "metanorma-extension"
+          end
+        }
+      end
+
       def asset_title_style(root)
-        root.xpath("//figure[image][not(name)]").each do |node|
+        root.xpath("//figure[image][not(name)]")
+          .reject(&reject_metanorma_extension).each do |node|
           style_warning(node, "Figure should have title", nil)
         end
-        root.xpath("//table[not(name)]").each do |node|
+        root.xpath("//table[not(name)]")
+          .reject(&reject_metanorma_extension).each do |node|
           style_warning(node, "Table should have title", nil)
         end
       end

data/lib/metanorma/standoc/validate_table.rb

@@ -15,7 +15,8 @@ module Metanorma
       end
 
       def empty_table_validate(doc)
-        doc.xpath("//table[not(.//tr)]").each do |t|
+        doc.xpath("//table[not(.//tr)]").reject(&reject_metanorma_extension)
+          .each do |t|
           @log.add("Table", t, "Empty table", severity: 0)
         end
       end
@@ -30,6 +31,7 @@ module Metanorma
       end
 
       def maxrowcols_validate(table, maxcols, mode: "row_cols")
+        reject_metanorma_extension.call(table) and return
         case mode
         when "row_cols"
           maxrowcols_validate0(table, maxcols, "*", mode)

data/lib/metanorma/standoc/version.rb

@@ -19,6 +19,6 @@ module Metanorma
   end
 
   module Standoc
-    VERSION = "3.1.4".freeze
+    VERSION = "3.1.6".freeze
   end
 end

data/metanorma-standoc.gemspec

@@ -36,6 +36,7 @@ Gem::Specification.new do |spec|
   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 "ruby-jing"
   # relaton-cli not just relaton, to avoid circular reference in metanorma

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: metanorma-standoc
 version: !ruby/object:Gem::Version
-  version: 3.1.4
+  version: 3.1.6
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-18 00:00:00.000000000 Z
+date: 2025-09-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -122,6 +122,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.7.31
+- !ruby/object:Gem::Dependency
+  name: metanorma-plugin-plantuml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: metanorma-utils
   requirement: !ruby/object:Gem::Requirement
@@ -447,9 +461,6 @@ files:
 - lib/asciidoctor/standoc/cleanup_toc.rb
 - lib/asciidoctor/standoc/cleanup_xref.rb
 - lib/asciidoctor/standoc/converter.rb
-- lib/asciidoctor/standoc/datamodel/attributes_table_preprocessor.rb
-- lib/asciidoctor/standoc/datamodel/diagram_preprocessor.rb
-- lib/asciidoctor/standoc/datamodel/plantuml_renderer.rb
 - lib/asciidoctor/standoc/deprecated.rb
 - lib/asciidoctor/standoc/front.rb
 - lib/asciidoctor/standoc/front_contributor.rb
@@ -458,7 +469,6 @@ files:
 - lib/asciidoctor/standoc/macros.rb
 - lib/asciidoctor/standoc/macros_form.rb
 - lib/asciidoctor/standoc/macros_note.rb
-- lib/asciidoctor/standoc/macros_plantuml.rb
 - lib/asciidoctor/standoc/macros_terms.rb
 - lib/asciidoctor/standoc/ref.rb
 - lib/asciidoctor/standoc/ref_sect.rb
@@ -515,12 +525,10 @@ files:
 - lib/metanorma/standoc/cleanup_toc.rb
 - lib/metanorma/standoc/cleanup_xref.rb
 - lib/metanorma/standoc/converter.rb
-- lib/metanorma/standoc/datamodel/attributes_table_preprocessor.rb
-- lib/metanorma/standoc/datamodel/diagram_preprocessor.rb
-- lib/metanorma/standoc/datamodel/plantuml_renderer.rb
 - lib/metanorma/standoc/front.rb
 - lib/metanorma/standoc/front_committee.rb
 - lib/metanorma/standoc/front_contributor.rb
+- lib/metanorma/standoc/front_ext.rb
 - lib/metanorma/standoc/front_organisation.rb
 - lib/metanorma/standoc/init.rb
 - lib/metanorma/standoc/inline.rb
@@ -534,7 +542,6 @@ files:
 - lib/metanorma/standoc/macros_inline.rb
 - lib/metanorma/standoc/macros_link.rb
 - lib/metanorma/standoc/macros_note.rb
-- lib/metanorma/standoc/macros_plantuml.rb
 - lib/metanorma/standoc/macros_terms.rb
 - lib/metanorma/standoc/merge_bibitems.rb
 - lib/metanorma/standoc/processor.rb
@@ -561,8 +568,6 @@ files:
 - lib/metanorma/standoc/validate_table.rb
 - lib/metanorma/standoc/validate_term.rb
 - lib/metanorma/standoc/version.rb
-- lib/metanorma/standoc/views/datamodel/model_representation.adoc.erb
-- lib/metanorma/standoc/views/datamodel/plantuml_representation.adoc.erb
 - metanorma-standoc.gemspec
 homepage: https://github.com/metanorma/metanorma-standoc
 licenses:

data/lib/asciidoctor/standoc/datamodel/attributes_table_preprocessor.rb

@@ -1,3 +0,0 @@
-require "asciidoctor/standoc/deprecated"
-require "metanorma/standoc/datamodel/attributes_table_preprocessor"
-

data/lib/asciidoctor/standoc/datamodel/diagram_preprocessor.rb

@@ -1,3 +0,0 @@
-require "asciidoctor/standoc/deprecated"
-require "metanorma/standoc/datamodel/diagram_preprocessor"
-

data/lib/asciidoctor/standoc/datamodel/plantuml_renderer.rb

@@ -1,8 +0,0 @@
-require "asciidoctor/standoc/deprecated"
-require "metanorma/standoc/datamodel/plantuml_renderer"
-
-module Asciidoctor
-  module Datamodel
-    PlantumlRenderer = Metanorma::Datamodel::PlantumlRenderer
-  end
-end

data/lib/asciidoctor/standoc/macros_plantuml.rb

@@ -1,2 +0,0 @@
-require "asciidoctor/standoc/deprecated"
-require "metanorma/standoc/macros_plantuml"

data/lib/metanorma/standoc/datamodel/attributes_table_preprocessor.rb

@@ -1,57 +0,0 @@
-# frozen_string_literal: true
-
-require "erb"
-
-module Metanorma
-  module Standoc
-    module Datamodel
-      class AttributesTablePreprocessor < Asciidoctor::Extensions::Preprocessor
-        BLOCK_START_REGEXP = /\{(.+?)\.\*,(.+),(.+)\}/
-        BLOCK_END_REGEXP = /\A\{[A-Z]+\}\z/
-        MARCO_REGEXP = /\[datamodel_attributes_table,([^,]+),?(.+)?\]/
-        TEMPLATES_PATH = File.expand_path("../views/datamodel", __dir__).freeze
-        # search document for block `datamodel_attributes_table`
-        #  read include derectives that goes after that in block and transform
-        #  into yaml2text blocks
-        def process(document, reader)
-          input_lines = reader.lines.to_enum
-          Asciidoctor::PreprocessorReader.new(document, processed_lines(document, input_lines))
-        end
-
-        private
-
-        def processed_lines(document, input_lines)
-          input_lines.each_with_object([]) do |line, result|
-            if match = line.match(MARCO_REGEXP)
-              yaml_path = match[1]
-              result.push(*parse_marco(yaml_path, document))
-            else
-              result.push(line)
-            end
-          end
-        end
-
-        def parse_marco(yaml_path, document)
-          model_representation(yaml_relative_path(yaml_path, document))
-            .split("\n")
-        end
-
-        def model_representation(model_path)
-          template = File.read(File.join(
-                                 TEMPLATES_PATH,
-                                 "model_representation.adoc.erb",
-                               ))
-          file_name = File.basename(model_path).gsub(/\.ya?ml/, "")
-          ERB
-            .new(template)
-            .result(binding)
-        end
-
-        def yaml_relative_path(file_path, document)
-          directory = File.dirname(document.attributes["docfile"] || ".")
-          document.path_resolver.system_path(file_path, directory)
-        end
-      end
-    end
-  end
-end

data/lib/metanorma/standoc/datamodel/diagram_preprocessor.rb

@@ -1,103 +0,0 @@
-# frozen_string_literal: true
-
-require "erb"
-require "metanorma/standoc/datamodel/plantuml_renderer"
-
-module Metanorma
-  module Standoc
-    module Datamodel
-      class DiagramPreprocessor < Asciidoctor::Extensions::Preprocessor
-        BLOCK_START_REGEXP = /\{(.+?)\.\*,(.+),(.+)\}/.freeze
-        BLOCK_END_REGEXP = /\A\{[A-Z]+\}\z/.freeze
-        MARCO_REGEXP = /\[datamodel_diagram,([^,]+),?(.+)?\]/.freeze
-        TEMPLATES_PATH = File.expand_path("../views/datamodel", __dir__).freeze
-        # search document for block `datamodel_diagram`
-        #  read include derectives that goes after that in block and transform
-        #  into plantuml block
-        def process(document, reader)
-          input_lines = reader.lines.to_enum
-          Asciidoctor::PreprocessorReader.new(document, processed_lines(document, input_lines))
-        end
-
-        private
-
-        def processed_lines(document, input_lines)
-          input_lines.each_with_object([]) do |line, result|
-            if match = line.match(MARCO_REGEXP)
-              result
-                .push(*parse_datamodel_marco(match[1], match[2], document))
-            else
-              result.push(line)
-            end
-          end
-        end
-
-        def parse_datamodel_marco(yaml_path, include_path, document)
-          include_path ||= File.join(File.dirname(yaml_path), "..", "models")
-          include_path = yaml_relative_path(include_path, document)
-          yaml_relative_to_doc_path = yaml_relative_path(yaml_path, document)
-          view_hash = YAML.safe_load(File.read(yaml_relative_to_doc_path))
-          plantuml_representations(view_hash,
-                                   yaml_relative_to_doc_path,
-                                   include_path)
-        end
-
-        def yaml_relative_path(file_path, document)
-          docfile = document.attributes["docfile"] || "."
-          docfile_directory = File.dirname(docfile)
-          document.path_resolver.system_path(file_path, docfile_directory)
-        end
-
-        def import_format(include_path, import_name, values)
-          include_content = File.read(File.join(
-                                        include_path,
-                                        "#{import_name}.yml",
-                                      ))
-          content = YAML.safe_load(include_content)
-          if values
-            content["skipSection"] = values["skipSection"]
-          end
-          content
-        end
-
-        def format_import_directives(imports, include_path)
-          imports
-            .each_with_object({}) do |(import_name, values), res|
-              full_model_name = import_name.split("/").join
-              content = import_format(include_path, import_name, values)
-              res[content["name"] || full_model_name] = content
-            end.compact
-        end
-
-        def prepare_view_hash(view_hash, all_imports)
-          view_hash.merge!(
-            "classes" => model_type(all_imports, "class"),
-            "enums" => model_type(all_imports, "enum"),
-            "relations" => view_hash["relations"] || [],
-            "fidelity" => (view_hash["fidelity"] || {})
-                          .merge!("classes" => model_type(all_imports,
-                                                          "class")),
-          )
-        end
-
-        def model_type(imports, type)
-          imports
-            .select do |_name, elem|
-              elem["modelType"] == type
-            end
-        end
-
-        def plantuml_representations(view_hash, view_path, include_path)
-          yaml_directory = File.dirname(view_path)
-          all_imports = format_import_directives(view_hash["imports"],
-                                                 include_path)
-          prepare_view_hash(view_hash, all_imports)
-          Metanorma::Datamodel::PlantumlRenderer
-            .new(view_hash, File.join(yaml_directory, ".."))
-            .render
-            .split("\n")
-        end
-      end
-    end
-  end
-end