metanorma-nist 1.2.5 → 1.2.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a69082cb58bde5a1305caea0316414723f519a71c550efe43ac3e894f028436
-  data.tar.gz: 73b99485a31a90a15e6936d688fc4c677a2d948e95bc1896d822d7b02cda37f6
+  metadata.gz: 36ac09c63540d7f54f30b736c97745c39540395609ccc8ec87633b598c22fb1d
+  data.tar.gz: 5ea3cbb59d1771302c79eddc3bde4c59143c48e3bc4ed21849f5a76eb770004a
 SHA512:
-  metadata.gz: 59de2efb8bb15621e6479ba749b94228d0c61b0b244da02a6c95dc63668797c890090c49abe386a913ef096664b771a42e99b53d39ed698d4d30e45b2e324393
-  data.tar.gz: 108786af3a06da4539acb195f2d42c21b66fb0d7b05543ed800202c117a98531c1cd83ec1f31f3a8249ef7429458407c7d7991fc41052cb3c522ed47762d9afd
+  metadata.gz: d3922390af3fe4aba54d16c0fa110adfbeb1e037f553244c645f6c403daaec8c3eb7e3db3da5fa18f2b8f558c20eb8a11af67ed7ad9fba46f017a45a524cf9c9
+  data.tar.gz: 1cc37283a2d664adabfce277a46c5024a97d201a132a46f6fe2a5aa3134a18529a2efc5d56f506252676f07496931310b7e15673bebb20d9a25f919318ee6403

data/.github/workflows/rake.yml

@@ -0,0 +1,62 @@
+# Auto-generated by Cimas: Do not edit it manually!
+# See https://github.com/metanorma/cimas
+name: rake
+
+on:
+  push:
+    branches: [ master, main  ]
+    tags: [ v* ]
+  pull_request:
+
+jobs:
+  rake:
+    name: Test on Ruby ${{ matrix.ruby }} ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    continue-on-error: ${{ matrix.experimental }}
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: [ '2.6', '2.5', '2.4' ]
+        os: [ ubuntu-latest, windows-latest, macos-latest ]
+        experimental: [ false ]
+        include:
+          - ruby: '2.7'
+            os: 'ubuntu-latest'
+            experimental: true
+          - ruby: '2.7'
+            os: 'windows-latest'
+            experimental: true
+          - ruby: '2.7'
+            os: 'macos-latest'
+            experimental: true
+    steps:
+      - uses: actions/checkout@master
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+
+      - uses: actions/cache@v2
+        with:
+          path: vendor/bundle
+          key: bundle-${{ matrix.os }}-${{ matrix.ruby }}-${{ hashFiles('**/*.gemspec') }}
+          restore-keys: bundle-${{ matrix.os }}-${{ matrix.ruby }}
+
+      - run: bundle config set path 'vendor/bundle'
+
+      - run: bundle install --jobs 4 --retry 3
+
+      - run: bundle exec rake
+
+  tests-passed:
+    needs: rake
+    runs-on: ubuntu-latest
+    steps:
+      - name: Trigger tests passed event
+        uses: Sibz/github-status-action@v1
+        with:
+          authToken: ${{ secrets.METANORMA_CI_PAT_TOKEN || secrets.GITHUB_TOKEN }}
+          context: 'tests-passed-successfully'
+          description: 'Tests passed successfully'
+          state: 'success'
+          sha: ${{ github.event.pull_request.head.sha || github.sha }}

data/.github/workflows/release.yml

@@ -0,0 +1,36 @@
+name: release
+
+on:
+  push:
+    tags:
+      - '*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v1
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '2.6'
+
+      - uses: actions/cache@v1
+        with:
+          path: vendor/bundle
+          restore-keys: bundle-ubuntu-latest-2.6
+
+      - run: bundle exec rake
+
+      - name: publish
+        env:
+          GITHUB_PACKAGES_TOKEN: ${{ secrets.METANORMA_CI_PAT_TOKEN }}
+        run: |
+          cat << 'EOF' > ~/.gem/credentials
+          ---
+          :github: Bearer ${GITHUB_PACKAGES_TOKEN}
+          EOF
+          chmod 0600 ~/.gem/credentials
+          gem install gem-release
+          gem release --key github --host https://rubygems.pkg.github.com/metanorma
+

