metanorma-standoc 1.3.24 → 1.3.29

data/spec/asciidoctor-standoc/cleanup_spec.rb

@@ -293,6 +293,35 @@ RSpec.describe Asciidoctor::Standoc do
     OUTPUT
   end
 
+    it "does not move notes inside preceding blocks, if they are marked as keep-separate" do
+    expect(xmlpp(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true)))).to be_equivalent_to xmlpp(<<~"OUTPUT")
+      #{ASCIIDOC_BLANK_HDR}
+
+      [stem]
+      ++++
+      r = 1 %
+      r = 1 %
+      ++++
+
+      [NOTE,keep-separate=true]
+      ====
+      That formula does not do much
+      ====
+
+      Indeed.
+    INPUT
+       #{BLANK_HDR}
+    <sections><formula id="_">
+  <stem type="MathML"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>r</mi><mo>=</mo><mn>1</mn><mi>%</mi><mi>r</mi><mo>=</mo><mn>1</mn><mi>%</mi></math></stem></formula>
+<note id="_">
+  <p id="_">That formula does not do much</p>
+</note>
+
+       <p id="_">Indeed.</p></sections>
+       </standard-document>
+    OUTPUT
+  end
+
   it "does not move notes inside preceding blocks, if they are at clause end" do
     expect(xmlpp(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true)))).to be_equivalent_to xmlpp(<<~"OUTPUT")
       #{ASCIIDOC_BLANK_HDR}
@@ -330,12 +359,13 @@ RSpec.describe Asciidoctor::Standoc do
         <eref type="inline" bibitemid="iso216" citeas="ISO 216:2001"/>
       </p>
       </foreword></preface><sections>
-      </sections><bibliography><references id="_" obligation="informative">
+      </sections><bibliography><references id="_" obligation="informative" normative="true">
         <title>Normative References</title>
         #{NORM_REF_BOILERPLATE}
         <bibitem id="iso216" type="standard">
          <title format="text/plain">Reference</title>
          <docidentifier>ISO 216:2001</docidentifier>
+         <docnumber>216</docnumber>
          <date type="published">
            <on>2001</on>
          </date>
@@ -407,12 +437,13 @@ RSpec.describe Asciidoctor::Standoc do
 
         </p>
       </foreword></preface><sections>
-      </sections><bibliography><references id="_" obligation="informative">
+      </sections><bibliography><references id="_" obligation="informative" normative="true">
         <title>Normative References</title>
         #{NORM_REF_BOILERPLATE}
         <bibitem id="iso216" type="standard">
          <title format="text/plain">Reference</title>
          <docidentifier>ISO 216</docidentifier>
+         <docnumber>216</docnumber>
          <contributor>
            <role type="publisher"/>
            <organization>
@@ -444,11 +475,12 @@ RSpec.describe Asciidoctor::Standoc do
          <eref type="inline" bibitemid="iso216" citeas="ISO 216"/>
        </p>
        </foreword></preface><sections>
-       </sections><bibliography><references id="_" obligation="informative">
+       </sections><bibliography><references id="_" obligation="informative" normative="false">
   <title>Bibliography</title>
   <bibitem id="iso216" type="standard">
   <title format="text/plain">Reference</title>
   <docidentifier>ISO 216</docidentifier>
+         <docnumber>216</docnumber>
   <contributor>
     <role type="publisher"/>
     <organization>
@@ -506,11 +538,12 @@ RSpec.describe Asciidoctor::Standoc do
     INPUT
       #{BLANK_HDR}
       <sections></sections>
-      <bibliography><references id="_" obligation="informative"><title>Normative References</title>
+      <bibliography><references id="_" obligation="informative" normative="true"><title>Normative References</title>
         #{NORM_REF_BOILERPLATE}
              <bibitem id="iso216" type="standard">
          <title format="text/plain">Reference</title>
          <docidentifier>ISO 216</docidentifier>
+         <docnumber>216</docnumber>
          <contributor>
            <role type="publisher"/>
            <organization>
