metanorma-standoc 1.3.28 → 1.4.3

data/spec/asciidoctor-standoc/table_spec.rb

@@ -114,7 +114,7 @@ RSpec.describe Asciidoctor::Standoc do
   it "processes complex tables" do
     expect(xmlpp(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true)))).to be_equivalent_to xmlpp(<<~"OUTPUT")
       #{ASCIIDOC_BLANK_HDR}
-      [cols="<,^,^,^,^",options="header,footer",headerrows=2,alt="An extensive summary, and illustration, of tables",subsequence="A",options="unnumbered",summary="This is an extremely long, convoluted summary",width=70%]
+      [cols="<,^,^,^,^",options="header,footer",headerrows=2,alt="An extensive summary, and illustration, of tables",subsequence="A",options="unnumbered",summary="This is an extremely long, convoluted summary",width=70%,number="3",keep-with-next=true,keep-lines-together=true]
       .Maximum _permissible_ mass fraction of defects
       |===
       .2+|Defect 4+^| Maximum permissible mass fraction of defects in husked rice +
@@ -144,13 +144,13 @@ RSpec.describe Asciidoctor::Standoc do
     INPUT
             #{BLANK_HDR}
        <sections>
-         <table id="_" alt="An extensive summary, and illustration, of tables" unnumbered="true" subsequence="A" summary="This is an extremely long, convoluted summary" width="70%">
+         <table id="_" alt="An extensive summary, and illustration, of tables" unnumbered="true" subsequence="A" summary="This is an extremely long, convoluted summary" width="70%" number="3" keep-with-next="true" keep-lines-together="true">
          <name>Maximum <em>permissible</em> mass fraction of defects</name>
          <thead>
            <tr>
              <th rowspan="2" align="left">Defect</th>
              <th colspan="4" align="center">Maximum permissible mass fraction of defects in husked rice<br/>
-             <stem type="MathML"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>w</mi><mi>max</mi></msub></math></stem></th>
+             <stem type="MathML"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>w</mi><mo>max</mo></msub></math></stem></th>
            </tr>
          <tr>
              <th align="left">in husked rice</th>

data/spec/asciidoctor-standoc/validate_spec.rb

@@ -3,6 +3,68 @@ require "relaton_iec"
 require "fileutils"
 
 RSpec.describe Asciidoctor::Standoc do
+  it "generates error file" do
+  FileUtils.rm_f "spec/assets/xref_error.err"
+  Asciidoctor.convert_file "spec/assets/xref_error.adoc", {:attributes=>{"backend"=>"standoc"}, :safe=>0, :header_footer=>true, :requires=>["metanorma-standoc"], :failure_level=>4, :mkdirs=>true, :to_file=>nil}
+  expect(File.exist?("spec/assets/xref_error.err")).to be true
+  end
+
+  it "warns about missing fields in asciibib" do
+  FileUtils.rm_f "test.err"
+  Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true) 
+      #{VALIDATING_BLANK_HDR}
+  
+      [bibliography]
+      == Normative References
+
+      [%bibitem]
+      === Standard
+      id:: iso123
+      type:: standard
+      contributor:: 
+        role::: publisher
+        organization:::
+          name:::: ISO
+      contributor::
+        role::: author
+        person:::
+          name::::
+      +
+      --
+      completename::
+        language::: en
+        content::: Fred
+      --
+      contributor::
+        role::: author
+        person:::
+        name::::
+          completename::::: Jack
+
+    INPUT
+  errf = File.read("test.err")
+  expect(errf).to include "Reference iso123 is missing a document identifier (docid)"
+  end
+
+    it "warns about missing fields in asciibib" do
+  FileUtils.rm_f "test.err"
+  Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true)
+      #{VALIDATING_BLANK_HDR}
+      
+      [bibliography]
+      == Normative References
+
+      [%bibitem]
+      === Standard
+      type:: standard
+      contributor::
+        role::: publisher
+        organization:::
+          name:::: ISO
+INPUT
+  errf = File.read("test.err")
+  expect(errf).to include "The following reference is missing an anchor"
+  end
   it "warns about malformed LaTeX" do
   FileUtils.rm_f "test.err"
   Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true) 
