asciidoctor-rfc 0.1.0 → 0.2.0

data/spec/asciidoctor/rfc/v3/comments_spec.rb

@@ -0,0 +1,308 @@
+require "spec_helper"
+describe Asciidoctor::RFC::V3::Converter do
+  it "ignores actual Asciidoctor comments" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc3, header_footer: true)).to be_equivalent_to <<~'OUTPUT'
+      = Document title
+      :abbrev: abbrev_value
+      :docName:
+      Author
+
+      == Section1
+      Text
+      //Ignorable comment
+
+      ////
+        Multiblock ignorable comment
+      ////
+    INPUT
+      <?xml version="1.0" encoding="US-ASCII"?>
+      <!DOCTYPE rfc SYSTEM "rfc2629.dtd">
+
+      <rfc prepTime="2000-01-01T05:00:00Z"
+                version="3" submissionType="IETF">
+      <front>
+      <title abbrev="abbrev_value">Document title</title>
+      <author fullname="Author"/>
+      <date day="1" month="January" year="2000"/>
+      </front><middle>
+      <section anchor="_section1" numbered="false">
+      <name>Section1</name>
+      <t>Text</t>
+      </section>
+      </middle>
+      </rfc>
+      </rfc>
+    OUTPUT
+  end
+
+  it "uses Asciidoc inline NOTE admonition" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc3, header_footer: true)).to be_equivalent_to <<~'OUTPUT'
+      = Document title
+      :abbrev: abbrev_value
+      :docName:
+      Author
+
+      == Section1
+      Text
+
+      NOTE: This is a note
+    INPUT
+      <?xml version="1.0" encoding="US-ASCII"?>
+      <!DOCTYPE rfc SYSTEM "rfc2629.dtd">
+
+      <rfc submissionType="IETF" prepTime="2000-01-01T05:00:00Z" version="3">
+      <front>
+
+         <title abbrev="abbrev_value">Document title</title>
+
+         <author fullname="Author"/>
+
+
+      <date day="1" month="January" year="2000"/>
+      </front><middle>
+      <section anchor="_section1" numbered="false"><name>Section1</name><t>Text<cref>This is a note</cref></t>
+
+      </section>
+      </middle>
+      </rfc>
+    OUTPUT
+  end
+
+  it "uses any Asciidoc inline admonition" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc3, header_footer: true)).to be_equivalent_to <<~'OUTPUT'
+      = Document title
+      :abbrev: abbrev_value
+      :docName:
+      Author
+
+      == Section1
+      Text
+
+      WARNING: This is a note
+    INPUT
+      <?xml version="1.0" encoding="US-ASCII"?>
+      <!DOCTYPE rfc SYSTEM "rfc2629.dtd">
+
+      <rfc submissionType="IETF" prepTime="2000-01-01T05:00:00Z" version="3">
+      <front>
+
+         <title abbrev="abbrev_value">Document title</title>
+
+         <author fullname="Author"/>
+
+
+      <date day="1" month="January" year="2000"/>
+      </front><middle>
+      <section anchor="_section1" numbered="false"><name>Section1</name><t>Text<cref>This is a note</cref></t>
+
+      </section>
+      </middle>
+      </rfc>
+    OUTPUT
+  end
+
+  it "uses full range of inline formatting within Asciidoc inline admonition" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc3, header_footer: true)).to be_equivalent_to <<~'OUTPUT'
+      = Document title
+      :abbrev: abbrev_value
+      :docName:
+      Author
+
+      [[sect1]]
+      == Section1
+      Text
+
+      WARNING: Text _Text_ *Text* `Text` ~Text~ ^Text^ http://example.com/[linktext] <<ref>> <<crossreference#fragment,section bare: text>>
+
+      [bibliography]
+      == References
+      ++++
+      <reference anchor='ref' target='https://www.iso.org/standard/67116.html'>
+        <front>
+          <title>ISO/IEC FDIS 10118-3 -- Information technology -- Security techniques -- Hash-functions -- Part 3: Dedicated hash-functions</title>
+          <author>
+            <organization>International Organization for Standardization</organization>
+            <address>
+              <postal>
+                <street>BIBC II</street>
+                <street>Chemin de Blandonnet 8</street>
+                <street>CP 401</street>
+                <city>Vernier</city>
+                <region>Geneva</region>
+                <code>1214</code>
+                <country>Switzerland</country>
+              </postal>
+              <phone>+41 22 749 01 11</phone>
+              <email>central@iso.org</email>
+              <uri>https://www.iso.org/</uri>
+            </address>
+          </author>
+          <date day='15' month='September' year='2017'/>
+        </front>
+      </reference>
+      ++++
+    INPUT
+      <?xml version="1.0" encoding="US-ASCII"?>
+      <!DOCTYPE rfc SYSTEM "rfc2629.dtd">
+
+       <rfc submissionType="IETF" prepTime="2000-01-01T05:00:00Z" version="3">
+       <front>
+         <title abbrev="abbrev_value">Document title</title>
+         <author fullname="Author"/>
+         <date day="1" month="January" year="2000"/>
+
+       </front><middle>
+       <section anchor="sect1" numbered="false"><name>Section1</name><t>Text<cref>Text <em>Text</em> <strong>Text</strong> <tt>Text</tt> <sub>Text</sub> <sup>Text</sup> <eref target="http://example.com/">linktext</eref> <xref target="ref"/> <relref relative="fragment" section="section" displayFormat="bare" target="crossreference">text</relref></cref></t>
+       </section>
+       </middle><back>
+       <references anchor="_references">
+       <name>References</name>
+       <reference anchor="ref" target="https://www.iso.org/standard/67116.html">
+         <front>
+           <title>ISO/IEC FDIS 10118-3 -- Information technology -- Security techniques -- Hash-functions -- Part 3: Dedicated hash-functions</title>
+           <author>
+             <organization>International Organization for Standardization</organization>
+             <address>
+               <postal>
+                 <street>BIBC II</street>
+                 <street>Chemin de Blandonnet 8</street>
+                 <street>CP 401</street>
+                 <city>Vernier</city>
+                 <region>Geneva</region>
+                 <code>1214</code>
+                 <country>Switzerland</country>
+               </postal>
+               <phone>+41 22 749 01 11</phone>
+               <email>central@iso.org</email>
+               <uri>https://www.iso.org/</uri>
+             </address>
+           </author>
+           <date day="15" month="September" year="2017"/>
+         </front>
+       </reference>
+       </references>
+       </back>
+      </rfc>
+    OUTPUT
+  end
+
+  it "uses Asciidoc block admonition" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc3, header_footer: true)).to be_equivalent_to <<~'OUTPUT'
+      = Document title
+      :abbrev: abbrev_value
+      :docName:
+      Author
+
+      == Section1
+      Text
+
+      [IMPORTANT]
+      .Feeding the Werewolves
+      ====
+      While werewolves are hardy community members, keep in mind the following dietary concerns:
+
+      . They are allergic to cinnamon.
+      . More than two glasses of orange juice in 24 hours makes them howl in harmony with alarms and sirens.
+      . Celery makes them sad.
+      ====
+    INPUT
+      <?xml version="1.0" encoding="US-ASCII"?>
+      <!DOCTYPE rfc SYSTEM "rfc2629.dtd">
+
+      <rfc prepTime="2000-01-01T05:00:00Z"
+                version="3" submissionType="IETF">
+      <front>
+      <title abbrev="abbrev_value">Document title</title>
+      <author fullname="Author"/>
+      <date day="1" month="January" year="2000"/>
+      </front><middle>
+      <section anchor="_section1" numbered="false">
+      <name>Section1</name>
+      <t>Text
+      <cref>
+      While werewolves are hardy community members, keep in mind the following dietary concerns:
+      They are allergic to cinnamon.
+      More than two glasses of orange juice in 24 hours makes them howl in harmony with alarms and sirens.
+      Celery makes them sad.
+      </cref></t>
+      </section>
+      </middle>
+      </rfc>
+    OUTPUT
+  end
+
+  it "uses all options of the Asciidoc block admonition" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc3, header_footer: true)).to be_equivalent_to <<~'OUTPUT'
+      = Document title
+      :abbrev: abbrev_value
+      :docName:
+      Author
+
+      == Section1
+      Text
+
+      [[id]]
+      [NOTE,display=true,source=GBS]
+      .Note Title
+      ====
+      Any admonition inside the body of the text is a comment.
+      ====
+    INPUT
+      <?xml version="1.0" encoding="US-ASCII"?>
+      <!DOCTYPE rfc SYSTEM "rfc2629.dtd">
+
+      <rfc prepTime="2000-01-01T05:00:00Z"
+                version="3" submissionType="IETF">
+      <front>
+      <title abbrev="abbrev_value">Document title</title>
+      <author fullname="Author">
+      </author>
+      <date day="1" month="January" year="2000"/>
+      </front><middle>
+      <section anchor="_section1" numbered="false">
+      <name>Section1</name>
+      <t>Text
+      <cref anchor="id" display="true" source="GBS">
+      Any admonition inside the body of the text is a comment.
+      </cref></t>
+      </section>
+      </middle>
+      </rfc>
+      </section>
+      </middle>
+      </rfc>
+    OUTPUT
+  end
+
+  it "has a comment at the start of a section" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc3, header_footer: true)).to be_equivalent_to <<~'OUTPUT'
+      = Document title
+      Author
+
+      == Section 1
+      NOTE: This is an initial note
+
+      Text
+    INPUT
+      <?xml version="1.0" encoding="US-ASCII"?>
+      <!DOCTYPE rfc SYSTEM "rfc2629.dtd">
+
+      <rfc submissionType="IETF" prepTime="2000-01-01T05:00:00Z" version="3">
+      <front>
+
+      <title>Document title</title>
+
+      <author fullname="Author"/>
+
+
+      <date day="1" month="January" year="2000"/>
+      </front><middle>
+      <section anchor="_section_1" numbered="false"><name>Section 1</name>
+      <t><cref>This is an initial note</cref></t>
+
+      <t>Text</t></section>
+      </middle>
+      </rfc>
+    OUTPUT
+  end
+end