@@ -552,12 +585,13 @@ RSpec.describe Asciidoctor::Standoc do
       #{BLANK_HDR}
       <sections> </sections>
          <bibliography>
-           <references id='_' obligation='informative'>
+           <references id='_' obligation='informative' normative="false">
              <title>Bibliography</title>
              <p id='_'>This is extraneous information</p>
              <bibitem id='iso216' type='standard'>
                <title format='text/plain'>Reference</title>
                <docidentifier>ISO 216</docidentifier>
+               <docnumber>216</docnumber>
                <contributor>
                  <role type='publisher'/>
                  <organization>
@@ -574,6 +608,7 @@ RSpec.describe Asciidoctor::Standoc do
              <bibitem id='iso216' type='standard'>
                <title format='text/plain'>Reference</title>
                <docidentifier>ISO 215</docidentifier>
+               <docnumber>215</docnumber>
                <contributor>
                  <role type='publisher'/>
                  <organization>
@@ -931,12 +966,13 @@ end
         <p id="_">Footnote2</p>
       </fn>
       </p>
-      </clause></sections><bibliography><references id="_" obligation="informative">
+      </clause></sections><bibliography><references id="_" obligation="informative" normative="true">
         <title>Normative References</title>
         #{NORM_REF_BOILERPLATE}
         <bibitem id="iso123" type="standard">
          <title format="text/plain">Standard</title>
          <docidentifier>ISO 123:—</docidentifier>
+         <docnumber>123</docnumber>
          <date type="published">
            <on>–</on>
          </date>
@@ -1161,7 +1197,7 @@ end
           </localityStack>
         </origin>
         </termsource>
-        </term></terms></sections><bibliography><references id="_" obligation="informative">
+        </term></terms></sections><bibliography><references id="_" obligation="informative" normative="true">
           <title>Normative References</title>
         #{NORM_REF_BOILERPLATE}
           <bibitem type="standard" id="IEC60050-102">
@@ -1331,21 +1367,16 @@ end
   end
 
     it "cleans up text MathML" do
-    expect(xmlpp(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true)))).to be_equivalent_to xmlpp(<<~"OUTPUT")
-      = Document title
-      Author
-      :docfile: test.adoc
-      :nodoc:
-      :novalid:
-      :no-isobib:
-
-      ++++
+      expect(Asciidoctor::Standoc::Converter.new(nil, backend: :standoc, header_footer: true).cleanup(Nokogiri::XML(<<~"INPUT")).to_xml).to be_equivalent_to xmlpp(<<~"OUTPUT")
+      #{BLANK_HDR}
+      <sections>
       <stem type="MathML">&lt;math xmlns="http://www.w3.org/1998/Math/MathML"&gt;&lt;mfrac&gt;&lt;mn&gt;1&lt;/mn&gt;&lt;mi&gt;r&lt;/mi&gt;&lt;/mfrac&gt;&lt;/math&gt;</stem>
-      ++++
+      </sections>
+      </standard-document>
     INPUT
        #{BLANK_HDR}
        <sections>
-       <stem type="MathML"><math><mfrac><mn>1</mn><mi>r</mi></mfrac></math></stem>
+       <stem type="MathML"><math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mn>1</mn><mi>r</mi></mfrac></math></stem>
 </sections>
 
 
@@ -1373,11 +1404,12 @@ end
   <p id="_"><eref type="inline" bibitemid="iso123" citeas="[2]"/>
 <eref type="inline" bibitemid="iso124" citeas="ISO 124"/></p>
 </clause>
-</sections><bibliography><references id="_" obligation="informative">
+</sections><bibliography><references id="_" obligation="informative" normative="false">
   <title>Bibliography</title>
   <bibitem id="iso124" type="standard">
   <title format="text/plain">Standard 124</title>
   <docidentifier>ISO 124</docidentifier>
+  <docnumber>124</docnumber>
   <contributor>
     <role type="publisher"/>
     <organization>
