asciidoctor-bibliography 0.5.1 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7dde6470c5e7f326deb2ecc7d7b9175fd2b7ccfc
-  data.tar.gz: cda0c89db773026d78546c2c5f9e79b6c04c75fb
+  metadata.gz: ee3b6315f9a710c52dd9b90d032bd6ea5f23c69c
+  data.tar.gz: c4cb88fc6f415e11bf87306ee0cb54f6011ef2c3
 SHA512:
-  metadata.gz: 6781dfeaee1a53ad7029f0dfeed604e8e82b24b38412d52c2a8685eb410375f110f959b1ec2232f4e526d2432f0260b114ae396ec258d49478262d463cf81dbc
-  data.tar.gz: aaa6608f7282f71a412b6696f474d6551d5b0d01873b5ba60ba651d8c0e791343ea7645f158d85d422dd5cc613b0a0389d70204d59c670abe00b2a36f0477ca6
+  metadata.gz: 8027a65944c8da37afa92525556f0a6e651d4a63a262ed68ce4e195ea88d54c5377f89a52b792834bd0493357d3d2e72883f6b601a64986cf6f9fe719eb02777
+  data.tar.gz: 0a3373d5c62e52d8badc699bf122fc46bad03b8a10938e9cca9f1eae89197a4d44b771ddbb2311ad726898e144468e070f7ac603e8e3805aee56a36f69424dfe

data/.oss-guides.rubocop.yml

@@ -74,10 +74,6 @@ Style/Encoding:
   Description: Use UTF-8 as the source file encoding.
   StyleGuide: https://github.com/bbatsov/ruby-style-guide#utf-8
   Enabled: false
-  EnforcedStyle: always
-  SupportedStyles:
-  - when_needed
-  - always
 Naming/FileName:
   Description: Use snake_case for source file names.
   StyleGuide: https://github.com/bbatsov/ruby-style-guide#snake-case-files
@@ -997,10 +993,6 @@ Lint/HandleExceptions:
   Description: Don't suppress exception.
   StyleGuide: https://github.com/bbatsov/ruby-style-guide#dont-hide-exceptions
   Enabled: false
-Lint/InvalidCharacterLiteral:
-  Description: Checks for invalid character literals with a non-escaped whitespace
-    character.
-  Enabled: false
 Lint/LiteralInCondition:
   Description: Checks of literals used in conditions.
   Enabled: false

data/.rubocop.yml

@@ -6,6 +6,8 @@ AllCops:
 # TODO: shorten all lines to 80, as per oss-guides.
 Metrics/LineLength:
   Max: 120
+  Exclude:
+    - 'spec/**/*_spec.rb'
 
 Rails:
   Enabled: false

data/.travis.yml

@@ -1,7 +1,7 @@
 sudo: false
 language: ruby
 rvm:
-  -  2.3.0
+  -  2.3
 before_script:
   - curl -L https://codeclimate.com/downloads/test-reporter/test-reporter-latest-linux-amd64 > ./cc-test-reporter
   - chmod +x ./cc-test-reporter

data/README.adoc

@@ -324,6 +324,22 @@ Accepted values are `authoryear` (default) and `numeric`.
 
 Furthermore, `fullcite` is also available and accepts no parameters except a single reference key.
 
+==== Advanced options
+
+When rendered citations (used at the beginning of a line) or references start with a special character, it might throw off `asciidoctor`. To avoid this an `{empty}` is prepended by default. Using the `bibliography-prepend-empty` you can decide whether to prepend it to citations (`citation`), references (`reference`), both (`true`) or neither (`false`). Default is `true`.
+
+[source,asciidoc]
+----
+:bibliography-prepend-empty: true
+----
+
+Sometimes it is desirable to wrap the rendered citations in a passthrough. Using the `bibliography-passthrough` you can decide whether to wrap citations (`citation`), references (`reference`), both (`true`) or neither (`false`). They are wrapped in an inline passthrough (`+++`). Default is `false`.
+
+[source,asciidoc]
+----
+:bibliography-passthrough: false
+----
+
 == Development
 
 We follow Sandi Metz's Rules for this gem, you can read the

data/asciidoctor-bibliography.gemspec

@@ -40,6 +40,8 @@ Gem::Specification.new do |spec| # rubocop:disable Metrics/BlockLength
   spec.add_dependency "latex-decode", "~> 0.2.2"
   spec.add_dependency "bibtex-ruby", "~> 4.4.4"
 
+  spec.add_dependency "nokogiri", "~> 1.8.1"
+
   spec.add_development_dependency "bundler"
   spec.add_development_dependency "byebug"
   spec.add_development_dependency "rspec"

data/lib/asciidoctor-bibliography.rb

@@ -9,4 +9,9 @@ module AsciidoctorBibliography
   def self.root
     File.dirname __dir__
   end
+
+  def self.csl_styles_root
+    File.join AsciidoctorBibliography.root,
+              "lib/csl/styles"
+  end
 end

data/lib/asciidoctor-bibliography/citation.rb

@@ -20,7 +20,6 @@ module AsciidoctorBibliography
       @uuid = SecureRandom.uuid
       @macro = macro
       @citation_items = []
-      # rubocop:disable Performance/HashEachMethods
       target_and_attributes_list_pairs.compact.each_slice(2).each do |target, attribute_list|
         @citation_items << CitationItem.new do |cite|
           cite.target = target.to_s.empty? ? "default" : target
@@ -31,24 +30,36 @@ module AsciidoctorBibliography
     end
 
     def render(bibliographer)
-      case macro
-      when "cite"
-        render_citation_with_csl(bibliographer)
-      when "fullcite"
-        render_fullcite_with_csl(bibliographer)
-      when *TEX_MACROS
-        filename = ["tex", macro.tr("*", "s"), bibliographer.options.tex_style].join("-")
-        filepath = File.join AsciidoctorBibliography.root, "lib/csl/styles", filename
-        render_citation_with_csl(bibliographer, style: filepath, tex: true)
-      end
+      formatted_citation =
+        case macro
+        when "cite"
+          render_citation_with_csl(bibliographer)
+        when "fullcite"
+          render_fullcite_with_csl(bibliographer)
+        when *TEX_MACROS
+          render_texmacro_with_csl(bibliographer)
+        end
+      wrap_up_citation citation: formatted_citation, bibliographer: bibliographer
+    end
+
+    def wrap_up_citation(citation:, bibliographer:)
+      text = citation.dup
+      # TODO: handle hyperlinks here, maybe?
+      text = ["+++", text, "+++"].join if bibliographer.options.passthrough?(:citation)
+      text.prepend "{empty}" if bibliographer.options.prepend_empty?(:citation)
+      text
+    end
+
+    def render_texmacro_with_csl(bibliographer)
+      filename = ["tex", macro.tr("*", "s"), bibliographer.options.tex_style].join("-")
+      filepath = File.join AsciidoctorBibliography.root, "lib/csl/styles", filename
+      render_citation_with_csl(bibliographer, style: filepath, tex: true)
     end
 
     def render_fullcite_with_csl(bibliographer)
       formatter = Formatter.new(bibliographer.options.style, locale: bibliographer.options.locale)
       prepare_fullcite_item bibliographer, formatter
