metanorma-cli 1.3.1 → 1.3.5

data/README.adoc

@@ -41,6 +41,37 @@ for advanced details regarding dependencies and Windows installation notes.
 
 == Usage
 
+=== Setting up
+
+Metanorma CLI helps you install necessary fonts used by particular flavors,
+as long as those fonts have a license that allow you to install them.
+
+For example, ISO relies on Cambria while ITU relies on Arial, which are both not
+supplied by default on Linux. Due to licensing terms, you are allowed to
+install them yourself.
+
+By running the `metanorma setup` command, Metanorma will identify fonts not
+available on your system, and helps you install them once you agree to
+the license terms presented by those fonts.
+
+Typically run the command below.
+
+[source, sh]
+----
+metanorma setup
+----
+
+If you are sure you want to agree with all the font licensing terms,
+such as during non-interactive runs for continuous integration,
+you can explicitly agree to all terms using the `--agree-to-terms`
+option.
+
+[source, sh]
+----
+metanorma setup --agree-to-terms
+----
+
+
 === Generate a new Metanorma document using a template  (`metanorma new`)
 
 Metanorma CLI allows you to create a new document using an official

data/docs/installation.adoc

@@ -0,0 +1,61 @@
+= Installation
+
+You can get the `metanorma` command-line executable by installing this Ruby gem.
+
+[IMPORTANT]
+====
+To install the Metanorma toolchain we recommend to use one of the ways described in
+https://www.metanorma.com/author/topics/install/[Metanorma installation] topic.
+Installing this gem by hand may not be the easiest way.
+
+When following this installation method, to start building documents you may have to take care
+of manually installing some required third-party software as well.
+Which exactly depends on what documents you’re building, below notes cover some of that.
+====
+
+
+== Installing the Metanorma CLI gem
+
+[source,console]
+----
+gem install metanorma-cli
+----
+
+Installing the gem will also install all officially supported Metanorma flavors
+(such as ISO, CalConnect, IETF, etc).
+
+
+== Dependencies
+
+=== Java
+
+You will have to have a Java runtime installed. (Use `brew cask install java` on macOS.)
+
+=== Puppeteer
+
+*If you are going to generate PDFs from HTML* (which applies to CalConnect Standard Documents),
+you will also need to install the https://github.com/GoogleChrome/puppeteer[Puppeteer] Node library.
+
+* Ensure you have Node of at least version 7.6.0:
+** https://nodejs.org/en/download/
+** On macOS you should be able to `brew install node`
+* Ensure you have NPM: https://docs.npmjs.com/getting-started/installing-node
+* Install Puppeteer globally in your system: `npm install -g --save --save-exact puppeteer`
+
+=== PlantUML
+
+*If your documents include link:/author/topics/document-format/diagrams/[PlantUML diagrams]*,
+PlantUML will have to be installed.
+
+* `brew install plantuml` on MacOS.
+* For Linux, link the PlantUML jar file into a command line executable; see
+`.travis.yml` for an example.
+
+If PlantUML is not installed locally, the source PlantUML is incorporated into
+the output document as sourcecode.
+
+
+== Installation notes for Windows
+
+To be able to compile gem with a native extension you must have `RIDK` installed.
+If you are installing metanorma with chocolatey installation script will do this for you

data/docs/navigation.adoc

@@ -0,0 +1,7 @@
+---
+items:
+  - { title: Installation, path: installation/ }
+  - { title: Usage, path: usage/ }
+---
+
+= Navigation

data/docs/usage.adoc