@@ -1428,11 +1460,12 @@ OUTPUT
        <eref type="inline" bibitemid="iso125" citeas="ISO 125"/>
        <eref type="inline" bibitemid="iso126" citeas="[4]"/></p>
        </clause>
-       </sections><bibliography><clause id="_" obligation="informative"><title>Bibliography</title><references id="_" obligation="informative">
+       </sections><bibliography><clause id="_" obligation="informative"><title>Bibliography</title><references id="_" obligation="informative" normative="false">
          <title>Clause 1</title>
          <bibitem id="iso124" type="standard">
          <title format="text/plain">Standard 124</title>
          <docidentifier>ISO 124</docidentifier>
+         <docnumber>124</docnumber>
          <contributor>
            <role type="publisher"/>
            <organization>
@@ -1447,11 +1480,11 @@ OUTPUT
          <docidentifier type="metanorma">[2]</docidentifier>
        </bibitem>
        </references>
-       <references id="_" obligation="informative">
-         
+       <references id="_" obligation="informative" normative="false">
          <bibitem id="iso125" type="standard">
          <title format="text/plain">Standard 124</title>
          <docidentifier>ISO 125</docidentifier>
+         <docnumber>125</docnumber>
          <contributor>
            <role type="publisher"/>
            <organization>
@@ -1481,7 +1514,7 @@ OUTPUT
       #{BLANK_HDR}
       <sections>
 
-</sections><bibliography><references id="_" obligation="informative">
+</sections><bibliography><references id="_" obligation="informative" normative="true">
   <title>Normative References</title><p id="_">There are no normative references in this document.</p>
 </references></bibliography>
 </standard-document>
@@ -1500,7 +1533,7 @@ OUTPUT
     #{BLANK_HDR}
     <sections>
 
-       </sections><bibliography><references id="_" obligation="informative">
+       </sections><bibliography><references id="_" obligation="informative" normative="true">
          <title>Normative References</title><p id="_">The following documents are referred to in the text in such a way that some or all of their content constitutes requirements of this document. For dated references, only the edition cited applies. For undated references, the latest edition of the referenced document (including any amendments) applies.</p>
          <bibitem id="a">
          <formattedref format="application/x-isodoc+xml">A</formattedref>
@@ -1529,7 +1562,7 @@ it "inserts boilerplate before empty Normative References in French" do
     #{BLANK_HDR.sub(/<language>en/, "<language>fr")}
     <sections>
 
-</sections><bibliography><references id="_" obligation="informative">
+</sections><bibliography><references id="_" obligation="informative" normative="true">
   <title>Normative References</title><p id="_">Le présent document ne contient aucune référence normative.</p>
 </references></bibliography>
 </standard-document>
@@ -1574,7 +1607,7 @@ it "removes bibdata bibitem IDs" do
   </bibdata>
   <sections> </sections>
   <bibliography>
-    <references id='_' obligation='informative'>
+    <references id='_' obligation='informative' normative="true">
       <title>Normative References</title>
       <p id="_">There are no normative references in this document.</p>
     </references>
@@ -1691,11 +1724,25 @@ it "sorts symbols lists" do
         <dd>
           <p id='_'>Definition 5</p>
         </dd>
-        <dt><stem type='MathML'>x_m</stem></dt>
+        <dt><stem type='MathML'>
+        <math xmlns='http://www.w3.org/1998/Math/MathML'>
+  <msub>
+    <mi>x</mi>
+    <mi>m</mi>
+  </msub>
+</math>
+        </stem></dt>
         <dd>
           <p id='_'>Definition 4</p>
         </dd>
-        <dt><stem type='MathML'>x_1</stem></dt>
+        <dt><stem type='MathML'>
+         <math xmlns='http://www.w3.org/1998/Math/MathML'>
+   <msub>
+     <mi>x</mi>
+     <mn>1</mn>
+   </msub>
+ </math>
+        </stem></dt>
         <dd>
           <p id='_'>Definition 3</p>
         </dd>

data/spec/asciidoctor-standoc/inline_spec.rb

