asciidoctor-rfc 0.1.0 → 0.2.0

data/spec/asciidoctor/rfc/v2/listing_spec.rb

@@ -0,0 +1,59 @@
+require "spec_helper"
+describe Asciidoctor::RFC::V2::Converter do
+  it "renders a listing block with source attribute, ignoring listing content" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc2)).to be_equivalent_to <<~'OUTPUT'
+      [[literal-id]]
+      .filename.rb
+      [source,ruby,src=http://example.com/ruby.rb,alt=Alt Text]
+      ----
+      def listing(node)
+        result = []
+        result << "<figure>" if node.parent.context != :example
+      end
+      ----
+    INPUT
+      <figure>
+        <artwork name="filename.rb" type="ruby" src="http://example.com/ruby.rb" alt="Alt Text">
+        </artwork>
+      </figure>
+    OUTPUT
+  end
+
+  it "renders a listing block without source attribute" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc2)).to be_equivalent_to <<~'OUTPUT'
+      [[literal-id]]
+      .filename.rb
+      [source,ruby]
+      ----
+      def listing(node)
+        result = []
+        result << "<figure>" if node.parent.context != :example
+      end
+      ----
+    INPUT
+      <figure>
+      <artwork name="filename.rb" type="ruby">
+      def listing(node)
+        result = []
+        result &lt;&lt; "&lt;figure&gt;" if node.parent.context != :example
+      end
+      </artwork>
+      </figure>
+    OUTPUT
+  end
+
+  it "renders a listing paragraph" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc2)).to be_equivalent_to <<~'OUTPUT'
+      [listing]
+      This is an example of a paragraph styled with `listing`.
+      Notice that the monospace markup is preserved in the output.
+    INPUT
+      <figure>
+      <artwork>
+      This is an example of a paragraph styled with `listing`.
+      Notice that the monospace markup is preserved in the output.
+      </artwork>
+      </figure>
+    OUTPUT
+  end
+end

data/spec/asciidoctor/rfc/v2/literal_spec.rb

@@ -0,0 +1,53 @@
+require "spec_helper"
+describe Asciidoctor::RFC::V2::Converter do
+  it "renders a listing" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc2)).to be_equivalent_to <<~'OUTPUT'
+      [[literal-id]]
+      .filename
+      [align=left,alt=alt_text,type=abnf]
+      ....
+        Literal contents.
+      ....
+    INPUT
+      <figure>
+      <artwork align="left" name="filename" type="abnf" alt="alt_text">
+        Literal contents.
+      </artwork>
+      </figure>
+    OUTPUT
+  end
+
+  it "ignores callouts" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc2)).to be_equivalent_to <<~'OUTPUT'
+      [[literal-id]]
+      .filename
+      [align=left,alt=alt_text]
+      ....
+        Literal contents.
+      ....
+      <1> This is a callout
+    INPUT
+      <figure>
+      <artwork align="left" name="filename" alt="alt_text">
+        Literal contents.
+      </artwork>
+      </figure>
+    OUTPUT
+  end
+
+  it "renders stem as a literal" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc2)).to be_equivalent_to <<~'OUTPUT'
+      :stem:
+      [stem]
+      ++++
+      sqrt(4) = 2
+      ++++
+    INPUT
+      <figure>
+      <artwork>
+      sqrt(4) = 2
+      </artwork>
+      </figure>
+    OUTPUT
+  end
+end

data/spec/asciidoctor/rfc/v2/olist_spec.rb