@@ -0,0 +1,74 @@
+= Using the Metanorma CLI
+
+== Usage sample
+
+[source,sh]
+----
+$ metanorma --type iso -x html iso-my-standard-document.adoc
+----
+
+== Full syntax & options
+
+[source,sh]
+----
+$ metanorma --type <chosen-type> \
+  [--format input-format] \
+  [--extensions EXT1,EXT2...] \
+  iso-my-standard-document.adoc
+----
+
+`type`:: (mandatory, specified via `--type` or `-t`) takes one of the following types:
+`rfc2`, `rfc3`, `iso`, `gb`, `csd`, `csand`, `m3d`, `rsd`. Each of these corresponds to a
+standards class and a Metanorma gem; the list of standards classes supported by the script
+by default will grow (see also `require`).
+
+`extension`:: (optional) specifies the output formats to be generated. If not specified,
+all possible output formats are generated. The output formats generated are constrained by
+what has been defined for each standard type. All standards can generate Metanorma XML (`xml`),
+and at least one of HTML (`html`), DOC (`doc`), PDF (`pdf`). Some standards generate alternative
+HTML renderings (e.g. `html_alt` for ISO).
+
+`wrapper`:: create a separate folder for each instance of HTML output generated; the folder is named
+the same as the output file, without the `.html` suffix. Used to make distribution of HTML outputs
+more straightforward.
+
+`format`:: (optional, defaults to `asciidoc`, specified via `--format` or `-f`) only accepts `asciidoc` for now
+
+`require`:: If you wish to use metanorma with a document class which has not been included in the types recognised
+by the metanorma script, you will need to name the corresponding Metnorma gem explicitly with the `-r`
+option. For example:
+
+[source,sh]
+----
+$ metanorma -t mpfd mpfd-bpn.adoc
+
+[metanorma] Error: mpfd is not a supported standard type.
+
+$ metanorma -t mpfd -r metanorma-mpfd mpfd-bpn.adoc
+----
+
+== Command-line help
+
+[source,sh]
+----
+$ metanorma -h
+Usage: metanorma [options] <file>
+  -t, --type TYPE                       Type of standard to generate: rfc2, rfc3, iso, gb, csd, csand, m3d
+  -x, --extensions EXT1,EXT2,... | all  Type of extension to generate per type:
+  {
+    :rfc2=>{:xmlrfc=>"v2.xml"},
+    :rfc3=>{:xmlrfc=>"v3.xml"},
+    :iso=>{:html=>"html", :html_alt=>"alt.html", :doc=>"doc"},
+    :gb=>{:html=>"html", :doc=>"doc"},
+    :csd=>{:html=>"html", :pdf=>"pdf"},
+    :csand=>{:html=>"html"},
+    :m3d=>{:html=>"html", :doc=>"doc"},
+    :rsd=>{:html=>"html"}
+  }
+  In addition, xml (outside of rfc2, rfc3) generates IsoDoc XML. If the argument is "all" or the option is
+  missing, all available extensions are generated.
+  -f, --format FORMAT              Format of source file: asciidoc (current default, only format supported)
+  -r, --require LIBRARY            Require LIBRARY prior to execution
+  -w, --wrapper                    Create wrapper folder for HTML output
+  -h, --help                       Show this message
+----

data/lib/metanorma/cli/command.rb

@@ -29,6 +29,7 @@ module Metanorma
       option :relaton, aliases: "-R", desc: "Export Relaton XML for document to nominated filename"
       option :extract, aliases: "-e", desc: "Export sourcecode fragments from this document to nominated directory"
       option :version, aliases: "-v", desc: "Print version of code (accompanied with -t)"
+      option "output-dir", aliases: "-o", desc: "Directory to save compiled files"
 
       def compile(file_name = nil)
         if file_name && !options[:version]
@@ -53,6 +54,7 @@ module Metanorma
       option :format, aliases: "-f", default: :asciidoc, desc: "Format of source file: eg. asciidoc"
 
       def version
+        Metanorma::Cli.load_flavors
         backend_version(options[:type]) || supported_backends
       rescue NameError => error
         UI.say(error)
@@ -119,7 +121,7 @@ module Metanorma
       end
 
       def find_backend(type)
-        require "metanorma-#{type}"
+        load_flavours(type)
         Metanorma::Registry.instance.find_processor(type&.to_sym)
       end
 