@@ -88,7 +88,7 @@ text, including nested markup.
       <sections>
       <p id="_">
           <stem type="MathML"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mo>&lt;</mo><mn>1</mn></math></stem><br/>
-          <stem type="MathML"> <math xmlns="http://www.w3.org/1998/Math/MathML" alttext="n&lt;1" display="block">   <mrow>     <mi>n</mi>     <mo>&lt;</mo>     <mn>1</mn>   </mrow> </math></stem>
+          <stem type="MathML"> <math xmlns="http://www.w3.org/1998/Math/MathML" display="block">   <mrow>     <mi>n</mi>     <mo>&lt;</mo>     <mn>1</mn>   </mrow> </math></stem>
         </p>
       </sections>
        </standard-document>
@@ -106,7 +106,7 @@ text, including nested markup.
       <sections>
       <p id="_">
           <stem type="MathML"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mo>&lt;</mo><mn>1</mn></math></stem>
-          <stem type="MathML"> <math xmlns="http://www.w3.org/1998/Math/MathML" alttext="n&lt;1" display="block">   <mrow>     <mi>n</mi>     <mo>&lt;</mo>     <mn>1</mn>   </mrow> </math></stem>
+          <stem type="MathML"> <math xmlns="http://www.w3.org/1998/Math/MathML" display="block">   <mrow>     <mi>n</mi>     <mo>&lt;</mo>     <mn>1</mn>   </mrow> </math></stem>
         </p>
       </sections>
        </standard-document>
@@ -227,7 +227,7 @@ text, including nested markup.
             #{BLANK_HDR}
        <sections>
 
-       </sections><bibliography><references id="_" obligation="informative">
+       </sections><bibliography><references id="_" obligation="informative" normative="true">
          <title>Normative References</title>
          <p id="_">The following documents are referred to in the text in such a way that some or all of their content constitutes requirements of this document. For dated references, only the edition cited applies. For undated references, the latest edition of the referenced document (including any amendments) applies.</p>
          <bibitem id="ISO712">
@@ -237,6 +237,7 @@ text, including nested markup.
          <bibitem id="ISO713">
          <formattedref format="application/x-isodoc+xml">Reference</formattedref>
          <docidentifier>ISO713</docidentifier>
+         <docnumber>713</docnumber>
        </bibitem>
        </references>
        </bibliography>

data/spec/asciidoctor-standoc/macros_spec.rb

@@ -27,13 +27,14 @@ RSpec.describe Asciidoctor::Standoc do
 </preface>
 <sections> </sections>
 <bibliography>
-  <references id='_' obligation='informative'>
+  <references id='_' obligation='informative' normative="false">
     <title>Bibliography</title>
     <bibitem id='ref1'>
       <formattedref format='application/x-isodoc+xml'>
         <em>Title</em>
       </formattedref>
       <docidentifier>XYZ 123</docidentifier>
+      <docnumber>123</docnumber>
     </bibitem>
   </references>
 </bibliography>
@@ -177,7 +178,7 @@ INPUT
   </clause>
 </sections>
 <bibliography>
-  <references id='_' obligation='informative'>
+  <references id='_' obligation='informative' normative="false">
     <title>Bibliography</title>
     <bibitem id='blah'>
       <formattedref format='application/x-isodoc+xml'>
@@ -222,7 +223,8 @@ OUTPUT
         expect(xmlpp(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true)))).to be_equivalent_to xmlpp(<<~"OUTPUT")
         #{ASCIIDOC_BLANK_HDR}
 
-        [pseudocode]
+        [pseudocode,subsequence="A"]
+        [%unnumbered]
         ====
           *A* +
                 [smallcap]#B#
@@ -232,7 +234,7 @@ OUTPUT
         INPUT
         #{BLANK_HDR}
         <sections>
-  <figure id="_" class="pseudocode"><p id="_">  <strong>A</strong><br/>
+  <figure id="_"  subsequence='A' class="pseudocode" unnumbered="true"><p id="_">  <strong>A</strong><br/>
         <smallcap>B</smallcap></p>
 <p id="_">  <em>C</em></p></figure>
 </sections>
