metanorma-standoc 1.6.4 → 1.7.3

data/spec/asciidoctor-standoc/macros_spec.rb

@@ -44,6 +44,75 @@ RSpec.describe Asciidoctor::Standoc do
     OUTPUT
   end
 
+  it "processes the Asciidoctor::Standoc index macros" do
+    expect(xmlpp(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true)))).to be_equivalent_to xmlpp(<<~"OUTPUT")
+      #{ASCIIDOC_BLANK_HDR}
+      index:also[]
+      index:see[A]
+      index:also[B,C~x~]
+      index:see[D,_E_,F]
+      index:also[G,H,I,J]
+      index:see[K,L,M,N,O]
+      index-range:id2[P]
+      index-range:id3[((_P_))]
+      index-range:id3[(((Q, R, S)))]
+
+      Text [[id2]]
+
+      Text [[id3]]
+    INPUT
+            #{BLANK_HDR}
+  <sections>
+    <p id='_'>
+      <index-xref also='true'>
+        <primary>B</primary>
+        <target>
+          C
+          <sub>x</sub>
+        </target>
+      </index-xref>
+      <index-xref also='false'>
+        <primary>D</primary>
+        <secondary>
+          <em>E</em>
+        </secondary>
+        <target>F</target>
+      </index-xref>
+      <index-xref also='true'>
+        <primary>G</primary>
+        <secondary>H</secondary>
+        <tertiary>I</tertiary>
+        <target>J</target>
+      </index-xref>
+       P
+<index to="id2">
+  <primary>P</primary>
+</index>
+<em>P</em>
+<index to="id3">
+  <primary>
+    <em>P</em>
+  </primary>
+</index>
+<index to="id3">
+  <primary>Q</primary>
+  <secondary>R</secondary>
+  <tertiary>S</tertiary>
+</index>
+    </p>
+    <p id='_'>
+             Text
+             <bookmark id='id2'/>
+           </p>
+           <p id='_'>
+             Text
+             <bookmark id='id3'/>
+           </p>
+  </sections>
+</standard-document>
+    OUTPUT
+  end
+
   it "processes the Asciidoctor::Standoc variant macros" do
     expect(xmlpp(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true)))).to be_equivalent_to xmlpp(<<~"OUTPUT")
       #{ASCIIDOC_BLANK_HDR}
@@ -329,13 +398,11 @@ OUTPUT
  <formula id='_'>
    <stem type='MathML'>
      <math xmlns='http://www.w3.org/1998/Math/MathML'>
-     <mover>
+     <mover accent="true">
                      <mrow>
                        <mi>X</mi>
                      </mrow>
-                     <mrow>
                        <mo>¯</mo>
-                     </mrow>
                    </mover>
                    <mo>′</mo>
                    <mo>=</mo>
@@ -508,309 +575,223 @@ OUTPUT
     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}
-
-      [plantuml]
-      ....
-      @startuml
-      Alice -> Bob: Authentication Request
-      Bob --> Alice: Authentication Response
-
-      Alice -> Bob: Another authentication Request
-      Alice <-- Bob: another authentication Response
-      @enduml
-      ....
-
-      [plantuml]
-      ....
-      Alice -> Bob: Authentication Request
-      Bob --> Alice: Authentication Response
-
-      Alice -> Bob: Another authentication Request
-      Alice <-- Bob: another authentication Response
-      ....
-
-      [plantuml]
-      ....
-      @startuml filename
-      Alice -> Bob: Authentication Request
-      Bob --> Alice: Authentication Response
-
-      Alice -> Bob: Another authentication Request
-      Alice <-- Bob: another authentication Response
-      @enduml
-      ....
-    INPUT
-       #{BLANK_HDR}
-       <sections><figure id="_">
-  <image src="plantuml/_.png" id="_" mimetype="image/png" height="auto" width="auto"/>
-</figure>
-<figure id="_">
-  <image src="plantuml/_.png" id="_" mimetype="image/png" height="auto" width="auto"/>
-</figure>
-<figure id="_">
-  <image src="plantuml/filename.png" id="_" mimetype="image/png" height="auto" width="auto"/>
-</figure>
-        </sections>
-
-       </standard-document>
-    OUTPUT
-  end
-
-  it "processes the PlantUML macro with imagesdir" do
-      expect(xmlpp(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true)).gsub(%r{spec/assets/[^./]+\.}, "spec/assets/_."))).to be_equivalent_to xmlpp(<<~"OUTPUT")
-      = Document title
-      Author
-      :docfile: test.adoc
-      :nodoc:
-      :novalid:
-      :no-isobib:
-      :imagesdir: spec/assets
-
-      [plantuml]
-      ....
-      @startuml
-      Alice -> Bob: Authentication Request
-      Bob --> Alice: Authentication Response
-
-      Alice -> Bob: Another authentication Request
-      Alice <-- Bob: another authentication Response
-      @enduml
-      ....
-   INPUT
-          #{BLANK_HDR}
-          <sections>
-  <figure id="_">
-  <image src="spec/assets/_.png" id="_" mimetype="image/png" height="auto" width="auto"/>
-</figure>
-</sections>
-</standard-document>
-OUTPUT
+    describe 'term inline macros' do
+    subject(:convert) do
+      xmlpp(
+        strip_guid(
+          Asciidoctor.convert(
+            input, backend: :standoc, header_footer: true)))
     end