@@ -220,9 +282,11 @@ INPUT
 end
 =end
 
-it "warns if id used twice" do
+it "warns and aborts if id used twice" do
+  FileUtils.rm_f "test.xml"
   FileUtils.rm_f "test.err"
-  Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true)
+  begin
+  expect { Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true) }.to raise_error(SystemExit) 
   = Document title
   Author
   :docfile: test.adoc
@@ -234,7 +298,10 @@ it "warns if id used twice" do
   [[abc]]
   == Clause 2
   INPUT
+  rescue SystemExit
+  end
   expect(File.read("test.err")).to include "Anchor abc has already been used at line"
+  expect(File.exist?("test.xml")).to be false
 end
 
 it "err file succesfully created for docfile path" do
@@ -245,14 +312,17 @@ it "err file succesfully created for docfile path" do
   Author
   :docfile: test#{File::ALT_SEPARATOR || File::SEPARATOR}test.adoc
   :nodoc:
-
-  [[abc]]
+ 
   == Clause 1
 
-  [[abc]]
-  == Clause 2
+  Paragraph
+
+  === Clause 1.1
+
+  Subclause
   INPUT
-  expect(File.read("test/test.err")).to include "Anchor abc has already been used at line"
+
+  expect(File.read("test/test.err")).to include "Hanging paragraph in clause"
 end
 
 end

data/spec/assets/iso123.rxl

@@ -0,0 +1,107 @@
+ <bibdata id='iso123' xmlns='http://www.example.com' type='standard'>
+               <fetched>2020-06-12</fetched>
+               <title type='title-intro' format='text/plain' language='en' script='Latn'>Rubber latex</title>
+               <title type='title-main' format='text/plain' language='en' script='Latn'>Sampling</title>
+               <title type='main' format='text/plain' language='en' script='Latn'>Rubber latex – Sampling</title>
+               <title type='title-intro' format='text/plain' language='fr' script='Latn'>Latex de caoutchouc</title>
+               <title type='title-main' format='text/plain' language='fr' script='Latn'>Échantillonnage</title>
+               <title type='main' format='text/plain' language='fr' script='Latn'>Latex de caoutchouc – Échantillonnage</title>
+               <uri type='src'>https://www.iso.org/standard/23281.html</uri>
+               <uri type='obp'>https://www.iso.org/obp/ui/#!iso:std:23281:en</uri>
+               <uri type='rss'>https://www.iso.org/contents/data/standard/02/32/23281.detail.rss</uri>
+               <docidentifier type='ISO'>ISO 123 (all parts)</docidentifier>
+               <docnumber>123</docnumber>
+               <date type='published'>
+                 <on>2001</on>
+               </date>
+               <contributor>
+                 <role type='publisher'/>
+                 <organization>
+                   <name>International Organization for Standardization</name>
+                   <abbreviation>ISO</abbreviation>
+                   <uri>www.iso.org</uri>
+                 </organization>
+               </contributor>
+               <edition>3</edition>
+               <language>en</language>
+               <language>fr</language>
+               <script>Latn</script>
+               <status>
+                 <stage>90</stage>
+                 <substage>93</substage>
+               </status>
+               <copyright>
+                 <from>2001</from>
+                 <owner>
+                   <organization>
+                     <name>ISO</name>
+                   </organization>
+                 </owner>
+               </copyright>
+               <relation type='obsoletes'>
+                 <bibitem type='standard'>
+                   <formattedref format='text/plain'>ISO 123:1985</formattedref>
+                 </bibitem>
+               </relation>
+               <relation type='instance'>
+                 <bibitem type='standard'>
+                   <fetched>2020-06-12</fetched>
+                   <title type='title-intro' format='text/plain' language='en' script='Latn'>Rubber latex</title>
+                   <title type='title-main' format='text/plain' language='en' script='Latn'>Sampling</title>
+                   <title type='main' format='text/plain' language='en' script='Latn'>Rubber latex – Sampling</title>
+                   <title type='title-intro' format='text/plain' language='fr' script='Latn'>Latex de caoutchouc</title>
+                   <title type='title-main' format='text/plain' language='fr' script='Latn'>Échantillonnage</title>
+                   <title type='main' format='text/plain' language='fr' script='Latn'>Latex de caoutchouc – Échantillonnage</title>
+                   <uri type='src'>https://www.iso.org/standard/23281.html</uri>
+                   <uri type='obp'>https://www.iso.org/obp/ui/#!iso:std:23281:en</uri>
+                   <uri type='rss'>https://www.iso.org/contents/data/standard/02/32/23281.detail.rss</uri>
+                   <docidentifier type='ISO'>ISO 123:2001</docidentifier>
+                   <docnumber>123</docnumber>
+                   <date type='published'>
+                     <on>2001</on>
+                   </date>
+                   <contributor>
+                     <role type='publisher'/>
+                     <organization>
+                       <name>International Organization for Standardization</name>
+                       <abbreviation>ISO</abbreviation>
+                       <uri>www.iso.org</uri>
+                     </organization>
+                   </contributor>
+                   <edition>3</edition>
+                   <language>en</language>
+                   <language>fr</language>
+                   <script>Latn</script>
+                   <status>
+                     <stage>90</stage>
+                     <substage>93</substage>
+                   </status>
+                   <copyright>
+                     <from>2001</from>
+                     <owner>
+                       <organization>
+                         <name>ISO</name>
+                       </organization>
+                     </owner>
+                   </copyright>
+                   <relation type='obsoletes'>
+                     <bibitem type='standard'>
+                       <formattedref format='text/plain'>ISO 123:1985</formattedref>
+                     </bibitem>
+                   </relation>
+                   <place>Geneva</place>
+                 </bibitem>
+               </relation>
+               <relation type='instance'>
+                 <bibitem type='standard'>
+                   <formattedref format='text/plain'>ISO 123:1985</formattedref>
+                 </bibitem>
+               </relation>
+               <relation type='instance'>
+                 <bibitem type='standard'>
+                   <formattedref format='text/plain'>ISO 123:1974</formattedref>
+                 </bibitem>
+               </relation>
+               <place>Geneva</place>
+             </bibdata>
+