data/spec/asciidoctor/rfc/v3/crossref_spec.rb

@@ -0,0 +1,269 @@
+require "spec_helper"
+describe Asciidoctor::RFC::V3::Converter do
+  it "renders links" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc3, header_footer: true)).to be_equivalent_to <<~'OUTPUT'
+      = Document title
+      :abbrev: abbrev_value
+      :docName:
+      Author
+
+      == Section 1
+      http://example.com/
+      http://example.com/[linktext]
+    INPUT
+      <?xml version="1.0" encoding="US-ASCII"?>
+      <!DOCTYPE rfc SYSTEM "rfc2629.dtd">
+
+      <rfc prepTime="2000-01-01T05:00:00Z"
+                version="3" submissionType="IETF">
+      <front>
+      <title abbrev="abbrev_value">Document title</title>
+      <author fullname="Author">
+      </author>
+      <date day="1" month="January" year="2000"/>
+      </front><middle>
+      <section anchor="_section_1" numbered="false">
+      <name>Section 1</name>
+      <t><eref target="http://example.com/"></eref>
+      <eref target="http://example.com/">linktext</eref></t>
+      </section>
+      </middle>
+      </rfc>
+    OUTPUT
+  end
+  it "renders cross-references" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc3, header_footer: true)).to be_equivalent_to <<~'OUTPUT'
+      = Document title
+      :abbrev: abbrev_value
+      :docName:
+      Author
+
+      [[crossreference]]
+      == Section 1
+
+      == Section 2
+      See <<crossreference>>.
+
+      == Section 3
+      See <<crossreference,text>>
+
+      == Section 4
+      See <<crossreference,format=counter: text>>
+    INPUT
+      <?xml version="1.0" encoding="US-ASCII"?>
+      <!DOCTYPE rfc SYSTEM "rfc2629.dtd">
+
+      <rfc prepTime="2000-01-01T05:00:00Z"
+                version="3" submissionType="IETF">
+      <front>
+      <title abbrev="abbrev_value">Document title</title>
+      <author fullname="Author">
+      </author>
+      <date day="1" month="January" year="2000"/>
+      </front><middle>
+      <section anchor="crossreference" numbered="false">
+      <name>Section 1</name>
+      </section>
+      <section anchor="_section_2" numbered="false">
+      <name>Section 2</name>
+      <t>See <xref target="crossreference"></xref>.</t>
+      </section>
+      <section anchor="_section_3" numbered="false">
+      <name>Section 3</name>
+      <t>See <xref target="crossreference">text</xref></t>
+      </section>
+      <section anchor="_section_4" numbered="false">
+      <name>Section 4</name>
+      <t>See <xref format="counter" target="crossreference">text</xref></t>
+      </section>
+      </middle>
+      </rfc>
+    OUTPUT
+  end
+  it "renders cross-references to bibliography" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc3, header_footer: true)).to be_equivalent_to <<~'OUTPUT'
+      = Document title
+      :abbrev: abbrev_value
+      :docName:
+      Author
+
+      == Section 1
+
+      == Section 2
+
+      See <<crossreference>>.
+
+      == Section 3
+      See <<crossreference,text>>
+
+      [bibliography]
+      == References
+      ++++
+      <reference anchor='crossreference' target='https://www.iso.org/standard/67116.html'>
+        <front>
+          <title>ISO/IEC FDIS 10118-3 -- Information technology -- Security techniques -- Hash-functions -- Part 3: Dedicated hash-functions</title>
+          <author>
+            <organization>International Organization for Standardization</organization>
+            <address>
+              <postal>
+                <street>BIBC II</street>
+                <street>Chemin de Blandonnet 8</street>
+                <street>CP 401</street>
+                <city>Vernier</city>
+                <region>Geneva</region>
+                <code>1214</code>
+                <country>Switzerland</country>
+              </postal>
+              <phone>+41 22 749 01 11</phone>
+              <email>central@iso.org</email>
+              <uri>https://www.iso.org/</uri>
+            </address>
+          </author>
+          <date day='15' month='September' year='2017'/>
+        </front>
+      </reference>
+      ++++
+    INPUT
+      <?xml version="1.0" encoding="US-ASCII"?>
+      <!DOCTYPE rfc SYSTEM "rfc2629.dtd">
+
+      <rfc prepTime="2000-01-01T05:00:00Z"
+                version="3" submissionType="IETF">
+      <front>
+      <title abbrev="abbrev_value">Document title</title>
+      <author fullname="Author">
+      </author>
+      <date day="1" month="January" year="2000"/>
+      </front><middle>
+      <section anchor="_section_1" numbered="false">
+      <name>Section 1</name>
+      </section>
+      <section anchor="_section_2" numbered="false">
+      <name>Section 2</name>
+      <t>See <xref target="crossreference"></xref>.</t>
+      </section>
+      <section anchor="_section_3" numbered="false">
+      <name>Section 3</name>
+      <t>See <xref target="crossreference">text</xref></t>
+      </section>
+      </middle><back>
+      <references anchor="_references">
+      <name>References</name>
+      <reference anchor='crossreference' target='https://www.iso.org/standard/67116.html'>
+         <front>
+           <title>ISO/IEC FDIS 10118-3 -- Information technology -- Security techniques -- Hash-functions -- Part 3: Dedicated hash-functions</title>
+           <author>
+             <organization>International Organization for Standardization</organization>
+             <address>
+               <postal>
+                 <street>BIBC II</street>
+                 <street>Chemin de Blandonnet 8</street>
+                 <street>CP 401</street>
+                 <city>Vernier</city>
+                 <region>Geneva</region>
+                 <code>1214</code>
+                 <country>Switzerland</country>
+               </postal>
+               <phone>+41 22 749 01 11</phone>
+               <email>central@iso.org</email>
+               <uri>https://www.iso.org/</uri>
+             </address>
+           </author>
+           <date day='15' month='September' year='2017'/>
+         </front>
+      </reference>
+      </references>
+      </back>
+      </rfc>
+    OUTPUT
+  end
+  it "renders relref references" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc3, header_footer: true)).to be_equivalent_to <<~'OUTPUT'
+      = Document title
+      :abbrev: abbrev_value
+      :docName:
+      Author
+
+      == Section 1
+      See <<crossreference,1.3 of>>
+      <<crossreference,1.4 comma: text>>
+      <<crossreference#fragment1,2.5.3 parens>>
+      <<crossreference#fragment2,6.2a bare: text>>
+
+      [bibliography]
+      == References
+      ++++
+      <reference anchor='crossreference' target='https://www.iso.org/standard/67116.html'>
+        <front>
+          <title>ISO/IEC FDIS 10118-3 -- Information technology -- Security techniques -- Hash-functions -- Part 3: Dedicated hash-functions</title>
+          <author>
+            <organization>International Organization for Standardization</organization>
+            <address>
+              <postal>
+                <street>BIBC II</street>
+                <street>Chemin de Blandonnet 8</street>
+                <street>CP 401</street>
+                <city>Vernier</city>
+                <region>Geneva</region>
+                <code>1214</code>
+                <country>Switzerland</country>
+              </postal>
+              <phone>+41 22 749 01 11</phone>
+              <email>central@iso.org</email>
+              <uri>https://www.iso.org/</uri>
+            </address>
+          </author>
+          <date day='15' month='September' year='2017'/>
+        </front>
+      </reference>
+      ++++
+    INPUT
+      <?xml version="1.0" encoding="US-ASCII"?>
+      <!DOCTYPE rfc SYSTEM "rfc2629.dtd">
+
+       <rfc submissionType="IETF" prepTime="2000-01-01T05:00:00Z" version="3">
+       <front>
+         <title abbrev="abbrev_value">Document title</title>
+         <author fullname="Author"/>
+         <date day="1" month="January" year="2000"/>
+
+       </front><middle>
+       <section anchor="_section_1" numbered="false">
+         <name>Section 1</name>
+         <t>See <relref section="1.3" displayFormat="of" target="crossreference"/>
+       <relref section="1.4" displayFormat="comma" target="crossreference">text</relref>
+       <relref relative="fragment1" section="2.5.3" displayFormat="parens" target="crossreference"/>
+       <relref relative="fragment2" section="6.2a" displayFormat="bare" target="crossreference">text</relref></t>
+       </section>
+       </middle><back>
+       <references anchor="_references">
+       <name>References</name>
+       <reference anchor="crossreference" target="https://www.iso.org/standard/67116.html">
+         <front>
+           <title>ISO/IEC FDIS 10118-3 -- Information technology -- Security techniques -- Hash-functions -- Part 3: Dedicated hash-functions</title>
+           <author>
+             <organization>International Organization for Standardization</organization>
+             <address>
+               <postal>
+                 <street>BIBC II</street>
+                 <street>Chemin de Blandonnet 8</street>
+                 <street>CP 401</street>
+                 <city>Vernier</city>
+                 <region>Geneva</region>
+                 <code>1214</code>
+                 <country>Switzerland</country>
+               </postal>
+               <phone>+41 22 749 01 11</phone>
+               <email>central@iso.org</email>
+               <uri>https://www.iso.org/</uri>
+             </address>
+           </author>
+           <date day="15" month="September" year="2017"/>
+         </front>
+       </reference>
+       </references>
+       </back>
+      </rfc>
+    OUTPUT
+  end
+end