data/README.adoc

@@ -1,16 +1,15 @@
 = metanorma-nist: Metanorma processor for the NIST SP 800 document classes
 
 image:https://img.shields.io/gem/v/metanorma-nist.svg["Gem Version", link="https://rubygems.org/gems/metanorma-nist"]
-image:https://github.com/metanorma/metanorma-nist/workflows/macos/badge.svg["Build Status (macOS)", link="https://github.com/metanorma/metanorma-nist/actions?workflow=macos"]
-image:https://github.com/metanorma/metanorma-nist/workflows/ubuntu/badge.svg["Build Status (ubuntu)", link="https://github.com/metanorma/metanorma-nist/actions?workflow=ubuntu"]
-image:https://github.com/metanorma/metanorma-nist/workflows/windows/badge.svg["Build Status (Windows)", link="https://github.com/metanorma/metanorma-nist/actions?workflow=windows"]
+image:https://github.com/metanorma/metanorma-nist/workflows/rake/badge.svg["Build Status", link="https://github.com/metanorma/metanorma-nist/actions?workflow=rake"]
 image:https://codeclimate.com/github/metanorma/metanorma-nist/badges/gpa.svg["Code Climate", link="https://codeclimate.com/github/metanorma/metanorma-nist"]
 image:https://img.shields.io/github/issues-pr-raw/metanorma/metanorma-nist.svg["Pull Requests", link="https://github.com/metanorma/metanorma-nist/pulls"]
 image:https://img.shields.io/github/commits-since/metanorma/metanorma-nist/latest.svg["Commits since latest",link="https://github.com/metanorma/metanorma-nist/releases"]
 
 == Functionality
 
-This gem processes Metanorma documents into the NIST document class.
+This gem processes https://www.metanorma.com[Metanorma documents] following
+a template for generating NIST standards.
 
 It provides the following functions:
 
@@ -300,7 +299,7 @@ Can be a number, or text (e.g. "initial", "final").
 `:series:`:: The publication series that the document belongs to. Legal values are:
 +
 --
-* nist-ams
+*  nist-ams
 *  building-science
 *  nist-fips
 *  nist-gcr
@@ -322,11 +321,28 @@ Can be a number, or text (e.g. "initial", "final").
 *  csrc-use-case
 *  csrc-building-block
 *  nist-cswp
+*  nist-csts
 --
 
 Documents belonging to different series are expected to be rendered differently. As of this
-writing, styling has been provided for `nist-cswp` (Cybersecurity White Papers) and for 
-`nist-sp` (SP-800).
+writing, styling has been provided for `nist-cswp` (Cybersecurity White Papers),
+`nist-csts` (Cybersecurity Technical Specifications, added in v1.2.10), and for `nist-sp` (SP-800).
+
+`:series-title:`:: (Added in v1.2.10) 
+`:series-mrprefix:`:: (Added in v1.2.10) 
+`:series-abbrev:`:: (Added in v1.2.10) The formal documents published by NIST belong to a registered
+list of series, each with a predefined title and abbreviation. Non-formal documents instead belong
+to ad hoc series defined for the purposes of Metanorma, such as `nist-csts`. That particular series
+acts as an umbrella for user-defined series of publications; so when it is used, the user needs to provide
+a title (e.g. "Automated Cryptographic Validation Protocol") and abbreviation (e.g. ACVP) for the user-defined
+series. The user also needs to provide the prefix by which the series will be identified in the machine-readable
+NIST identifier, when it is at variance with the abbreviation.
++
+--
+In this case, CSTS is retained as the primary series of the publication (and all CSTS documents
+are rendered the same way), and ACVP is modelled as a secondary series specific to CSTS. However,
+the series information rendered for the document involves the user-defined series, not CSTS itself.
+--
 
 `:comment-from:`:: The beginning of the period during which comments may be submitted to the NIST
 document draft. ISO-8601 date.

data/lib/asciidoctor/nist/basicdoc.rng