@@ -160,6 +162,13 @@ module Metanorma
           end
         end.compact.flatten.uniq
       end
+
+      def load_flavours(type)
+        Metanorma::Cli.load_flavors
+        unless Metanorma::Registry.instance.find_processor(type&.to_sym)
+          require "metanorma-#{type}"
+        end
+      end
     end
   end
 end

data/lib/metanorma/cli/setup.rb

@@ -69,19 +69,24 @@ module Metanorma
 
       def message(license)
         <<~MSG
-        Metanorma has detected that you do not have the necessary fonts installed
-        for PDF generation. The generated PDF will use generic fonts that may not
-        resemble the desired styling. Metanorma can download these files for you
-        if you accept the font licensing conditions for the font #{font_name}.
+          FONT LICENSE ACCEPTANCE REQUIRED:
 
-        ----------
+          Metanorma has detected that you do not have the necessary fonts installed
+          for PDF generation. Without those fonts, the generated PDF will use
+          generic fonts that may not resemble the desired styling.
 
-        #{license}
+          Metanorma can download these files for you if you accept the font
+          licensing conditions for the font "#{font_name}".
 
-        ----------
+          FONT LICENSE BEGIN ("#{font_name}")
+          -----------------------------------------------------------------------
+          #{license}
+          -----------------------------------------------------------------------
+          FONT LICENSE END ("#{font_name}")
 
-        If you want Metanorma to download these fonts for you and indicate your
-        acceptance of the font licenses, type "Yes" / "No":
+          Do you accept all presented font licenses, and want Metanorma to
+          download these fonts for you?
+          => TYPE "Yes" or "No":
         MSG
       end
     end

data/lib/metanorma/cli/version.rb

@@ -1,5 +1,5 @@
 module Metanorma
   module Cli
-    VERSION = "1.3.1"
+    VERSION = "1.3.5"
   end
 end

data/metanorma-cli.gemspec

@@ -14,8 +14,14 @@ Gem::Specification.new do |spec|
   spec.homepage      = "https://www.metanorma.com"
   spec.license       = "BSD-2-Clause"
 
+=begin
   spec.files         = Dir['**/*'].reject { |f| f.match(%r{^(test|spec|features|templates|.git)/|.(gem|gif|png|jpg|jpeg|xml|html|doc|pdf|dtd|ent)$}) }
   spec.files        += Dir.glob("templates/base/**", File::FNM_DOTMATCH).reject { |f| File.directory?(f) }
+=end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
 
   spec.extra_rdoc_files = %w[README.adoc LICENSE]
   spec.bindir        = "exe"
@@ -31,27 +37,27 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "equivalent-xml", "~> 0.6"
   spec.add_development_dependency "rspec-core", "~> 3.4"
 