data/spec/assets/xref_error.adoc

@@ -0,0 +1,7 @@
+= X
+A
+
+== Clause
+
+<<a,b>>
+

data/spec/examples/datamodel/address_class_profile.adoc

@@ -0,0 +1,4 @@
+= Document title
+Author
+
+[datamodel_attributes_table,models/models/AddressClassProfile.yml]

data/spec/examples/datamodel/address_component_profile.adoc

@@ -0,0 +1,4 @@
+= Document title
+Author
+
+[datamodel_attributes_table,models/models/AddressComponentProfile.yml]

data/spec/examples/datamodel/blank_definition_profile.adoc

@@ -0,0 +1,4 @@
+= Document title
+Author
+
+[datamodel_attributes_table,models/models/SignatureBlankDefinition.yml]

data/spec/examples/datamodel/common_models_diagram.adoc

@@ -0,0 +1,4 @@
+= Document title
+Author
+
+[datamodel_diagram,models/views/CommonModels.yml]

data/spec/examples/datamodel/models/models/AddressClassProfile.yml

@@ -0,0 +1,90 @@
+modelType: class
+# TODO
+definition: |
+  An `AddressClassProfile` represents a profile of a `ProfileCompliantAddress`.
+  It corresponds to the concept of an `AddressClass` originally
+  expressed in <<ISO19160-1>> as a referenced codelist.
+
+  It represents additional attributes and restrictions to the
+  `ProfileCompliantAddress` model. It also represents metadata for the use of
+  the profile.
+
+  A single profile can include and support multiple types of
+  address formats, such as a numbered street address and a
+  "`PO Box`" address simultaneously. Each of these address formats
+  is represented as an interchange address class.
+
+  [example]
+  --
+  The US Numbered Thoroughfare Address with this syntax can be
+  represented as an address class profile:
+
+  *{sp}{ Complete Landmark Name or Complete Place Name } +
+  *{sp}{ Complete Address Number * } +
+  *{sp}{ Complete Street Name * } +
+  *{sp}{ Complete Subaddress } +
+  *{sp}{ Complete Place Name * } +
+  *{sp}{ State Name * } +
+  *{sp}{ Zip Code } +
+  *{sp}{ Zip Plus 4 } +
+  *{sp}{ Country Name }
+  --
+attributes:
+  id:
+    definition: Unique identifier of this AddressClassProfile.
+    type: CharacterString
+  type:
+    definition: Intended usage of this profile.
+    type: CharacterString
+  description:
+    definition: Textual description of this profile.
+    type: CharacterString
+  localization:
+    definition: The language and script used within this profile.
+    type: Localization
+  signature:
+    definition: The digital signature to verify the integrity of this profile, and the identity of the publishing authority.
+    type: Signature
+    cardinality:
+      min: 0
+      max: 1
+  areaApplicability:
+    definition: The geographic representation of which this AddressClassProfile applies to. Overlapping geographic areas are allowed across different profiles.
+    type: iso19115MD_SpatialRepresentation
+    cardinality:
+      min: 0
+      max: "*"
+  timeToLive:
+    definition: The maximum time interval between refreshing of this profile via an authoritative source, in seconds.
+    type: Integer
+  validity:
+    definition: The period of date and time that this profile should be considered as valid.
+    type: Validity
+relations:
+  - target: AttributeProfile
+    relationship:
+      source:
+        type: aggregation
+        attribute:
+          addressClassProfile:
+      target:
+        type: direct
+        attribute:
+          attributeProfile:
+            cardinality:
+              min: 0
+              max: '*'
+
+  - target: ProfileCompliantAddress
+    relationship:
+      source:
+        attribute:
+          profile:
+            cardinality:
+              min: 1
+              max: 1
+      target:
+        type: direct
+    action:
+      verb: compliesWith
+      direction: source