-      formatted_citation = formatter.render(:bibliography, id: citation_items.first.key).join
-      # We prepend an empty interpolation to avoid interferences w/ standard syntax (e.g. block role is "\n[foo]")
-      "{empty}" + formatted_citation
+      formatter.render(:bibliography, id: citation_items.first.key).join
     end
 
     def prepare_fullcite_item(bibliographer, formatter)
@@ -60,8 +71,7 @@ module AsciidoctorBibliography
       items = prepare_items bibliographer, formatter, tex: tex
       formatted_citation = formatter.engine.renderer.render(items, formatter.engine.style.citation)
       escape_brackets_inside_xref! formatted_citation
-      # We prepend an empty interpolation to avoid interferences w/ standard syntax (e.g. block role is "\n[foo]")
-      "{empty}" + formatted_citation
+      formatted_citation
     end
 
     def escape_brackets_inside_xref!(string)

data/lib/asciidoctor-bibliography/database.rb

@@ -1,4 +1,5 @@
 require_relative "databases/bibtex"
+require_relative "databases/rfc"
 require_relative "errors"
 
 module AsciidoctorBibliography
@@ -30,6 +31,8 @@ module AsciidoctorBibliography
       case fileext
       when *Databases::BibTeX::EXTENSIONS
         Databases::BibTeX.load filepath
+      when *Databases::RFC::EXTENSIONS
+        Databases::RFC.load filepath
       else
         raise Errors::Database::UnsupportedFormat, fileext
       end

data/lib/asciidoctor-bibliography/databases/rfc.rb

@@ -0,0 +1,52 @@
+# coding: utf-8
+
+require "nokogiri"
+
+module AsciidoctorBibliography
+  module Databases
+    module RFC
+      EXTENSIONS = %w[.rfc .xml].freeze
+
+      MONTHS = %w{january february march april may june july
+                  august september october november december}.freeze
+
+      def self.load(filename)
+        ::Nokogiri::XML(File.open(filename)).
+          xpath("//reference").
+          map { |reference_tag| tag_to_citeproc reference_tag }
+      end
+
+      def self.tag_to_citeproc(reference_tag)
+        {
+          "id" => reference_tag.attr("anchor"),
+          "author" => get_author_list(reference_tag),
+          "title" => reference_tag.xpath("//title").first&.text&.strip,
+          "issued" => {
+            "date-parts" => get_date_parts(reference_tag),
+          },
+          # NOTE: we keep the original XML to re-render it when needed
+          "note" => reference_tag.to_xml,
+        }
+      end
+
+      def self.get_date_parts(reference_tag)
+        date_tag = reference_tag.xpath("//date").first
+        year = date_tag&.attr("year")
+        month = date_tag&.attr("month")
+        day = date_tag&.attr("day")
+        month = MONTHS.index(month.downcase) + 1 unless month.nil?
+        [year, month, day].take_while { |date_part| !date_part.nil? }.map(&:to_s)
+      end
+
+      def self.get_author_list(reference_tag)
+        author_tags = reference_tag.xpath("//author")
+        author_tags.map do |author_tag|
+          {
+            "family" => author_tag&.attr("surname"),
+            "given" => author_tag&.attr("initials"),
+          }
+        end
+      end
+    end
+  end
+end

data/lib/asciidoctor-bibliography/index.rb

@@ -18,11 +18,8 @@ module AsciidoctorBibliography
 
       lines = []
       formatter.bibliography.each_with_index do |reference, index|
-        line = "{empty}"
         id = anchor_id "bibliography", target, formatter.data[index].id
-        line << "anchor:#{id}[]"
-        line << reference
-        lines << line
+        lines << wrap_up_reference(reference: reference, id: id, bibliographer: bibliographer)
       end
 
       # Intersperse the lines with empty ones to render as paragraphs.
@@ -31,6 +28,14 @@ module AsciidoctorBibliography
 
     private
 
+    def wrap_up_reference(reference:, id:, bibliographer:)
+      text = reference.dup
+      text.prepend "anchor:#{id}[]" if bibliographer.options.hyperlinks?
+      text = ["+++", reference, "+++"].join if bibliographer.options.passthrough?(:reference)
+      text.prepend "{empty}" if bibliographer.options.prepend_empty?(:reference)
+      text
+    end
+
     def setup_formatter(bibliographer)
       formatter = Formatter.new(bibliographer.options.style, locale: bibliographer.options.locale)
 

data/lib/asciidoctor-bibliography/options.rb

@@ -14,6 +14,8 @@ module AsciidoctorBibliography
       "bibliography-order" => "alphabetical", # TODO: deprecate
       "bibliography-tex-style" => "authoryear",
       "bibliography-sort" => nil,
+      "bibliography-prepend-empty" => "true",
+      "bibliography-passthrough" => "false",
     }.freeze
 
     def initialize
@@ -38,42 +40,42 @@ module AsciidoctorBibliography
     end
 
     def style
-      # Error throwing delegated to CSL library. Seems to have nice messages.
+      # First we check whether an internal style exists to qualify its path.
+      if self["bibliography-style"]
+        filepath = File.join AsciidoctorBibliography.csl_styles_root,
+                             self["bibliography-style"] + ".csl"
+        self["bibliography-style"] = filepath if File.exist? filepath
+      end
+      # Then error throwing is delegated to CSL library.
       self["bibliography-style"] || DEFAULTS["bibliography-style"]
     end
 
     def locale
       value = self["bibliography-locale"] || DEFAULTS["bibliography-locale"]