-
-  context 'when lutaml_diagram' do
     let(:input) do
-      <<~"OUTPUT"
-        = Document title
-        Author
-        :docfile: test.adoc
-        :nodoc:
-        :novalid:
-        :no-isobib:
-        :imagesdir: spec/assets
-
-        [lutaml_diagram]
-        ....
-        diagram MyView {
-          fontname "Arial"
-          title "my diagram"
-          class Foo {}
-        }
-        ....
-      OUTPUT
-    end
-    let(:output) do
-      <<~"OUTPUT"
-      #{BLANK_HDR}
-        <sections>
-        <figure id="_">
-        <image src="spec/assets/_.png" id="_" mimetype="image/png" height="auto" width="auto"/>
-        </figure>
-        </sections>
-        </standard-document>
-      OUTPUT
-    end
+      <<~XML
+        #{ASCIIDOC_BLANK_HDR}
+        == Terms and Definitions
 
-    it "processes the lutaml_diagram" do
-      expect(
-        xmlpp(
-          strip_guid(Asciidoctor.convert(input, backend: :standoc, header_footer: true))
-                      .gsub(%r{".+spec\/assets\/lutaml\/[^.\/]+\.}, %q("spec/assets/_.))))
-        .to(be_equivalent_to xmlpp(output))
-    end
-  end
+        === name2
 
-=begin
-  context 'when lutaml_uml_attributes_table' do
-    let(:example_file) { fixtures_path("diagram_definitions.lutaml") }
-    let(:input) do
-      <<~"OUTPUT"
-        = Document title
-        Author
-        :docfile: test.adoc
-        :nodoc:
-        :novalid:
-        :no-isobib:
-        :imagesdir: spec/assets
-
-        [lutaml_uml_attributes_table,#{example_file},AttributeProfile]
-      OUTPUT
+        == Main
+
+        term:[name,name2] is a term
+      XML
     end
     let(:output) do
-      <<~"OUTPUT"
-      #{BLANK_HDR}
+      <<~XML
+        #{BLANK_HDR}
         <sections>
+          <terms id='_' obligation='normative'>
+            <title>Terms and definitions</title>
+            <p id='_'>For the purposes of this document, the following terms and definitions apply.</p>
+            <term id='term-name2'>
+              <preferred>name2</preferred>
+            </term>
+          </terms>
           <clause id='_' inline-header='false' obligation='normative'>
-            <title>AttributeProfile</title>
-            <table id='_'>
-              <name>AttributeProfile attributes</name>
-              <thead>
-                <tr>
-                  <th valign='top' align='left'>Name</th>
-                  <th valign='top' align='left'>Definition</th>
-                  <th valign='top' align='left'>Mandatory/ Optional/ Conditional</th>
-                  <th valign='top' align='left'>Max Occur</th>
-                  <th valign='top' align='left'>Data Type</th>
-                </tr>
-              </thead>
-              <tbody>
-                <tr>
-                  <td valign='top' align='left'>addressClassProfile</td>
-                  <td valign='top' align='left'>TODO: enum ‘s definition</td>
-                  <td valign='top' align='left'>M</td>
-                  <td valign='top' align='left'>1</td>
-                  <td valign='top' align='left'>
-                    <tt>CharacterString</tt>
-                  </td>
-                </tr>
-                <tr>
-                  <td valign='top' align='left'>imlicistAttributeProfile</td>
-                  <td valign='top' align='left'>this is attribute definition with multiply lines</td>
-                  <td valign='top' align='left'>M</td>
-                  <td valign='top' align='left'>1</td>
-                  <td valign='top' align='left'>
-                    <tt>CharacterString</tt>
-                  </td>
-                </tr>
-              </tbody>
-            </table>
+            <title>Main</title>
+            <p id='_'>
+              <em>name</em>
+              (
+              <xref target='term-name2'/>
+              ) is a term
+            </p>
           </clause>
         </sections>
         </standard-document>
-      OUTPUT
+      XML
     end
 
-    it "processes the lutaml_diagram" do
-      expect(
-        xmlpp(
-          strip_guid(Asciidoctor.convert(input, backend: :standoc, header_footer: true))))
-        .to(be_equivalent_to(xmlpp(output)))
+    it 'converts macro into the correct xml' do
+      expect(convert).to(be_equivalent_to(xmlpp(output)))
     end
-  end
-=end
 
-  it "processes the PlantUML macro with PlantUML disabled" do
-    mock_plantuml_disabled
-    expect { Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true) }.to output(%r{PlantUML not installed}).to_stderr
-      #{ASCIIDOC_BLANK_HDR}
+    context 'default params' do
+      let(:input) do
+        <<~XML
+          #{ASCIIDOC_BLANK_HDR}
 