@@ -0,0 +1,147 @@
+require "spec_helper"
+describe Asciidoctor::RFC::V2::Converter do
+  it "renders an ordered list" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc2)).to be_equivalent_to <<~'OUTPUT'
+      [[id]]
+      [counter=idx,arabic]
+      . First
+      . Second
+    INPUT
+      <t>
+      <list counter="idx" style="numbers">
+      <t>First</t>
+      <t>Second</t>
+      </list>
+      </t>
+    OUTPUT
+  end
+
+  it "ignores anchors on ordered list items" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc2)).to be_equivalent_to <<~'OUTPUT'
+      [[id]]
+      [counter=idx,group=5,arabic,spacing=compact]
+      . First
+      . [[id1]] Second
+    INPUT
+      <t>
+      <list counter="idx" style="numbers">
+      <t>First</t>
+      <t> Second</t>
+      </list>
+      </t>
+    OUTPUT
+  end
+
+  it "renders an ordered list with empty style" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc2)).to be_equivalent_to <<~'OUTPUT'
+      [empty]
+      . First
+      . Second
+    INPUT
+      <t>
+      <list style="empty">
+      <t>First</t>
+      <t>Second</t>
+      </list>
+      </t>
+    OUTPUT
+  end
+
+  it "renders an ordered list with custom style" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc2)).to be_equivalent_to <<~'OUTPUT'
+      [format="#%d"]
+      . First
+      . Second
+    INPUT
+      <t>
+      <list style="format #%d">
+      <t>First</t>
+      <t>Second</t>
+      </list>
+      </t>
+    OUTPUT
+  end
+
+  it "renders a nested ordered list" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc2)).to be_equivalent_to <<~'OUTPUT'
+      [[id]]
+      [loweralpha]
+      . First
+      . Second
+      [upperalpha]
+      .. Third
+      .. Fourth
+      . Fifth
+      . Sixth
+    INPUT
+      <t>
+      <list style="letters">
+      <t>First</t>
+      <t>Second
+      <list style="format %C.">
+      <t>Third</t>
+      <t>Fourth</t>
+      </list>
+      </t>
+      <t>Fifth</t>
+      <t>Sixth</t>
+      </list>
+      </t>
+    OUTPUT
+  end
+
+  it "renders a nested ordered/unordered list" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc2)).to be_equivalent_to <<~'OUTPUT'
+      [[id]]
+      [lowerroman]
+      . First
+      . Second
+      ** Third
+      ** Fourth
+    INPUT
+      <t>
+      <list style="format %i.">
+      <t>First</t>
+      <t>Second
+      <list style="symbols">
+      <t>Third</t>
+      <t>Fourth</t>
+      </list>
+      </t>
+      </list>
+      </t>
+    OUTPUT
+  end
+
+  it "renders decimal lists as arabic" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc2)).to be_equivalent_to <<~'OUTPUT'
+      [[id]]
+      [decimal]
+      . First
+      . Second
+    INPUT
+      <t>
+      <list style="numbers">
+      <t>First</t>
+      <t>Second</t>
+      </list>
+      </t>
+    OUTPUT
+  end
+
+  it "renders lowergreek lists as arabic" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc2)).to be_equivalent_to <<~'OUTPUT'
+      [[id]]
+      [lowergreek]
+      . First
+      . Second
+    INPUT
+      <t>
+      <list style="numbers">
+      <t>First</t>
+      <t>Second</t>
+      </list>
+      </t>
+    OUTPUT
+  end
+end

data/spec/asciidoctor/rfc/v2/paragraph_spec.rb

@@ -0,0 +1,68 @@
+require "spec_helper"
+describe Asciidoctor::RFC::V2::Converter do
+  it "renders a paragraph" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc2)).to be_equivalent_to <<~'OUTPUT'
+      = Document title
+      :abbrev: abbrev_value
+      :docName:
+      Author
+
+      == Section 1
+      [[id]]
+      [keep-with-next=true, keep-with-previous=true, foo=bar]
+      Lorem ipsum.
+    INPUT
+      <section anchor="_section_1" title="Section 1">
+      <t anchor="id">Lorem ipsum.</t>
+      </section>
+    OUTPUT
+  end
+
+  it "suppresses smart apostrophes" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc2, header_footer: true)).to be_equivalent_to <<~'OUTPUT'
+      = Document title
+      :abbrev: abbrev_value
+      :smart-quotes: false
+      Author
+
+      == Dante's Revenge
+      Don't panic!
+    INPUT
+      <?xml version="1.0" encoding="US-ASCII"?>
+      <!DOCTYPE rfc SYSTEM "rfc2629.dtd">
+      <?rfc strict="yes"?>
+      <?rfc toc="yes"?>
+      <?rfc tocdepth="4"?>
+      <?rfc symrefs="yes"?>
+      <?rfc sortrefs="yes"?>
+      <?rfc compact="yes"?>
+      <?rfc subcompact="no"?>
+      <rfc submissionType="IETF">
+      <front>
+        <title abbrev="abbrev_value">Document title</title>
+        <author fullname="Author"/>
+        <date day="1" month="January" year="2000"/>
+      </front><middle>
+      <section anchor="_dante_s_revenge" title="Dante's Revenge">
+      <t>Don't panic!</t>
+      </section>
+      </rfc>
+    OUTPUT
+  end
+
+  it "allows smart apostrophes" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc2)).to be_equivalent_to <<~'OUTPUT'
+      = Document title
+      :abbrev: abbrev_value
+      :docName:
+      Author
+
+      == Dante's Revenge
+      Don't panic!
+    INPUT
+      <section anchor="_dante_s_revenge" title="Dante&#8217;s Revenge">
+      <t>Don&#8217;t panic!</t>
+      </section>
+    OUTPUT
+  end
+end