-      unless CSL::Locale.list.include? value
-        raise Errors::Options::Invalid, <<~MESSAGE
-          Option :bibliography-locale: has an invalid value (#{value}).
-          Allowed values are #{CSL::Locale.list.inspect}.
-        MESSAGE
-      end
+      raise_invalid <<~MESSAGE unless CSL::Locale.list.include? value
+        Option :bibliography-locale: has an invalid value (#{value}).
+        Allowed values are #{CSL::Locale.list.inspect}.
+      MESSAGE
 
       value
     end
 
     def hyperlinks?
       value = self["bibliography-hyperlinks"] || DEFAULTS["bibliography-hyperlinks"]
-      unless %w[true false].include? value
-        raise Errors::Options::Invalid, <<~MESSAGE
-          Option :bibliography-hyperlinks: has an invalid value (#{value}).
-          Allowed values are 'true' and 'false'.
-        MESSAGE
-      end
+      raise_invalid <<~MESSAGE unless %w[true false].include? value
+        Option :bibliography-hyperlinks: has an invalid value (#{value}).
+        Allowed values are 'true' and 'false'.
+      MESSAGE
 
       value == "true"
     end
 
     def database
       value = self["bibliography-database"] || DEFAULTS["bibliography-database"]
-      if value.nil?
-        raise Errors::Options::Missing, <<~MESSAGE
-          Option :bibliography-database: is mandatory.
-          A bibliographic database is required.
-        MESSAGE
-      end
+      raise Errors::Options::Missing, <<~MESSAGE if value.nil?
+        Option :bibliography-database: is mandatory.
+        A bibliographic database is required.
+      MESSAGE
 
       value
     end
@@ -82,7 +84,7 @@ module AsciidoctorBibliography
       begin
         value = YAML.safe_load self["bibliography-sort"].to_s
       rescue Psych::SyntaxError => psych_error
-        raise Errors::Options::Invalid, <<~MESSAGE
+        raise_invalid <<~MESSAGE
           Option :bibliography-sort: is not a valid YAML string: \"#{psych_error}\".
         MESSAGE
       end
@@ -94,23 +96,54 @@ module AsciidoctorBibliography
 
     def tex_style
       value = self["bibliography-tex-style"] || DEFAULTS["bibliography-tex-style"]
-      unless %w[authoryear numeric].include? value
-        raise Errors::Options::Invalid, <<~MESSAGE
-          Option :bibliography-tex-style: has an invalid value (#{value}).
-          Allowed values are 'authoryear' (default) and 'numeric'.
-        MESSAGE
-      end
+      raise_invalid <<~MESSAGE unless %w[authoryear numeric].include? value
+        Option :bibliography-tex-style: has an invalid value (#{value}).
+        Allowed values are 'authoryear' (default) and 'numeric'.
+      MESSAGE
 
       value
     end
 
+    def passthrough?(context)
+      # NOTE: allowed contexts are :citation and :reference
+      value = self["bibliography-passthrough"] || DEFAULTS["bibliography-passthrough"]
+      raise_invalid <<~MESSAGE unless %w[true citations references false].include? value
+        Option :bibliography-passthrough: has an invalid value (#{value}).
+        Allowed values are 'true', 'citations', 'references' and 'false'.
+      MESSAGE
+
+      evaluate_ext_boolean_value_vs_context value: value, context: context
+    end
+
+    def prepend_empty?(context)
+      # NOTE: allowed contexts are :citation and :reference
+      value = self["bibliography-prepend-empty"] || DEFAULTS["bibliography-prepend-empty"]
+      raise_invalid <<~MESSAGE unless %w[true citations references false].include? value
+        Option :bibliography-prepend-empty: has an invalid value (#{value}).
+        Allowed values are 'true', 'citations', 'references' and 'false'.
+      MESSAGE
+
+      evaluate_ext_boolean_value_vs_context value: value, context: context
+    end
+
     private
 
+    def evaluate_ext_boolean_value_vs_context(value:, context:)
+      return true if value.to_s == "true"
+      return false if value.to_s == "false"
+      return context.to_s == "citation" if value.to_s == "citations"
+      return context.to_s == "reference" if value.to_s == "references"
+    end
+
+    def raise_invalid(message)
+      raise Errors::Options::Invalid, message
+    end
+
     def validate_parsed_sort_type!(value)
       return value if value.nil?
       return value if value.is_a?(Array) && value.all? { |v| v.is_a? Hash }
       return [value] if value.is_a? Hash
-      raise Errors::Options::Invalid, <<~MESSAGE
+      raise_invalid <<~MESSAGE
         Option :bibliography-sort: has an invalid value (#{value}).
         Please refer to manual for more info.
       MESSAGE
@@ -120,7 +153,7 @@ module AsciidoctorBibliography
       # TODO: should we restrict these? Double check the CSL spec.
       allowed_keys = %w[variable macro sort names-min names-use-first names-use-last]
       return array unless array.any? { |hash| (hash.keys - allowed_keys).any? }
-      raise Errors::Options::Invalid, <<~MESSAGE
+      raise_invalid <<~MESSAGE
         Option :bibliography-sort: has a value containing invalid keys (#{array}).
         Allowed keys are #{allowed_keys.inspect}.
         Please refer to manual for more info.

data/lib/asciidoctor-bibliography/version.rb

@@ -1,3 +1,3 @@
 module AsciidoctorBibliography
-  VERSION = "0.5.1".freeze
+  VERSION = "0.6.0".freeze
 end

data/lib/csl/styles/rfc-v2.csl

@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="utf-8"?>
+<style xmlns="http://purl.org/net/xbiblio/csl" class="in-text" version="1.0" demote-non-dropping-particle="never">
+  <info>
+    <title>RFC v2 style</title>
+    <id>rfc-v2</id>
+    <updated>2017-11-04T15:15:55+00:00</updated>
+  </info>
+  <macro name="citation-locator">
+    <group>
+      <label variable="locator" text-case="capitalize-first"/>
+      <text variable="locator" prefix=" "/>
+    </group>
+  </macro>
+  <citation>
+    <layout>
+      <group>
+        <group prefix="&lt;xref" suffix="&gt;">
+          <text variable="citation-label" prefix=" target=&quot;" suffix="&quot;"/>
+        </group>
+        <group delimiter=", ">
+          <text variable="citation-label" prefix="[" suffix="]"/>
+          <text macro="citation-locator"/>
+        </group>
+        <text value="&lt;/xref&gt;"/>
+      </group>
+    </layout>
+  </citation>
+  <bibliography>
+    <layout>
+      <text variable="note"/>
+    </layout>
+  </bibliography>
+</style>

data/lib/csl/styles/rfc-v3.csl

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="utf-8"?>
+<style xmlns="http://purl.org/net/xbiblio/csl" class="in-text" version="1.0" demote-non-dropping-particle="never">
+  <info>
+    <title>RFC v3 style</title>
+    <id>rfc-v3</id>
+    <updated>2017-11-04T16:30:44+00:00</updated>
+  </info>
+  <macro name="citation-locator">
+    <group>
+      <label variable="locator" text-case="capitalize-first"/>
+    </group>
+  </macro>
+  <citation>
+    <layout>
+      <group delimiter=" " prefix="&lt;relref " suffix="/&gt;">
+        <text variable="citation-label" prefix="target=&quot;" suffix="&quot;"/>
+        <text variable="locator" prefix="section=&quot;" suffix="&quot;"/>
+      </group>
+    </layout>
+  </citation>
+  <bibliography>
+    <layout>
+      <text variable="note"/>
+    </layout>
+  </bibliography>
+</style>

data/spec/citation_helper.rb

@@ -2,46 +2,41 @@
 
 require "asciidoctor-bibliography"
 
-TEST_BIBTEX_DATABASE = <<~BIBTEX.freeze
-  @article{Erdos65,
-    title = {Some very hard sums},
-    journal={Difficult Maths Today},
-    author={Paul Erdős and Arend Heyting and Luitzen Egbertus Brouwer},
-    year={1965},
-    pages={30}
-  }
-
-  @article{Einstein35,
-    title={Can quantum-mechanical description of physical reality be considered complete?},
-    author={Einstein, Albert and Podolsky, Boris and Rosen, Nathan},
-    journal={Physical review},
-    volume={47},
-    number={10},
-    pages={777},
-    year={1935},
-    publisher={APS}
-  }
-BIBTEX
-
-def init_bibliographer(bibtex_db:, options: {})
+def init_bibliographer(options: {})
   bibliographer = AsciidoctorBibliography::Bibliographer.new
 
-  bibliographer.options = AsciidoctorBibliography::Options.new.
-    merge("bibliography-hyperlinks" => "false").merge(options)
+  opts = options.dup
 
-  bibliographer.database = AsciidoctorBibliography::Database.new.
-    concat(::BibTeX.parse(bibtex_db).to_citeproc)
+  db_path = File.join __dir__, "fixtures", opts.delete("bibliography-database")
+  bibliographer.database = AsciidoctorBibliography::Database.new.append db_path
+
+  bibliographer.options =
+    AsciidoctorBibliography::Options.new.
+    merge(
+      "bibliography-hyperlinks" => "false",
+      "bibliography-prepend-empty" => "false",
+    ).merge(opts)
 
   bibliographer
 end
 
 def formatted_citation(macro, options: {})
-  bibliographer = init_bibliographer bibtex_db: TEST_BIBTEX_DATABASE,
-                                     options: options
+  bibliographer = init_bibliographer options: options
 
   macro.gsub(AsciidoctorBibliography::Citation::REGEXP) do
     citation = AsciidoctorBibliography::Citation.new(*Regexp.last_match.captures)
     bibliographer.add_citation(citation)
     citation.render bibliographer
-  end.gsub(/^{empty}/, "")
+  end
+end
+
+def formatted_bibliography(macro, options: {})
+  bibliographer = init_bibliographer options: options
+  macro.gsub(AsciidoctorBibliography::Citation::REGEXP) do
+    citation = AsciidoctorBibliography::Citation.new(*Regexp.last_match.captures)
+    bibliographer.add_citation(citation)
+    # citation.render bibliographer
+    index = AsciidoctorBibliography::Index.new("bibliography", "", "")
+    index.render(bibliographer).join
+  end
 end

data/spec/citeproc/ruby/formats/adoc_spec.rb

@@ -3,40 +3,11 @@
 require "asciidoctor-bibliography"
 require_relative "../../../citation_helper"
 
-TEST_ADOC_SPEC_DATABASE = <<~BIBTEX.freeze
-  @article{Gettier63,
-    title={Is justified true belief knowledge?},
-    author={Gettier, Edmund L},
-    journal={analysis},
-    volume={23},
-    number={6},
-    pages={121--123},
-    year={1963},
-    publisher={JSTOR}
-  }
-BIBTEX
-
-def formatted_bibliography(macro, options: {})
-  bibliographer = init_bibliographer bibtex_db: TEST_ADOC_SPEC_DATABASE,
-                                     options: options
-
-  bibliographer.
-    add_citation AsciidoctorBibliography::Citation.new("cite", "", "Gettier63")
-
-  entries = macro.lines.map do |line|
-    return line unless line =~ AsciidoctorBibliography::Index::REGEXP
-    index = AsciidoctorBibliography::Index.new(*Regexp.last_match.captures)
-    index.render bibliographer
-  end
-
-  entries.flatten.map! { |ref| ref.gsub(/^{empty}anchor:.*?\[\]/, "") }
-end
-
 describe "custom :adoc citeproc format" do
-  let(:options) { { "bibliography-style" => "ieee" } }
+  let(:options) { { "bibliography-style" => "ieee", "bibliography-database" => "database.bib" } }
 
   it "adds space between first and second field" do
-    expect(formatted_bibliography("bibliography::[]", options: options).first).
+    expect(formatted_bibliography("cite:[Gettier63]", options: options)).
       to eq "[1] E. L. Gettier, “Is justified true belief knowledge?,” _analysis_, vol. 23, no. 6, pp. 121–123, 1963."
   end
 end

data/spec/csl/styles/rfc_v2_spec.rb

@@ -0,0 +1,22 @@
+# coding: utf-8
+
+require_relative "../../citation_helper"
+
+describe "cite macro with rfc-v2 style" do
+  let(:options) { { "bibliography-style" => "rfc-v2", "bibliography-database" => "database.rfc.xml", "bibliography-passthrough" => "true", "bibliography-prepend-empty" => "false" } }
+
+  it "formats a single citation" do
+    expect(formatted_citation("cite:[RFC2119]", options: options)).
+      to eq '+++<xref target="RFC2119">[RFC2119]</xref>+++'
+  end
+
+  it "formats a single citation with locator" do
+    expect(formatted_citation("cite:[RFC2119, section=1.2.3]", options: options)).
+      to eq '+++<xref target="RFC2119">[RFC2119], Section 1.2.3</xref>+++'
+  end
+
+  it "formats a single bibliography entry" do
+    expect(formatted_bibliography("cite:[RFC2119]", options: options)).
+      to eq '+++<reference anchor="RFC2119" target="https://www.rfc-editor.org/info/rfc2119"><front><title>Key words for use in RFCs to Indicate Requirement Levels</title><author initials="S." surname="Bradner" fullname="S. Bradner"><organization/></author><date year="1997" month="March"/><abstract><t>In many standards track documents several words are used to signify the requirements in the specification. These words are often capitalized. This document defines these words as they should be interpreted in IETF documents. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.</t></abstract></front><seriesInfo name="BCP" value="14"/><seriesInfo name="RFC" value="2119"/><seriesInfo name="DOI" value="10.17487/RFC2119"/></reference>+++'
+  end
+end

data/spec/csl/styles/rfc_v3_spec.rb

@@ -0,0 +1,22 @@
+# coding: utf-8
+
+require_relative "../../citation_helper"
+
+describe "cite macro with rfc-v3 style" do
+  let(:options) { { "bibliography-style" => "rfc-v3", "bibliography-database" => "database.rfc.xml", "bibliography-passthrough" => "true", "bibliography-prepend-empty" => "false" } }
+
+  it "formats a single citation" do
+    expect(formatted_citation("cite:[RFC2119]", options: options)).
+      to eq '+++<relref target="RFC2119"/>+++'
+  end
+
+  it "formats a single citation with locator" do
+    expect(formatted_citation("cite:[RFC2119, section=1.2.3]", options: options)).
+      to eq '+++<relref target="RFC2119" section="1.2.3"/>+++'
+  end
+
+  it "formats a single bibliography entry" do
+    expect(formatted_bibliography("cite:[RFC2119]", options: options)).
+      to eq '+++<reference anchor="RFC2119" target="https://www.rfc-editor.org/info/rfc2119"><front><title>Key words for use in RFCs to Indicate Requirement Levels</title><author initials="S." surname="Bradner" fullname="S. Bradner"><organization/></author><date year="1997" month="March"/><abstract><t>In many standards track documents several words are used to signify the requirements in the specification. These words are often capitalized. This document defines these words as they should be interpreted in IETF documents. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.</t></abstract></front><seriesInfo name="BCP" value="14"/><seriesInfo name="RFC" value="2119"/><seriesInfo name="DOI" value="10.17487/RFC2119"/></reference>+++'
+  end
+end

data/spec/csl/styles/tex_citealp_authoryear_spec.rb

@@ -3,7 +3,7 @@
 require_relative "../../citation_helper"
 
 describe "citealp macro with authoryear style" do
-  let(:options) { { "bibliography-tex-style" => "authoryear" } }
+  let(:options) { { "bibliography-tex-style" => "authoryear", "bibliography-database" => "database.bib" } }
 
   it "formats a single citation" do
     expect(formatted_citation("citealp:[Erdos65]", options: options)).

data/spec/csl/styles/tex_citealp_numeric_spec.rb

@@ -3,7 +3,7 @@
 require_relative "../../citation_helper"
 
 describe "citealp macro with numeric style" do
-  let(:options) { { "bibliography-tex-style" => "numeric" } }
+  let(:options) { { "bibliography-tex-style" => "numeric", "bibliography-database" => "database.bib" } }
 
   it "formats a single citation" do
     expect(formatted_citation("citealp:[Erdos65]", options: options)).

data/spec/csl/styles/tex_citealps_authoryear_spec.rb

@@ -3,7 +3,7 @@
 require_relative "../../citation_helper"
 
 describe "citealp* macro with authoryear style" do
-  let(:options) { { "bibliography-tex-style" => "authoryear" } }
+  let(:options) { { "bibliography-tex-style" => "authoryear", "bibliography-database" => "database.bib" } }
 
   it "formats a single citation" do
     expect(formatted_citation("citealp*:[Erdos65]", options: options)).

data/spec/csl/styles/tex_citealps_numeric_spec.rb

@@ -3,7 +3,7 @@
 require_relative "../../citation_helper"
 
 describe "citealp* macro with numeric style" do
-  let(:options) { { "bibliography-tex-style" => "numeric" } }
+  let(:options) { { "bibliography-tex-style" => "numeric", "bibliography-database" => "database.bib" } }
 
   it "formats a single citation" do
     expect(formatted_citation("citealp*:[Erdos65]", options: options)).

data/spec/csl/styles/tex_citealt_authoryear_spec.rb

@@ -3,7 +3,7 @@
 require_relative "../../citation_helper"
 
 describe "citealt macro with authoryear style" do
-  let(:options) { { "bibliography-tex-style" => "authoryear" } }
+  let(:options) { { "bibliography-tex-style" => "authoryear", "bibliography-database" => "database.bib" } }
 
   it "formats a single citation" do
     expect(formatted_citation("citealt:[Erdos65]", options: options)).

data/spec/csl/styles/tex_citealt_numeric_spec.rb

@@ -3,7 +3,7 @@
 require_relative "../../citation_helper"
 
 describe "citealt macro with numeric style" do
-  let(:options) { { "bibliography-tex-style" => "numeric" } }
+  let(:options) { { "bibliography-tex-style" => "numeric", "bibliography-database" => "database.bib" } }
 
   it "formats a single citation" do
     expect(formatted_citation("citealt:[Erdos65]", options: options)).

data/spec/csl/styles/tex_citealts_authoryear_spec.rb

@@ -3,7 +3,7 @@
 require_relative "../../citation_helper"
 
 describe "citealt* macro with authoryear style" do
-  let(:options) { { "bibliography-tex-style" => "authoryear" } }
+  let(:options) { { "bibliography-tex-style" => "authoryear", "bibliography-database" => "database.bib" } }
 
   it "formats a single citation" do
     expect(formatted_citation("citealt*:[Erdos65]", options: options)).

data/spec/csl/styles/tex_citealts_numeric_spec.rb

@@ -3,7 +3,7 @@
 require_relative "../../citation_helper"
 
 describe "citealt* macro with numeric style" do
-  let(:options) { { "bibliography-tex-style" => "numeric" } }
+  let(:options) { { "bibliography-tex-style" => "numeric", "bibliography-database" => "database.bib" } }
 
   it "formats a single citation" do
     expect(formatted_citation("citealt*:[Erdos65]", options: options)).

data/spec/csl/styles/tex_citeauthor_authoryear_spec.rb

@@ -3,7 +3,7 @@
 require_relative "../../citation_helper"
 
 describe "citeauthor macro with authoryear style" do
-  let(:options) { { "bibliography-tex-style" => "authoryear" } }
+  let(:options) { { "bibliography-tex-style" => "authoryear", "bibliography-database" => "database.bib" } }
 
   it "formats a single citation" do
     expect(formatted_citation("citeauthor:[Erdos65]", options: options)).

data/spec/csl/styles/tex_citeauthor_numeric_spec.rb

@@ -3,7 +3,7 @@
 require_relative "../../citation_helper"
 
 describe "citeauthor macro with numeric style" do
-  let(:options) { { "bibliography-tex-style" => "numeric" } }
+  let(:options) { { "bibliography-tex-style" => "numeric", "bibliography-database" => "database.bib" } }
 
   it "formats a single citation" do
     expect(formatted_citation("citeauthor:[Erdos65]", options: options)).

data/spec/csl/styles/tex_citeauthors_authoryear_spec.rb

@@ -3,7 +3,7 @@
 require_relative "../../citation_helper"
 
 describe "citeauthor* macro with authoryear style" do
-  let(:options) { { "bibliography-tex-style" => "authoryear" } }
+  let(:options) { { "bibliography-tex-style" => "authoryear", "bibliography-database" => "database.bib" } }
 
   it "formats a single citation" do
     expect(formatted_citation("citeauthor*:[Erdos65]", options: options)).

data/spec/csl/styles/tex_citeauthors_numeric_spec.rb

@@ -3,7 +3,7 @@
 require_relative "../../citation_helper"
 
 describe "citeauthor* macro with numeric style" do
-  let(:options) { { "bibliography-tex-style" => "numeric" } }
+  let(:options) { { "bibliography-tex-style" => "numeric", "bibliography-database" => "database.bib" } }
 
   it "formats a single citation" do
     expect(formatted_citation("citeauthor*:[Erdos65]", options: options)).

data/spec/csl/styles/tex_citep_authoryear_spec.rb

@@ -3,7 +3,7 @@
 require_relative "../../citation_helper"
 
 describe "citep macro with authoryear style" do
-  let(:options) { { "bibliography-tex-style" => "authoryear" } }
+  let(:options) { { "bibliography-tex-style" => "authoryear", "bibliography-database" => "database.bib" } }
 
   it "formats a single citation" do
     expect(formatted_citation("citep:[Erdos65]", options: options)).

data/spec/csl/styles/tex_citep_numeric_spec.rb

@@ -3,7 +3,7 @@
 require_relative "../../citation_helper"
 
 describe "citep macro with numeric style" do
-  let(:options) { { "bibliography-tex-style" => "numeric" } }
+  let(:options) { { "bibliography-tex-style" => "numeric", "bibliography-database" => "database.bib" } }
 
   it "formats a single citation" do
     expect(formatted_citation("citep:[Erdos65]", options: options)).

data/spec/csl/styles/tex_citeps_authoryear_spec.rb

@@ -3,7 +3,7 @@
 require_relative "../../citation_helper"
 
 describe "citep* macro with authoryear style" do
-  let(:options) { { "bibliography-tex-style" => "authoryear" } }
+  let(:options) { { "bibliography-tex-style" => "authoryear", "bibliography-database" => "database.bib" } }
 
   it "formats a single citation" do
     expect(formatted_citation("citep*:[Erdos65]", options: options)).

data/spec/csl/styles/tex_citeps_numeric_spec.rb

@@ -3,7 +3,7 @@
 require_relative "../../citation_helper"
 
 describe "citep* macro with numeric style" do
-  let(:options) { { "bibliography-tex-style" => "numeric" } }
+  let(:options) { { "bibliography-tex-style" => "numeric", "bibliography-database" => "database.bib" } }
 
   it "formats a single citation" do
     expect(formatted_citation("citep*:[Erdos65]", options: options)).

data/spec/csl/styles/tex_citet_authoryear_spec.rb

@@ -3,7 +3,7 @@
 require_relative "../../citation_helper"
 
 describe "citet macro with authoryear style" do
-  let(:options) { { "bibliography-tex-style" => "authoryear" } }
+  let(:options) { { "bibliography-tex-style" => "authoryear", "bibliography-database" => "database.bib" } }
 
   it "formats a single citation" do
     expect(formatted_citation("citet:[Erdos65]", options: options)).

data/spec/csl/styles/tex_citet_numeric_spec.rb

@@ -3,7 +3,7 @@
 require_relative "../../citation_helper"
 
 describe "citet macro with numeric style" do
-  let(:options) { { "bibliography-tex-style" => "numeric" } }
+  let(:options) { { "bibliography-tex-style" => "numeric", "bibliography-database" => "database.bib" } }
 
   it "formats a single citation" do
     expect(formatted_citation("citet:[Erdos65]", options: options)).

data/spec/csl/styles/tex_citets_authoryear_spec.rb

@@ -3,7 +3,7 @@
 require_relative "../../citation_helper"
 
 describe "citet* macro with authoryear style" do
-  let(:options) { { "bibliography-tex-style" => "authoryear" } }
+  let(:options) { { "bibliography-tex-style" => "authoryear", "bibliography-database" => "database.bib" } }
 
   it "formats a single citation" do
     expect(formatted_citation("citet*:[Erdos65]", options: options)).

data/spec/csl/styles/tex_citets_numeric_spec.rb

@@ -3,7 +3,7 @@
 require_relative "../../citation_helper"
 
 describe "citet* macro with numeric style" do
-  let(:options) { { "bibliography-tex-style" => "numeric" } }
+  let(:options) { { "bibliography-tex-style" => "numeric", "bibliography-database" => "database.bib" } }
 
   it "formats a single citation" do
     expect(formatted_citation("citet*:[Erdos65]", options: options)).

data/spec/csl/styles/tex_citeyear_authoryear_spec.rb

@@ -3,7 +3,7 @@
 require_relative "../../citation_helper"
 
 describe "citeyear macro with authoryear style" do
-  let(:options) { { "bibliography-tex-style" => "authoryear" } }
+  let(:options) { { "bibliography-tex-style" => "authoryear", "bibliography-database" => "database.bib" } }
 
   it "formats a single citation" do
     expect(formatted_citation("citeyear:[Erdos65]", options: options)).

data/spec/csl/styles/tex_citeyear_numeric_spec.rb

@@ -3,7 +3,7 @@
 require_relative "../../citation_helper"
 
 describe "citeyear macro with numeric style" do
-  let(:options) { { "bibliography-tex-style" => "numeric" } }
+  let(:options) { { "bibliography-tex-style" => "numeric", "bibliography-database" => "database.bib" } }
 
   it "formats a single citation" do
     expect(formatted_citation("citeyear:[Erdos65]", options: options)).

data/spec/csl/styles/tex_citeyearpar_authoryear_spec.rb

@@ -3,7 +3,7 @@
 require_relative "../../citation_helper"
 
 describe "citeyearpar macro with authoryear style" do
-  let(:options) { { "bibliography-tex-style" => "authoryear" } }
+  let(:options) { { "bibliography-tex-style" => "authoryear", "bibliography-database" => "database.bib" } }
 
   it "formats a single citation" do
     expect(formatted_citation("citeyearpar:[Erdos65]", options: options)).

data/spec/csl/styles/tex_citeyearpar_numeric_spec.rb

@@ -3,7 +3,7 @@
 require_relative "../../citation_helper"
 
 describe "citeyearpar macro with numeric style" do
-  let(:options) { { "bibliography-tex-style" => "numeric" } }
+  let(:options) { { "bibliography-tex-style" => "numeric", "bibliography-database" => "database.bib" } }
 
   it "formats a single citation" do
     expect(formatted_citation("citeyearpar:[Erdos65]", options: options)).

data/spec/fixtures/database.bib

@@ -29,3 +29,55 @@
 	pages = {1036--1060},
 	year = {2004}
 }
+
+@article{Erdos65,
+  title = {Some very hard sums},
+  journal={Difficult Maths Today},
+  author={Paul Erdős and Arend Heyting and Luitzen Egbertus Brouwer},
+  year={1965},
+  pages={30}
+}
+
+@article{Einstein35,
+  title={Can quantum-mechanical description of physical reality be considered complete?},
+  author={Einstein, Albert and Podolsky, Boris and Rosen, Nathan},
+  journal={Physical review},
+  volume={47},
+  number={10},
+  pages={777},
+  year={1935},
+  publisher={APS}
+}
+
+@article{Gettier63,
+  title={Is justified true belief knowledge?},
+  author={Gettier, Edmund L},
+  journal={analysis},
+  volume={23},
+  number={6},
+  pages={121--123},
+  year={1963},
+  publisher={JSTOR}
+}
+
+@techreport{iso:31000,
+  author = {ISO},
+  institution = {International Organization for Standardization},
+  address = {Geneva, Switzerland},
+  title = {Risk management---Principles and guidelines},
+  number = {31000:2009},
+  shorthand = {ISO 31000:2009},
+  type = {ISO},
+  year = {2009}
+}
+
+@techreport{iso:guide73,
+  author = {ISO},
+  institution = {International Organization for Standardization},
+  address = {Geneva, Switzerland},
+  title = {Risk management---Vocabulary},
+  number = {73:2009(E/F)},
+  shorthand = {ISO Guide 73:2009},
+  type = {ISO Guide},
+  year = {2013}
+}

data/spec/fixtures/database.rfc.xml

@@ -0,0 +1,86 @@
+<references>
+<reference anchor="RFC2119" target="https://www.rfc-editor.org/info/rfc2119">
+<front>
+<title>
+Key words for use in RFCs to Indicate Requirement Levels
+</title>
+<author initials="S." surname="Bradner" fullname="S. Bradner">
+<organization/>
+</author>
+<date year="1997" month="March"/>
+<abstract>
+<t>
+In many standards track documents several words are used to signify the requirements in the specification. These words are often capitalized. This document defines these words as they should be interpreted in IETF documents. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.
+</t>
+</abstract>
+</front>
+<seriesInfo name="BCP" value="14"/>
+<seriesInfo name="RFC" value="2119"/>
+<seriesInfo name="DOI" value="10.17487/RFC2119"/>
+</reference>
+<reference anchor="RFC2629" target="https://www.rfc-editor.org/info/rfc2629">
+<front>
+<title>Writing I-Ds and RFCs using XML</title>
+<author initials="M." surname="Rose" fullname="M. Rose">
+<organization/>
+</author>
+<date year="1999" month="June"/>
+<abstract>
+<t>
+This memo presents a technique for using XML (Extensible Markup Language) as a source format for documents in the Internet-Drafts (I-Ds) and Request for Comments (RFC) series. This memo provides information for the Internet community.
+</t>
+</abstract>
+</front>
+<seriesInfo name="RFC" value="2629"/>
+<seriesInfo name="DOI" value="10.17487/RFC2629"/>
+</reference>
+<reference anchor="RFC3552" target="https://www.rfc-editor.org/info/rfc3552">
+<front>
+<title>
+Guidelines for Writing RFC Text on Security Considerations
+</title>
+<author initials="E." surname="Rescorla" fullname="E. Rescorla">
+<organization/>
+</author>
+<author initials="B." surname="Korver" fullname="B. Korver">
+<organization/>
+</author>
+<date year="2003" month="July"/>
+<abstract>
+<t>
+All RFCs are required to have a Security Considerations section. Historically, such sections have been relatively weak. This document provides guidelines to RFC authors on how to write a good Security Considerations section. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.
+</t>
+</abstract>
+</front>
+<seriesInfo name="BCP" value="72"/>
+<seriesInfo name="RFC" value="3552"/>
+<seriesInfo name="DOI" value="10.17487/RFC3552"/>
+</reference>
+<reference anchor="RFC5226" target="https://www.rfc-editor.org/info/rfc5226">
+<front>
+<title>
+Guidelines for Writing an IANA Considerations Section in RFCs
+</title>
+<author initials="T." surname="Narten" fullname="T. Narten">
+<organization/>
+</author>
+<author initials="H." surname="Alvestrand" fullname="H. Alvestrand">
+<organization/>
+</author>
+<date year="2008" month="May"/>
+<abstract>
+<t>
+Many protocols make use of identifiers consisting of constants and other well-known values. Even after a protocol has been defined and deployment has begun, new values may need to be assigned (e.g., for a new option type in DHCP, or a new encryption or authentication transform for IPsec). To ensure that such quantities have consistent values and interpretations across all implementations, their assignment must be administered by a central authority. For IETF protocols, that role is provided by the Internet Assigned Numbers Authority (IANA).
+</t>
+<t>
+In order for IANA to manage a given namespace prudently, it needs guidelines describing the conditions under which new values can be assigned or when modifications to existing values can be made. If IANA is expected to play a role in the management of a namespace, IANA must be given clear and concise instructions describing that role. This document discusses issues that should be considered in formulating a policy for assigning values to a namespace and provides guidelines for authors on the specific text that must be included in documents that place demands on IANA.
+</t>
+<t>
+This document obsoletes RFC 2434. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.
+</t>
+</abstract>
+</front>
+<seriesInfo name="RFC" value="5226"/>
+<seriesInfo name="DOI" value="10.17487/RFC5226"/>
+</reference>
+</references>

data/spec/macros_spec.rb

@@ -6,6 +6,7 @@ describe "cite macro with apa style" do
   it "formats a complex citation" do
     expect(formatted_citation("cite:[Erdos65, prefix=see]+[Einstein35, page=41-43]",
                               options: { "bibliography-style" => "apa",
+                                         "bibliography-database" => "database.bib",
                                          "bibliography-hyperlinks" => "true" })).
       to eq "(xref:bibliography-default-Einstein35[Einstein, Podolsky, & Rosen, 1935, pp. 41-43]; " +
       "xref:bibliography-default-Erdos65[seeErdős, Heyting, & Brouwer, 1965])"
@@ -15,7 +16,8 @@ end
 describe "fullcite macro with apa style" do
   it "formats a complex citation" do
     expect(formatted_citation("fullcite:[Erdos65]",
-                              options: { "bibliography-style" => "apa" })).
+                              options: { "bibliography-style" => "apa",
+                                         "bibliography-database" => "database.bib" })).
       to eq "Erdős, P., Heyting, A., & Brouwer, L. E. (1965). Some very hard sums. _Difficult Maths Today_, 30."
   end
 end

data/spec/options_spec.rb

@@ -12,6 +12,54 @@ describe AsciidoctorBibliography::Options do
     end
   end
 
+  describe "#prepend_empty?" do
+    it "defaults to true" do
+      expect(described_class.new.prepend_empty?(:citation)).to be true
+      expect(described_class.new.prepend_empty?(:reference)).to be true
+    end
+
+    it "returns true when provided option is true" do
+      expect(described_class.new.merge("bibliography-prepend-empty" => "true").
+               prepend_empty?(:citation)).to be true
+      expect(described_class.new.merge("bibliography-prepend-empty" => "true").
+               prepend_empty?(:reference)).to be true
+    end
+
+    it "returns true for citations when provided option is citations" do
+      expect(described_class.new.merge("bibliography-prepend-empty" => "citations").
+               prepend_empty?(:citation)).to be true
+      expect(described_class.new.merge("bibliography-prepend-empty" => "citations").
+               prepend_empty?(:reference)).to be false
+    end
+
+    it "returns true for references when provided option is references" do
+      expect(described_class.new.merge("bibliography-prepend-empty" => "references").
+               prepend_empty?(:citation)).to be false
+      expect(described_class.new.merge("bibliography-prepend-empty" => "references").
+               prepend_empty?(:reference)).to be true
+    end
+
+    it "returns false when provided option is false" do
+      expect(described_class.new.merge("bibliography-prepend-empty" => "false").
+               prepend_empty?(:citation)).to be false
+      expect(described_class.new.merge("bibliography-prepend-empty" => "false").
+               prepend_empty?(:reference)).to be false
+    end
+
+    it "raises an error when provided option is invalid" do
+      expect do
+        described_class.new.merge("bibliography-prepend-empty" => "foo").
+          prepend_empty?(:citation)
+      end.
+        to raise_exception AsciidoctorBibliography::Errors::Options::Invalid
+      expect do
+        described_class.new.merge("bibliography-prepend-empty" => "foo").
+          prepend_empty?(:reference)
+      end.
+        to raise_exception AsciidoctorBibliography::Errors::Options::Invalid
+    end
+  end
+
   describe "#hyperlinks?" do
     it "defaults to true" do
       expect(described_class.new.hyperlinks?).to be true

data/spec/sanity_spec.rb

@@ -1,3 +1,4 @@
+require "tmpdir"
 require "asciidoctor"
 
 def setup_tmpdir(method_name = :tmpdir)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: asciidoctor-bibliography
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.6.0
 platform: ruby
 authors:
 - Ribose Inc.
@@ -80,6 +80,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 4.4.4
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.8.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.8.1
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -219,12 +233,15 @@ files:
 - lib/asciidoctor-bibliography/citation_item.rb
 - lib/asciidoctor-bibliography/database.rb
 - lib/asciidoctor-bibliography/databases/bibtex.rb
+- lib/asciidoctor-bibliography/databases/rfc.rb
 - lib/asciidoctor-bibliography/errors.rb
 - lib/asciidoctor-bibliography/formatter.rb
 - lib/asciidoctor-bibliography/index.rb
 - lib/asciidoctor-bibliography/options.rb
 - lib/asciidoctor-bibliography/version.rb
 - lib/citeproc/ruby/formats/adoc.rb
+- lib/csl/styles/rfc-v2.csl
+- lib/csl/styles/rfc-v3.csl
 - lib/csl/styles/tex-citealp-authoryear.csl
 - lib/csl/styles/tex-citealp-numeric.csl
 - lib/csl/styles/tex-citealps-authoryear.csl
@@ -268,6 +285,8 @@ files:
 - spec/citation_helper.rb
 - spec/citation_item_spec.rb
 - spec/citeproc/ruby/formats/adoc_spec.rb
+- spec/csl/styles/rfc_v2_spec.rb
+- spec/csl/styles/rfc_v3_spec.rb
 - spec/csl/styles/tex_citealp_authoryear_spec.rb
 - spec/csl/styles/tex_citealp_numeric_spec.rb
 - spec/csl/styles/tex_citealps_authoryear_spec.rb
@@ -295,6 +314,7 @@ files:
 - spec/database_spec.rb
 - spec/fixtures/database.bib
 - spec/fixtures/database.bibtex
+- spec/fixtures/database.rfc.xml
 - spec/fixtures/database.unk
 - spec/macros_spec.rb
 - spec/options_spec.rb