-  spec.add_runtime_dependency "thor", "~> 0.20.3"
-  spec.add_runtime_dependency "metanorma-iso", "~> 1.4.0"
-  spec.add_runtime_dependency 'metanorma-ietf', "~> 2.1.0"
-  spec.add_runtime_dependency 'metanorma-gb', "~> 1.4.0"
-  spec.add_runtime_dependency 'metanorma-iec', "~> 1.1.0"
-  spec.add_runtime_dependency 'metanorma-cc', "~> 1.4.0"
-  spec.add_runtime_dependency 'metanorma-csa', "~> 1.5.0"
-  #spec.add_runtime_dependency 'metanorma-ribose', "~> 1.5.0"
-  spec.add_runtime_dependency 'metanorma-m3aawg', "~> 1.4.0"
-  spec.add_runtime_dependency 'metanorma-generic', "~> 1.5.0"
-  spec.add_runtime_dependency 'metanorma-standoc', "~> 1.4.0"
-  #spec.add_runtime_dependency 'metanorma-mpfa', "~> 0.4.0"
-  spec.add_runtime_dependency 'metanorma-un', "~> 0.4.0"
-  spec.add_runtime_dependency 'metanorma-ogc', "~> 1.1.0"
-  spec.add_runtime_dependency 'metanorma-nist', "~> 1.1.0"
-  spec.add_runtime_dependency 'metanorma-itu', "~> 1.1.0"
-  spec.add_runtime_dependency 'metanorma-iho', "~> 0.1.0"
-  spec.add_runtime_dependency 'isodoc', "~> 1.1.0"
+  spec.add_runtime_dependency "thor", "~> 1.0"
+  spec.add_runtime_dependency "metanorma-iso", "~> 1.5.0"
+  spec.add_runtime_dependency 'metanorma-ietf', "~> 2.2.0"
+  spec.add_runtime_dependency 'metanorma-gb', "~> 1.5.0"
+  spec.add_runtime_dependency 'metanorma-iec', "~> 1.2.0"
+  spec.add_runtime_dependency 'metanorma-cc', "~> 1.5.0"
+  spec.add_runtime_dependency 'metanorma-csa', "~> 1.6.0"
+  #spec.add_runtime_dependency 'metanorma-ribose', "~> 1.6.0"
+  spec.add_runtime_dependency 'metanorma-m3aawg', "~> 1.5.0"
+  spec.add_runtime_dependency 'metanorma-generic', "~> 1.6.0"
+  spec.add_runtime_dependency 'metanorma-standoc', "~> 1.5.0"
+  #spec.add_runtime_dependency 'metanorma-mpfa', "~> 0.5.0"
+  spec.add_runtime_dependency 'metanorma-un', "~> 0.5.0"
+  spec.add_runtime_dependency 'metanorma-ogc', "~> 1.2.0"
+  spec.add_runtime_dependency 'metanorma-nist', "~> 1.2.0"
+  spec.add_runtime_dependency 'metanorma-itu', "~> 1.2.0"
+  spec.add_runtime_dependency 'metanorma-iho', "~> 0.2.0"
+  spec.add_runtime_dependency 'isodoc', "~> 1.2.0"
   spec.add_runtime_dependency 'metanorma', "~> 1.1.0"
   #spec.add_runtime_dependency 'nokogiri', ">= 1"
   spec.add_runtime_dependency "git", "~> 1.5"
   spec.add_runtime_dependency "relaton-cli", ">= 0.8.2"
-  spec.add_runtime_dependency "fontist", "~> 1.0.0"
+  spec.add_runtime_dependency "fontist", "~> 1.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: metanorma-cli
 version: !ruby/object:Gem::Version
-  version: 1.3.1
+  version: 1.3.5
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-06-28 00:00:00.000000000 Z
+date: 2020-08-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pry
@@ -114,224 +114,224 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.20.3
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.20.3
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: metanorma-iso
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.4.0
+        version: 1.5.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.4.0
+        version: 1.5.0
 - !ruby/object:Gem::Dependency
   name: metanorma-ietf
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.1.0
+        version: 2.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.1.0
+        version: 2.2.0
 - !ruby/object:Gem::Dependency
   name: metanorma-gb
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.4.0
+        version: 1.5.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.4.0
+        version: 1.5.0
 - !ruby/object:Gem::Dependency
   name: metanorma-iec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.1.0