@@ -596,6 +596,7 @@
       <ref name="bookmark"/>
       <ref name="image"/>
       <ref name="index"/>
+      <ref name="index-xref"/>
     </choice>
   </define>
   <define name="PureTextElement">
@@ -728,15 +729,61 @@
   </define>
   <define name="index">
     <element name="index">
-      <attribute name="primary"/>
+      <attribute name="to">
+        <data type="IDREF"/>
+      </attribute>
+      <element name="primary">
+        <oneOrMore>
+          <ref name="PureTextElement"/>
+        </oneOrMore>
+      </element>
       <optional>
-        <attribute name="secondary"/>
+        <element name="secondary">
+          <oneOrMore>
+            <ref name="PureTextElement"/>
+          </oneOrMore>
+        </element>
       </optional>
       <optional>
-        <attribute name="tertiary"/>
+        <element name="tertiary">
+          <oneOrMore>
+            <ref name="PureTextElement"/>
+          </oneOrMore>
+        </element>
       </optional>
     </element>
   </define>
+  <define name="index-xref">
+    <element name="index-xref">
+      <attribute name="also">
+        <data type="boolean"/>
+      </attribute>
+      <element name="primary">
+        <oneOrMore>
+          <ref name="PureTextElement"/>
+        </oneOrMore>
+      </element>
+      <optional>
+        <element name="secondary">
+          <oneOrMore>
+            <ref name="PureTextElement"/>
+          </oneOrMore>
+        </element>
+      </optional>
+      <optional>
+        <element name="tertiary">
+          <oneOrMore>
+            <ref name="PureTextElement"/>
+          </oneOrMore>
+        </element>
+      </optional>
+      <element name="target">
+        <oneOrMore>
+          <ref name="PureTextElement"/>
+        </oneOrMore>
+      </element>
+    </element>
+  </define>
   <!-- bare ID element, used for referencing arbitrary spans of text -->
   <define name="bookmark">
     <element name="bookmark">

data/lib/asciidoctor/nist/boilerplate.rb

@@ -24,6 +24,7 @@ module Asciidoctor
         "csrc-use-case": "CSRC Use Case",
         "csrc-building-block": "CSRC Building Block",
         "nist-cswp": "NIST Cybersecurity White Paper",
+        "nist-csts": "NIST Cybersecurity Technical Specification",
       }.freeze
 
       SERIES_ABBR = {
@@ -49,6 +50,7 @@ module Asciidoctor
         "csrc-use-case": "CSRC Use Case",
         "csrc-building-block": "CSRC Building Block",
         "nist-cswp": "NIST CSWP",
+        "nist-csts": "NIST CSTS",
       }.freeze
 
       CALL_FOR_PATENT_CLAIMS = <<~END.freeze
@@ -100,7 +102,7 @@ module Asciidoctor
       end
 
       def boilerplate_file(xmldoc)
-        File.join(@libdir, @series == "nist-cswp" ? "nist_intro_cswp.xml" : "nist_intro.xml")
+        File.join(@libdir, @cswp ? "nist_intro_cswp.xml" : "nist_intro.xml")
       end
     end
   end

data/lib/asciidoctor/nist/cleanup.rb

@@ -44,6 +44,7 @@ module Asciidoctor
       end
 
       def move_clauses_into_preface1(x, preface)
+        x.xpath("//acknowledgements[@preface]").each { |c| c.delete("preface") }
         x.xpath("//clause[@preface]").each do |c|
           c.delete("preface")
           title = c&.at("./title")&.text.downcase
@@ -71,7 +72,7 @@ module Asciidoctor
       end
 
       def callforpatentclaims(x, preface)
-        return if @series == "nist-cswp"
+        return if @cswp
         if @callforpatentclaims
           docemail = x&.at("//uri[@type = 'email']")&.text || "???"
           docnumber = x&.at("//docnumber")&.text || "???"

data/lib/asciidoctor/nist/converter.rb

@@ -103,6 +103,7 @@ module Asciidoctor
         @nistdivisionaddress = node.attr("nist-division-address") ||
           "100 Bureau Drive (Mail Stop 8930) Gaithersburg, MD 20899-8930"
         @series = node.attr("series")