@@ -287,7 +289,7 @@ OUTPUT
        </standard-document>
     OUTPUT
   end
-  
+
   it "processes the PlantUML macro" do
     expect(xmlpp(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true)).gsub(%r{plantuml/plantuml[^./]+\.}, "plantuml/_."))).to be_equivalent_to xmlpp(<<~"OUTPUT")
       #{ASCIIDOC_BLANK_HDR}
@@ -462,7 +464,6 @@ Alice <-- Bob: another authentication Response
     OUTPUT
   end
 
-
   private
 
   def mock_plantuml_disabled
@@ -471,13 +472,13 @@ Alice <-- Bob: another authentication Response
       false
     end
   end
-  
+
   def mock_localdir_unwritable
     expect(Asciidoctor::Standoc::Utils).to receive(:localdir) do
       "/"
     end.exactly(2).times
   end
-  
+
   def mock_localdir_unwritable
     expect(File).to receive(:writable?) do
       false

data/spec/asciidoctor-standoc/macros_yaml2text_spec.rb

@@ -0,0 +1,564 @@
+require 'spec_helper'
+
+RSpec.describe Asciidoctor::Standoc::Yaml2TextPreprocessor do
+  describe '#process' do
+    let(:example_file) { 'example.yml' }
+
+    before do
+      if defined?(example_yaml_content)
+        File.open(example_file, 'w') { |n| n.puts(example_yaml_content) }
+      end
+    end
+
+    after do
+      FileUtils.rm_rf(example_file)
+    end
+
+    context 'Array of hashes' do
+      let(:example_yaml_content) do
+        <<~TEXT
+          ---
+          - name: spaghetti
+            desc: wheat noodles of 9mm diameter
+            symbol: SPAG
+            symbol_def: the situation is message like spaghetti at a kid's meal
+        TEXT
+      end
+      let(:input) do
+        <<~TEXT
+          = Document title
+          Author
+          :docfile: test.adoc
+          :nodoc:
+          :novalid:
+          :no-isobib:
+          :imagesdir: spec/assets
+
+          [yaml2text,#{example_file},my_context]
+          ----
+          {my_context.*,item,EOF}
+            {item.name}:: {item.desc}
+          {EOF}
+          ----
+        TEXT
+      end
+      let(:output) do
+        <<~TEXT
+          #{BLANK_HDR}
+          <sections>
+          <dl id='_'>
+            <dt>spaghetti</dt>
+            <dd>
+              <p id='_'>wheat noodles of 9mm diameter</p>
+            </dd>
+          </dl>
+          </sections>
+          </standard-document>
+        TEXT
+      end
+
+      it 'correctly renders input yaml' do
+        expect(
+          xmlpp(
+            strip_guid(
+              Asciidoctor.convert(input,
+                                  backend: :standoc,
+                                  header_footer: true),
+            ),
+          ),
+        ).to(be_equivalent_to(xmlpp(output)))
+      end
+    end
+
+    context 'An array of strings' do
+      let(:example_yaml_content) do
+        <<~TEXT
+          ---
+          - lorem
+          - ipsum
+          - dolor
+        TEXT
+      end
+      let(:input) do
+        <<~TEXT
+          = Document title
+          Author
+          :docfile: test.adoc
+          :nodoc:
+          :novalid:
+          :no-isobib:
+          :imagesdir: spec/assets
+
+          [yaml2text,#{example_file},ar]
+          ----
+          {ar.*,s,EOS}
+          === {s.#} {s}
+
+          This section is about {s}.
+
+          {EOS}
+          ----
+        TEXT
+      end
+      let(:output) do
+        <<~TEXT
+          #{BLANK_HDR}
+          <sections>
+          <clause id="_" inline-header="false" obligation="normative">
+             <title>0 lorem</title>
+             <p id='_'>This section is about lorem.</p>
+           </clause>
+           <clause id='_' inline-header='false' obligation='normative'>
+             <title>1 ipsum</title>
+             <p id='_'>This section is about ipsum.</p>
+           </clause>
+           <clause id='_' inline-header='false' obligation='normative'>
+             <title>2 dolor</title>
+             <p id='_'>This section is about dolor.</p>
+            </clause>
+          </sections>
+          </standard-document>
+        TEXT
+      end
+
+      it 'correctly renders input yaml' do
+        expect(
+          xmlpp(
+            strip_guid(
+              Asciidoctor.convert(input,
+                                  backend: :standoc,
+                                  header_footer: true),
+            ),
+          ),
+        ).to(be_equivalent_to(xmlpp(output)))
+      end
+    end
+
+    context 'A simple hash' do
+      let(:example_yaml_content) do
+        <<~TEXT
+          ---
+          name: Lorem ipsum
+          desc: dolor sit amet
+        TEXT
+      end
+      let(:input) do
+        <<~TEXT
+          = Document title
+          Author
+          :docfile: test.adoc
+          :nodoc:
+          :novalid:
+          :no-isobib:
+          :imagesdir: spec/assets
+
+          [yaml2text,#{example_file},my_item]
+          ----
+          === {my_item.name}
+
+          {my_item.desc}
+          ----
+        TEXT
+      end
+      let(:output) do
+        <<~TEXT
+          #{BLANK_HDR}
+          <sections>
+          <clause id="_" inline-header="false" obligation="normative">
+            <title>Lorem ipsum</title>
+            <p id='_'>dolor sit amet</p>
+          </clause>
+          </sections>
+          </standard-document>
+        TEXT
+      end
+
+      it 'correctly renders input yaml' do
+        expect(
+          xmlpp(
+            strip_guid(
+              Asciidoctor.convert(input,
+                                  backend: :standoc,
+                                  header_footer: true),
+            ),
+          ),
+        ).to(be_equivalent_to(xmlpp(output)))
+      end
+    end
+
+    context 'A simple hash with free keys' do
+      let(:example_yaml_content) do
+        <<~TEXT
+          ---
+          name: Lorem ipsum
+          desc: dolor sit amet
+        TEXT
+      end
+      let(:input) do
+        <<~TEXT
+          = Document title
+          Author
+          :docfile: test.adoc
+          :nodoc:
+          :novalid:
+          :no-isobib:
+          :imagesdir: spec/assets
+
+          [yaml2text,#{example_file},my_item]
+          ----
+          {my_item.*,key,EOI}
+          === {key}
+
+          {my_item[key]}
+
+          {EOI}
+          ----
+        TEXT
+      end
+      let(:output) do
+        <<~TEXT
+          #{BLANK_HDR}
+          <sections>
+          <clause id="_" inline-header="false" obligation="normative">
+              <title>name</title>
+              <p id='_'>Lorem ipsum</p>
+            </clause>
+            <clause id='_' inline-header='false' obligation='normative'>
+              <title>desc</title>
+              <p id='_'>dolor sit amet</p>
+          </clause>
+          </sections>
+          </standard-document>
+        TEXT
+      end
+
+      it 'correctly renders input yaml' do
+        expect(
+          xmlpp(
+            strip_guid(
+              Asciidoctor.convert(input,
+                                  backend: :standoc,
+                                  header_footer: true),
+            ),
+          ),
+        ).to(be_equivalent_to(xmlpp(output)))
+      end
+    end
+
+    context 'An array of hashes' do
+      let(:example_yaml_content) do
+        <<~TEXT
+          ---
+          - name: Lorem
+            desc: ipsum
+            nums: [2]
+          - name: dolor
+            desc: sit
+            nums: []
+          - name: amet
+            desc: lorem
+            nums: [2, 4, 6]
+        TEXT
+      end
+      let(:input) do
+        <<~TEXT
+          = Document title
+          Author
+          :docfile: test.adoc
+          :nodoc:
+          :novalid:
+          :no-isobib:
+          :imagesdir: spec/assets
+
+          [yaml2text,#{example_file},ar]
+          ----
+          {ar.*,item,EOF}
+
+          {item.name}:: {item.desc}
+
+          {item.nums.*,num,EON}
+          - {item.name}: {num}
+          {EON}
+
+          {EOF}
+          ----
+        TEXT
+      end
+      let(:output) do
+        <<~TEXT
+            #{BLANK_HDR}
+            <sections>
+            <dl id='_'>
+            <dt>Lorem</dt>
+            <dd>
+              <p id='_'>ipsum</p>
+              <ul id='_'>
+                <li>
+                  <p id='_'>Lorem: 2</p>
+                </li>
+              </ul>
+            </dd>
+            <dt>dolor</dt>
+            <dd>
+              <p id='_'>sit</p>
+            </dd>
+            <dt>amet</dt>
+            <dd>
+              <p id='_'>lorem</p>
+              <ul id='_'>
+                <li>
+                  <p id='_'>amet: 2</p>
+                </li>
+                <li>
+                  <p id='_'>amet: 4</p>
+                </li>
+                <li>
+                  <p id='_'>amet: 6</p>
+                </li>
+              </ul>
+            </dd>
+          </dl>
+            </sections>
+            </standard-document>
+        TEXT
+      end
+
+      it 'correctly renders input yaml' do
+        expect(
+          xmlpp(
+            strip_guid(
+              Asciidoctor.convert(input,
+                                  backend: :standoc,
+                                  header_footer: true),
+            ),
+          ),
+        ).to(be_equivalent_to(xmlpp(output)))
+      end
+    end
+
+    context "An array with interpolated file names, etc. \
+              for Asciidoc's consumption" do
+      let(:example_yaml_content) do
+        <<~TEXT
+          ---
+          prefix: doc-
+          items:
+          - lorem
+          - ipsum
+          - dolor
+        TEXT
+      end
+      let(:input) do
+        <<~TEXT
+          = Document title
+          Author
+          :docfile: test.adoc
+          :nodoc:
+          :novalid:
+          :no-isobib:
+          :imagesdir: spec/assets
+
+          [yaml2text,#{example_file},yaml]
+          ------
+          First item is {yaml.items[0]}.
+          Last item is {yaml.items[-1]}.
+
+          {yaml.items.*,s,EOS}
+          === {s.#} -> {s.# + 1} {s} == {yaml.items[s.#]}
+
+          [source,ruby]
+          ----
+          include::{yaml.prefix}{s.#}.rb[]
+          ----
+
+          {EOS}
+          ------
+        TEXT
+      end
+      let(:output) do
+        <<~TEXT
+          #{BLANK_HDR}
+            <preface>
+              <foreword id='_' obligation='informative'>
+                <title>Foreword</title>
+                <p id='_'>First item is lorem. Last item is dolor.</p>
+              </foreword>
+            </preface>
+            <sections>
+              <clause id='_' inline-header='false' obligation='normative'>
+                <title>0 → 1 lorem == lorem</title>
+                <sourcecode lang='ruby' id='_'>link:doc-0.rb[]</sourcecode>
+              </clause>
+              <clause id='_' inline-header='false' obligation='normative'>
+                <title>1 → 2 ipsum == ipsum</title>
+                <sourcecode lang='ruby' id='_'>link:doc-1.rb[]</sourcecode>
+              </clause>
+              <clause id='_' inline-header='false' obligation='normative'>
+                <title>2 → 3 dolor == dolor</title>
+                <sourcecode lang='ruby' id='_'>link:doc-2.rb[]</sourcecode>
+              </clause>
+            </sections>
+          </standard-document>
+        TEXT
+      end
+
+      it 'correctly renders input yaml' do
+        expect(
+          xmlpp(
+            strip_guid(
+              Asciidoctor.convert(input,
+                                  backend: :standoc,
+                                  header_footer: true),
+            ),
+          ),
+        ).to(be_equivalent_to(xmlpp(output)))
+      end
+    end
+
+    context "Array of language codes" do
+      let(:input) do
+        <<~TEXT
+          = Document title
+          Author
+          :docfile: test.adoc
+          :nodoc:
+          :novalid:
+          :no-isobib:
+          :imagesdir: spec/assets
+
+          [yaml2text,#{File.expand_path('../assets/codes.yml', __dir__)},ar]
+          ----
+          {ar.*,item,EOF}
+          .{item.values[1]}
+          [%noheader,cols="h,1"]
+          |===
+          {item.*,key,EOK}
+          | {key} | {item[key]}
+
+          {EOK}
+          |===
+          {EOF}
+          ----
+        TEXT
+      end
+      let(:output) do
+        <<~TEXT
+          #{BLANK_HDR}
+            <sections>
+              #{File.read(File.expand_path('../examples/codes_table.html', __dir__))}
+            </sections>
+          </standard-document>
+        TEXT
+      end
+
+      it 'correctly renders input yaml' do
+        expect(
+          xmlpp(
+            strip_guid(
+              Asciidoctor.convert(input,
+                                  backend: :standoc,
+                                  header_footer: true),
+            ),
+          ),
+        ).to(be_equivalent_to(xmlpp(output)))
+      end
+    end
+
+    context "Nested hash dot notation" do
+      let(:example_yaml_content) do
+        <<~TEXT
+          data:
+            acadsin-zho-hani-latn-2002:
+              code: acadsin-zho-hani-latn-2002
+              name:
+                en: Academica Sinica -- Chinese Tongyong Pinyin (2002)
+              authority: acadsin
+              lang:
+                system: iso-639-2
+                code: zho
+              source_script: Hani
+              target_script: Latn
+              system:
+                id: '2002'
+                specification: Academica Sinica -- Chinese Tongyong Pinyin (2002)
+              notes: 'NOTE: OGC 11-122r1 code `zho_Hani2Latn_AcadSin_2002`'
+        TEXT
+      end
+      let(:input) do
+        <<~TEXT
+          = Document title
+          Author
+          :docfile: test.adoc
+          :nodoc:
+          :novalid:
+          :no-isobib:
+          :imagesdir: spec/assets
+
+          [yaml2text,#{example_file},authorities]
+          ----
+          [cols="a,a,a,a",options="header"]
+          |===
+          | Script conversion system authority code | Name in English | Notes | Name en
+
+          {authorities.data.*,key,EOI}
+          | {key} | {authorities.data[key]['code']} | {authorities.data[key]['notes']} | {authorities.data[key].name.en}
+          {EOI}
+
+          |===
+          ----
+        TEXT
+      end
+      let(:output) do
+        <<~TEXT
+          #{BLANK_HDR}
+            <sections>
+              <table id='_'>
+                <thead>
+                  <tr>
+                    <th align='left'>Script conversion system authority code</th>
+                    <th align='left'>Name in English</th>
+                    <th align='left'>Notes</th>
+                    <th align='left'>Name en</th>
+                  </tr>
+                </thead>
+                <tbody>
+                  <tr>
+                    <td align='left'>
+                      <p id='_'>acadsin-zho-hani-latn-2002</p>
+                    </td>
+                    <td align='left'>
+                      <p id='_'>acadsin-zho-hani-latn-2002</p>
+                    </td>
+                    <td align='left'>
+                      <note id='_'>
+                        <p id='_'>
+                          OGC 11-122r1 code
+                          <tt>zho_Hani2Latn_AcadSin_2002</tt>
+                        </p>
+                      </note>
+                    </td>
+                    <td align='left'>
+                      <p id='_'>Academica Sinica — Chinese Tongyong Pinyin (2002)</p>
+                    </td>
+                  </tr>
+                </tbody>
+              </table>
+            </sections>
+          </standard-document>
+        TEXT
+      end
+
+      it 'correctly renders input yaml' do
+        expect(
+          xmlpp(
+            strip_guid(
+              Asciidoctor.convert(input,
+                                  backend: :standoc,
+                                  header_footer: true),
+            ),
+          ),
+        ).to(be_equivalent_to(xmlpp(output)))
+      end
+    end
+  end
+end