-      [plantuml]
-      ....
-      @startuml
-      Alice -> Bob: Authentication Request
-      Bob --> Alice: Authentication Response
+          == Terms and Definitions
 
-      Alice -> Bob: Another authentication Request
-      Alice <-- Bob: another authentication Response
-      @enduml
-      ....
-    INPUT
+          === name
 
-    mock_plantuml_disabled
-    expect(xmlpp(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true)))).to be_equivalent_to xmlpp(<<~"OUTPUT")
-      #{ASCIIDOC_BLANK_HDR}
+          == Main
 
-      [plantuml]
-      ....
-      @startuml
-      Alice -> Bob: Authentication Request
-      Bob --> Alice: Authentication Response
+          term:[name] is a term
+        XML
+      end
+      let(:output) do
+        <<~XML
+          #{BLANK_HDR}
+          <sections>
+            <terms id='_' obligation='normative'>
+              <title>Terms and definitions</title>
+              <p id='_'>For the purposes of this document, the following terms and definitions apply.</p>
+              <term id='term-name'>
+                <preferred>name</preferred>
+              </term>
+            </terms>
+            <clause id='_' inline-header='false' obligation='normative'>
+              <title>Main</title>
+              <p id='_'>
+                <em>name</em>
+                (
+                <xref target='term-name' />
+                ) is a term
+              </p>
+            </clause>
+          </sections>
+          </standard-document>
+        XML
+      end
+
+      it 'uses `name` as termref name' do
+        expect(convert).to(be_equivalent_to(xmlpp(output)))
+      end
+    end
 
-      Alice -> Bob: Another authentication Request
-      Alice <-- Bob: another authentication Response
-      @enduml
-      ....
-    INPUT
-       #{BLANK_HDR}
-       <sections>
-         <sourcecode id="_" lang="plantuml">@startuml
-Alice -&gt; Bob: Authentication Request
-Bob --&gt; Alice: Authentication Response
-
-Alice -&gt; Bob: Another authentication Request
-Alice &lt;-- Bob: another authentication Response
-@enduml</sourcecode>
-        </sections>
-       </standard-document>
-    OUTPUT
-  end
+     context 'multiply exising ids in document' do
+      let(:input) do
+        <<~XML
+          #{ASCIIDOC_BLANK_HDR}
 
-  it "processes the PlantUML macro with localdir unwritable" do
-    mock_localdir_unwritable
-    expect { Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true) }.to output(%r{not writable for PlantUML}).to_stderr
-      #{ASCIIDOC_BLANK_HDR}
+          == Terms and Definitions
 
-      [plantuml]
-      ....
-      @startuml
-      Alice -> Bob: Authentication Request
-      Bob --> Alice: Authentication Response
+          === name
+          === name2
 
-      Alice -> Bob: Another authentication Request
-      Alice <-- Bob: another authentication Response
-      @enduml
-      ....
-    INPUT
+          [[term-name]]
+          == Main
 