+        @cswp = %w(nist-cswp nist-csts).include?(@series)
         super
       end
 
@@ -151,6 +152,8 @@ module Asciidoctor
           "terms and definitions"
         when "introduction"
           "donotrecognise_introduction"
+        when "normative references"
+          "bibliography"
         else
           super
         end

data/lib/asciidoctor/nist/front.rb

@@ -29,8 +29,7 @@ module Asciidoctor
         t.title(**attr_code(at.merge(type: "subtitle"))) do |t1|
           t1 << asciidoc_sub(node.attr("title-sub"))
         end
-        node.attr("title-sub-short") and
-          t.title(**attr_code(at.merge(type: "short-subtitle"))) do |t1|
+        node.attr("title-sub-short") and t.title(**attr_code(at.merge(type: "short-subtitle"))) do |t1|
           t1 << asciidoc_sub(node.attr("title-sub-short"))
         end
       end
@@ -46,8 +45,7 @@ module Asciidoctor
         t.title(**attr_code(at.merge(type: "main"))) do |t1|
           t1 << (asciidoc_sub(node.attr("title-main")) || node.title)
         end
-        node.attr("title-main-short") and
-          t.title(**attr_code(at.merge(type: "short-title"))) do |t1|
+        node.attr("title-main-short") and t.title(**attr_code(at.merge(type: "short-title"))) do |t1|
           t1 << asciidoc_sub(node.attr("title-main-short"))
         end
       end
@@ -85,21 +83,16 @@ module Asciidoctor
       end
 
       def metadata_committee(node, xml)
-        return unless node.attr("technical-committee") ||
-          node.attr("subcommittee") ||
+        return unless node.attr("technical-committee") || node.attr("subcommittee") ||
           node.attr("workgroup") || node.attr("workinggroup")
         xml.editorialgroup do |a|
-          node.attr("technical-committee") and
-            a.committee(node.attr("technical-committee"))
-          node.attr("subcommittee") and
-            a.subcommittee(
-              node.attr("subcommittee"),
-              **attr_code(type: node.attr("subcommittee-type"),
-                          number: node.attr("subcommittee-number")))
-          (node.attr("workgroup") || node.attr("workinggroup")) and
-            a.workgroup(node.attr("workgroup") || node.attr("workinggroup"),
-                        **attr_code(type: node.attr("workgroup-type"),
-                                    number: node.attr("workgroup-number")))
+          c = node.attr("technical-committee") and a.committee(c)
+          c = node.attr("subcommittee") and
+            a.subcommittee(c, **attr_code(type: node.attr("subcommittee-type"),
+                                          number: node.attr("subcommittee-number")))
+          c = (node.attr("workgroup") || node.attr("workinggroup")) and
+            a.workgroup(c,
+                        **attr_code(type: node.attr("workgroup-type"), number: node.attr("workgroup-number")))
         end
       end
 
@@ -114,16 +107,26 @@ module Asciidoctor
 
       def metadata_source(node, xml)
         super
-        node.attr("doc-email") && xml.uri(node.attr("doc-email"), type: "email")
-        node.attr("doi") && xml.uri(node.attr("doi"), type: "doi")
+        node.attr("doc-email") and xml.uri(node.attr("doc-email"), type: "email")
+        node.attr("doi") and xml.uri(node.attr("doi"), type: "doi")
       end
 
       def metadata_series(node, xml)
         series = node.attr("series") || "nist-sp"
         series and xml.series **{ type: "main" } do |s|
           s.title (SERIES.dig(series.to_sym) || series)
-          SERIES_ABBR.dig(series.to_sym) and
-            s.abbreviation SERIES_ABBR.dig(series.to_sym)
+          SERIES_ABBR.dig(series.to_sym) and s.abbreviation SERIES_ABBR.dig(series.to_sym)
+        end
+        metadata_subseries(node, xml)
+      end
+
+      def metadata_subseries(node, xml)
+        title = node.attr("series-title")
+        abbrev = node.attr("series-abbrev")
+        return unless (title || abbrev)
+        xml.series **{ type: "secondary" } do |s|
+          title and s.title title
+          abbrev and s.abbreviation abbrev
         end
       end
 