data/spec/examples/datamodel/models/models/AddressComponentProfile.yml

@@ -0,0 +1,63 @@
+name: AddressComponentProfile
+modelType: class
+definition: |
+  An `AddressComponentProfile` represents a profile of a `ProfileCompliantAddressComponent`,
+  which is extended from the `AddressComponent` model defined in <<ISO19160-1>>.
+
+  It represents additional attributes and restrictions to the `Address` model
+  of a `ProfileCompliantAddress`. It also represents metadata for the use of
+  the profile.
+attributes:
+  key:
+    definition: An identifier of this `AddressComponentProfile`, shall be unique within the `AddressProfile`.
+    type: CharacterString
+  description:
+    definition: Textual description of this component.
+    type: CharacterString
+  example:
+    definition: A textual example to demonstrate the correct use of this component.
+    type: CharacterString
+    cardinality:
+      min: 0
+      max: 1
+relations:
+  - target: AddressClassProfile
+    relationship:
+      target:
+        type: aggregation
+        attribute:
+          componentProfile:
+            cardinality:
+              min: 0
+              max: "*"
+      association: AddressComponentSpecification
+    action:
+      verb: uses
+      direction: source
+
+  - target: AttributeProfile
+    relationship:
+      source:
+        type: aggregation
+        attribute:
+          addressClassProfile:
+      target:
+        type: direct
+        attribute:
+          attributeProfile:
+            cardinality:
+              min: 0
+              max: '*'
+
+  - target: ProfileCompliantAddressComponent
+    relationship:
+      target:
+        type: direct
+        attribute:
+          profile:
+            cardinality:
+              min: 1
+              max: 1
+    action:
+      verb: compliesWith
+      direction: source

data/spec/examples/datamodel/models/models/AddressComponentSpecification.yml

@@ -0,0 +1,15 @@
+name: AddressComponentSpecification
+modelType: class
+definition: |
+  An `AddressComponentSpecification` specifies the cardinalities between a
+  `ProfileCompliantAddress` and `ProfileCompliantAddressComponents`.
+
+  A `ProfileComplinatAddress` MUST conform to this
+  `AddressComponentSpecification` to specifies its components.
+attributes:
+  maxCardinality:
+    definition: The maximum number of instances of the specific `ProfileCompliantAddressComponent` of a `ProfileCompliantAddress`.
+    type: Integer
+  minCardinality:
+    definition: The minimum number of instances of the specific `ProfileCompliantAddressComponent` of a `ProfileCompliantAddress`.
+    type: Integer