-    mock_localdir_unwritable
-    expect(xmlpp(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true)))).to be_equivalent_to xmlpp(<<~"OUTPUT")
-      #{ASCIIDOC_BLANK_HDR}
+          paragraph
 
-      [plantuml]
-      ....
-      @startuml
-      Alice -> Bob: Authentication Request
-      Bob --> Alice: Authentication Response
+          [[term-name2]]
+          == Second
 
-      Alice -> Bob: Another authentication Request
-      Alice <-- Bob: another authentication Response
-      @enduml
-      ....
-    INPUT
-       #{BLANK_HDR}
-       <sections>
-         <sourcecode id="_" lang="plantuml">@startuml
-Alice -&gt; Bob: Authentication Request
-Bob --&gt; Alice: Authentication Response
-
-Alice -&gt; Bob: Another authentication Request
-Alice &lt;-- Bob: another authentication Response
-@enduml</sourcecode>
-        </sections>
-       </standard-document>
-    OUTPUT
-  end
+          term:[name] is a term
+          term:[name2] is a term
+        XML
+      end
+      let(:output) do
+        <<~XML
+          #{BLANK_HDR}
+          <sections>
+            <terms id='_' obligation='normative'>
+              <title>Terms and definitions</title>
+              <p id='_'>For the purposes of this document, the following terms and definitions apply.</p>
+              <term id='term-name-1'>
+                 <preferred>name</preferred>
+              </term>
+              <term id='term-name2-1'>
+                <preferred>name2</preferred>
+              </term>
+            </terms>
+            <clause id='term-name' inline-header='false' obligation='normative'>
+              <title>Main</title>
+              <p id='_'>paragraph</p>
+            </clause>
+            <clause id='term-name2' inline-header='false' obligation='normative'>
+              <title>Second</title>
+              <p id='_'>
+                <em>name</em>
+                (
+                <xref target='term-name-1' />
+                ) is a term
+                <em>name2</em>
+                  (
+                <xref target='term-name2-1' />
+                ) is a term
+              </p>
+            </clause>
+          </sections>
+          </standard-document>
+        XML
+      end
+
+      it 'generates unique ids which do not match existing ids' do
+        expect(convert).to(be_equivalent_to(xmlpp(output)))
+      end
+    end
 
-  private
+     context 'when missing actual ref' do
+      let(:input) do
+        <<~XML
+          #{ASCIIDOC_BLANK_HDR}
 
-  def mock_plantuml_disabled
-    expect(Asciidoctor::Standoc::PlantUMLBlockMacroBackend).to receive(:plantuml_installed?) do
-      raise "PlantUML not installed"
-      false
-    end
-  end
+          == Terms and Definitions
 
-  def mock_localdir_unwritable
-    expect(Asciidoctor::Standoc::Utils).to receive(:localdir) do
-      "/"
-    end.exactly(2).times
-  end
+          === name identity
+
+          [[name-check]]
+          === name check
+
+          paragraph
 
-  def mock_localdir_unwritable
-    expect(File).to receive(:writable?) do
-      false
+          term:[name check] is a term
+
+          term:[name identity] is a term
+
+          Moreover, term:[missing] is a term
+        XML
+      end
+      let(:output) do
+        <<~XML
+          #{BLANK_HDR}
+            <sections>
+              <terms id='_' obligation='normative'>
+                <title>Terms and definitions</title>
+                <p id='_'>For the purposes of this document, the following terms and definitions apply.</p>
+                <term id='term-name-identity'>
+  <preferred>name identity</preferred>
+</term>
+                <term id='name-check'>
+                  <preferred>name check</preferred>
+                  <definition>
+                    <p id='_'>paragraph</p>
+                    <p id='_'>
+                      <em>name check</em>
+                       (
+                      <xref target='name-check'/>
+                      ) is a term
+                      </p>
+                      <p id='_'>
+                      <em>name identity</em>
+                       (
+                      <xref target='term-name-identity'/>
+                      ) is a term
+                      </p>
+                      <p id="_">Moreover, (<strong>term “missing” not resolved</strong>) is a term
+</p>
+                  </definition>
+                </term>
+              </terms>
+            </sections>
+          </standard-document>
+        XML
+      end
+
+      it 'generates unique ids which do not match existing ids' do
+        expect(convert).to(be_equivalent_to(xmlpp(output)))
+      end
     end
-  end
+
+    end
+
 end