@@ -143,13 +146,11 @@ module Asciidoctor
       end
 
       def relaton_relation_descriptions
-        super.merge({ "supersedes" => "obsoletes",
-                      "superseded-by" => "obsoleted-by", })
+        super.merge({ "supersedes" => "obsoletes", "superseded-by" => "obsoleted-by", })
       end
 
       def metadata_getrelation(node, xml, type, desc = nil)
-        if type == "obsoleted-by" and desc.nil? and 
-            node.attr("superseding-status")
+        if type == "obsoleted-by" and desc.nil? and node.attr("superseding-status")
           metadata_superseding_doc(node, xml)
         end
         super
@@ -166,29 +167,24 @@ module Asciidoctor
             metadata_superseding_dates(b, node)
             b.status do |s|
               s.stage node.attr("superseding-status")
-              iter = node.attr("superseding-iteration") and
-                s.iteration iter
+              iter = node.attr("superseding-iteration") and s.iteration iter
             end
           end
         end
       end
 
       def metadata_superseding_ids(b, xml)
-        did = xml&.parent&.at("./ancestor::bibdata/docidentifier"\
-                              "[@type = 'NIST']")&.text
-        didl = xml&.parent&.at("./ancestor::bibdata/docidentifier"\
-                               "[@type = 'nist-long']")&.text
+        did = xml&.parent&.at("./ancestor::bibdata/docidentifier[@type = 'NIST']")&.text
+        didl = xml&.parent&.at("./ancestor::bibdata/docidentifier[@type = 'nist-long']")&.text
         b.docidentifier did, **{ type: "NIST" }
         b.docidentifier didl, **{ type: "nist-long" }
       end
 
       def metadata_superseding_dates(b, node)
-        cdate = node.attr("superseding-circulated-date") and
-          b.date **{ type: "circulated" } do |d|
+        cdate = node.attr("superseding-circulated-date") and b.date **{ type: "circulated" } do |d|
           d.on cdate
         end
-        cdate = node.attr("superseding-issued-date") and
-          b.date **{ type: "issued" } do |d|
+        cdate = node.attr("superseding-issued-date") and b.date **{ type: "issued" } do |d|
           d.on cdate
         end
       end
@@ -198,24 +194,21 @@ module Asciidoctor
           b.title **{ type: "main" } do |t|
             t << asciidoc_sub(node.attr("superseding-title"))
           end
-          node.attr("superseding-subtitle") and
-            b.title **{ type: "subtitle" } do |t|
+          node.attr("superseding-subtitle") and b.title **{ type: "subtitle" } do |t|
             t << asciidoc_sub(node.attr("superseding-subtitle"))
           end
         else
           b.title **{ type: "main" } do |t|
             t << (asciidoc_sub(node.attr("title-main")) || node.title)
           end
-          node.attr("title-sub") and
-            b.title **{ type: "subtitle" } do |t|
+          node.attr("title-sub") and b.title **{ type: "subtitle" } do |t|
             t << asciidoc_sub(node.attr("title-sub"))
           end
         end
       end
 
       def metadata_superseding_authors(b, node)
-        node.attr("superseding-authors") and
-          node.attr("superseding-authors").split(/,\s*/).each do |a|
+        node.attr("superseding-authors") and node.attr("superseding-authors").split(/,\s*/).each do |a|
           b.contributor do |c|
             c.role nil, **{ type: "author" }
             c.person do |p|
@@ -228,10 +221,8 @@ module Asciidoctor
       end
 
       def metadata_note(node, xml)
-        note = node.attr("bib-additional-note") and
-          xml.note note, **{ type: "additional-note" }
-        note = node.attr("bib-withdrawal-note") and
-          xml.note note, **{ type: "withdrawal-note" }
+        note = node.attr("bib-additional-note") and xml.note note, **{ type: "additional-note" }
+        note = node.attr("bib-withdrawal-note") and xml.note note, **{ type: "withdrawal-note" }
         note = node.attr("bib-withdrawal-announcement-link") and
           xml.note note, **{ type: "withdrawal-announcement-link" }
       end