+        version: 1.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.1.0
+        version: 1.2.0
 - !ruby/object:Gem::Dependency
   name: metanorma-cc
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.4.0
+        version: 1.5.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.4.0
+        version: 1.5.0
 - !ruby/object:Gem::Dependency
   name: metanorma-csa
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.5.0
+        version: 1.6.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.5.0
+        version: 1.6.0
 - !ruby/object:Gem::Dependency
   name: metanorma-m3aawg
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.4.0
+        version: 1.5.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.4.0
+        version: 1.5.0
 - !ruby/object:Gem::Dependency
   name: metanorma-generic
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.5.0
+        version: 1.6.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.5.0
+        version: 1.6.0
 - !ruby/object:Gem::Dependency
   name: metanorma-standoc
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.4.0
+        version: 1.5.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.4.0
+        version: 1.5.0
 - !ruby/object:Gem::Dependency
   name: metanorma-un
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.5.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.5.0
 - !ruby/object:Gem::Dependency
   name: metanorma-ogc
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.1.0
+        version: 1.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.1.0
+        version: 1.2.0
 - !ruby/object:Gem::Dependency
   name: metanorma-nist
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.1.0
+        version: 1.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.1.0
+        version: 1.2.0
 - !ruby/object:Gem::Dependency
   name: metanorma-itu
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.1.0
+        version: 1.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.1.0
+        version: 1.2.0
 - !ruby/object:Gem::Dependency
   name: metanorma-iho
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.0
+        version: 0.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.0
+        version: 0.2.0
 - !ruby/object:Gem::Dependency
   name: isodoc
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.1.0
+        version: 1.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.1.0
+        version: 1.2.0
 - !ruby/object:Gem::Dependency
   name: metanorma
   requirement: !ruby/object:Gem::Requirement
@@ -380,49 +380,46 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0
+        version: '1.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0
+        version: '1.2'
 description: Executable to process any Metanorma standard.
 email:
 - open.source@ribose.com
 executables:
 - metanorma
 - metanorma-manifest
-- metanorma.old
 extensions: []
 extra_rdoc_files:
 - README.adoc
 - LICENSE
 files:
-- 05-020r26.rxl
-- 05-020r26.xml.zip
+- ".github/workflows/dependent_repos.env"
+- ".github/workflows/macos.yml"
+- ".github/workflows/ubuntu.yml"
+- ".github/workflows/windows.yml"
+- ".gitignore"
+- ".hound.yml"
+- ".rspec"
+- ".rubocop.yml"
 - CODE_OF_CONDUCT.md
 - Gemfile
-- Gemfile.lock
 - LICENSE
 - README.adoc
 - Rakefile
-- a
-- a.json
-- a.rb
-- a.rxl
-- b
 - bin/console
 - bin/rspec
 - bin/setup
-- csd-tofix 2.zip
-- csd-tofix.zip
+- docs/installation.adoc
+- docs/navigation.adoc
+- docs/usage.adoc
 - exe/metanorma
 - exe/metanorma-manifest
-- exe/metanorma.old
-- extract/sourcecode/sourcecode-0000.txt
-- files.zip
 - i18n.yaml
 - lib/metanorma-cli.rb
 - lib/metanorma/cli.rb
@@ -437,9 +434,6 @@ files:
 - lib/metanorma/cli/ui.rb
 - lib/metanorma/cli/version.rb
 - metanorma-cli.gemspec
-- relaton/cache/version
-- rice.rxl
-- sourcecode/0
 - templates/base/.gitignore
 - templates/base/.gitlab-ci.yml
 - templates/base/.travis.yml
@@ -448,22 +442,6 @@ files:
 - templates/base/Makefile.win
 - templates/base/appveyor.yml
 - templates/base/metanorma.yml
-- test.rxl
-- tmp/my-custom-csd/Gemfile
-- tmp/my-custom-csd/Makefile
-- tmp/my-custom-csd/Makefile.win
-- tmp/my-custom-csd/appveyor.yml
-- tmp/my-custom-csd/metanorma.yml
-- tmp/my-document/Gemfile
-- tmp/my-document/Makefile
-- tmp/my-document/Makefile.win
-- tmp/my-document/appveyor.yml
-- tmp/my-document/metanorma.yml
-- tmp/my-local-document/Gemfile
-- tmp/my-local-document/Makefile
-- tmp/my-local-document/Makefile.win
-- tmp/my-local-document/appveyor.yml
-- tmp/my-local-document/metanorma.yml
 homepage: https://www.metanorma.com
 licenses:
 - BSD-2-Clause