data/spec/asciidoctor/rfc/v2/preamble_spec.rb

@@ -0,0 +1,140 @@
+require "spec_helper"
+describe Asciidoctor::RFC::V2::Converter do
+  it "renders no abstract if preamble has no content" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc2, header_footer: true)).to be_equivalent_to <<~'OUTPUT'
+      = Document title
+      Author
+      :docName:
+
+      == Lorem
+      Ipsum.
+    INPUT
+      <?xml version="1.0" encoding="US-ASCII"?>
+      <!DOCTYPE rfc SYSTEM "rfc2629.dtd">
+
+      <rfc
+               submissionType="IETF">
+      <front>
+      <title>Document title</title>
+      <author fullname="Author"/>
+      <date day="1" month="January" year="2000"/>
+      </front><middle>
+      <section anchor="_lorem" title="Lorem">
+      <t>Ipsum.</t>
+      </section>
+      </middle>
+      </rfc>
+    OUTPUT
+  end
+
+  it "renders preamble contents as abstract" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc2, header_footer: true)).to be_equivalent_to <<~'OUTPUT'
+      = Document title
+      Author
+      :docName:
+
+      Preamble content.
+
+      More Preamble content.
+
+      == Lorem
+      Ipsum.
+    INPUT
+      <?xml version="1.0" encoding="US-ASCII"?>
+      <!DOCTYPE rfc SYSTEM "rfc2629.dtd">
+
+      <rfc
+               submissionType="IETF">
+      <front>
+      <title>Document title</title>
+      <author fullname="Author"/>
+      <date day="1" month="January" year="2000"/>
+      <abstract>
+      <t>Preamble content.</t>
+      <t>More Preamble content.</t>
+      </abstract>
+      </front><middle>
+      <section anchor="_lorem" title="Lorem">
+      <t>Ipsum.</t>
+      </section>
+      </middle>
+      </rfc>
+    OUTPUT
+  end
+
+  it "renders admonitions in preamble as notes" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc2, header_footer: true)).to be_equivalent_to <<~'OUTPUT'
+      = Document title
+      Author
+      :docName:
+
+      [NOTE]
+      .Title of Note
+      ====
+      This is another note.
+      ====
+
+      == Lorem
+      Ipsum.
+    INPUT
+      <?xml version="1.0" encoding="US-ASCII"?>
+      <!DOCTYPE rfc SYSTEM "rfc2629.dtd">
+
+      <rfc
+               submissionType="IETF">
+      <front>
+      <title>Document title</title>
+      <author fullname="Author"/>
+      <date day="1" month="January" year="2000"/>
+      <note title="Title of Note">
+      <t>This is another note.</t>
+      </note>
+      </front><middle>
+      <section anchor="_lorem" title="Lorem">
+      <t>Ipsum.</t>
+      </section>
+      </middle>
+      </rfc>
+    OUTPUT
+  end
+
+  it "supplies default titles for notes" do
+    expect(Asciidoctor.convert(<<~'INPUT', backend: :rfc2, header_footer: true)).to be_equivalent_to <<~'OUTPUT'
+      = Document title
+      Author
+      :docName:
+
+      NOTE: This is a note.
+
+      [NOTE]
+      ====
+      This is another note.
+      ====
+
+      == Lorem
+      Ipsum.
+    INPUT
+      <?xml version="1.0" encoding="US-ASCII"?>
+      <!DOCTYPE rfc SYSTEM "rfc2629.dtd">
+
+      <rfc
+               submissionType="IETF">
+      <front>
+      <title>Document title</title>
+      <author fullname="Author"/>
+      <date day="1" month="January" year="2000"/>
+      <note title="NOTE">
+      <t>This is a note.</t>
+      </note>
+      <note title="NOTE">
+      <t>This is another note.</t>
+      </note>
+      </front><middle>
+      <section anchor="_lorem" title="Lorem">
+      <t>Ipsum.</t>
+      </section>
+      </middle>
+      </rfc>
+    OUTPUT
+  end
+end