asciidoctor-bibliography 0.3.0 → 0.4.0

data/lib/csl/styles/tex-citeyearpar-numeric.csl

@@ -0,0 +1,116 @@
+<?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>TeX style for macro citeyearpar with numeric style</title>
+    <id>tex-citeyearpar-numeric</id>
+  </info>
+  <macro name="author-long">
+    <names variable="author">
+      <name form="short" and="text" initialize="false" sort-separator=""/>
+    </names>
+  </macro>
+  <macro name="author-short">
+    <names variable="author">
+      <name form="short" and="text" et-al-min="2" et-al-use-first="1" et-al-subsequent-min="2" et-al-subsequent-use-first="1"/>
+    </names>
+  </macro>
+  <macro name="locators">
+    <choose>
+      <if type="article-journal article-magazine" match="any">
+        <group prefix=", " delimiter=", ">
+          <group>
+            <text variable="volume" font-style="italic"/>
+            <text variable="issue" prefix="(" suffix=")"/>
+          </group>
+          <text variable="page"/>
+        </group>
+        <choose>
+          <if variable="issued">
+            <choose>
+              <if variable="page issue" match="none">
+                <text variable="status" prefix=". "/>
+              </if>
+            </choose>
+          </if>
+        </choose>
+      </if>
+      <else-if type="article-newspaper">
+        <group delimiter=" " prefix=", ">
+          <label variable="page" form="short"/>
+          <text variable="page"/>
+        </group>
+      </else-if>
+      <else-if type="book graphic motion_picture report song chapter paper-conference entry-encyclopedia entry-dictionary" match="any">
+        <group prefix=" (" suffix=")" delimiter=", ">
+          <choose>
+            <if type="report" match="none">
+              <text macro="edition"/>
+            </if>
+          </choose>
+          <choose>
+            <if variable="volume" match="any">
+              <group>
+                <text term="volume" form="short" text-case="capitalize-first" suffix=" "/>
+                <number variable="volume" form="numeric"/>
+              </group>
+            </if>
+            <else>
+              <group>
+                <text term="volume" form="short" plural="true" text-case="capitalize-first" suffix=" "/>
+                <number variable="number-of-volumes" form="numeric" prefix="1–"/>
+              </group>
+            </else>
+          </choose>
+          <group>
+            <label variable="page" form="short" suffix=" "/>
+            <text variable="page"/>
+          </group>
+        </group>
+      </else-if>
+      <else-if type="legal_case">
+        <group prefix=" (" suffix=")" delimiter=" ">
+          <text variable="authority"/>
+          <choose>
+            <if variable="container-title" match="any">
+              <date variable="issued" form="numeric" date-parts="year"/>
+            </if>
+            <else>
+              <date variable="issued" form="text"/>
+            </else>
+          </choose>
+        </group>
+      </else-if>
+      <else-if type="bill legislation" match="any">
+        <date variable="issued" prefix=" (" suffix=")">
+          <date-part name="year"/>
+        </date>
+      </else-if>
+    </choose>
+  </macro>
+  <macro name="citation-locator">
+    <group>
+      <choose>
+        <if locator="chapter">
+          <label variable="locator" form="long" text-case="capitalize-first"/>
+        </if>
+        <else>
+          <label variable="locator" form="short"/>
+        </else>
+      </choose>
+      <text variable="locator" prefix=" "/>
+    </group>
+  </macro>
+  <citation>
+    <layout delimiter=", " prefix="[" suffix="]">
+      <group>
+        <text variable="prefix" suffix=" "/>
+        <group delimiter=", ">
+          <date date-parts="year" form="numeric" variable="issued"/>
+          <text macro="citation-locator"/>
+        </group>
+        <text variable="suffix" prefix=", "/>
+      </group>
+    </layout>
+  </citation>
+  <bibliography/>
+</style>

data/samples/tex/sample-numbers.adoc

@@ -1,6 +1,6 @@
 = Sample usage of asciidoctor-bibliography
 :bibliography-database: biblio.bib
-:bibliography-tex-style: numbers
+:bibliography-tex-style: numeric
 :bibliography-style: ieee
 
 

data/samples/tex/sample-sort.adoc

@@ -1,6 +1,6 @@
 = Sample usage of asciidoctor-bibliography
 :bibliography-database: biblio.bib
-:bibliography-tex-style: numbers
+:bibliography-tex-style: numeric
 :bibliography-style: ieee
 :bibliography-sort: { macro: author, sort: descending }
 

data/spec/citation_helper.rb

@@ -0,0 +1,46 @@
+# coding: utf-8
+
+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(options)
+  bibliographer = AsciidoctorBibliography::Bibliographer.new
+
+  bibliographer.options = AsciidoctorBibliography::Options.new.
+    merge("bibliography-hyperlinks" => "false").merge(options)
+
+  bibliographer.database = AsciidoctorBibliography::Database.new.
+    concat(::BibTeX.parse(TEST_BIBTEX_DATABASE).to_citeproc)
+
+  bibliographer
+end
+
+def formatted_citation(macro, options: {})
+  bibliographer = init_bibliographer 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

data/spec/citation_item_spec.rb

@@ -1,5 +1,3 @@
-require "asciidoctor-bibliography/helpers"
-
 describe AsciidoctorBibliography::CitationItem do
   describe ".new" do
     it "can be mutely initialized" do

data/spec/csl/styles/tex_citealp_authoryear_spec.rb

@@ -0,0 +1,42 @@
+# coding: utf-8
+
+require_relative "../../citation_helper"
+
+describe "citealp macro with authoryear style" do
+  let(:options) { { "bibliography-tex-style" => "authoryear" } }
+
+  it "formats a single citation" do
+    expect(formatted_citation("citealp:[Erdos65]", options: options)).
+      to eq "Erdős et al., 1965"
+  end
+
+  it "formats a grouped citation" do
+    expect(formatted_citation("citealp:[Erdos65]+[Einstein35]", options: options)).
+      to eq "Erdős et al., 1965; Einstein et al., 1935"
+  end
+
+  it "formats a single citation with a prefix" do
+    expect(formatted_citation("citealp:[Erdos65, prefix=see]", options: options)).
+      to eq "see Erdős et al., 1965"
+  end
+
+  it "formats a single citation with a suffix" do
+    expect(formatted_citation("citealp:[Erdos65, suffix=new edition]", options: options)).
+      to eq "Erdős et al., 1965, new edition"
+  end
+
+  it "formats a single citation with both a prefix and a suffix" do
+    expect(formatted_citation("citealp:[Erdos65, prefix=see, suffix=new edition]", options: options)).
+      to eq "see Erdős et al., 1965, new edition"
+  end
+
+  it "formats a single citation with a standard locator" do
+    expect(formatted_citation("citealp:[Erdos65, page=41-43]", options: options)).
+      to eq "Erdős et al., 1965, pp. 41-43"
+  end
+
+  it "formats a single citation with a custom locator" do
+    expect(formatted_citation("citealp:[Erdos65, locator=somewhere]", options: options)).
+      to eq "Erdős et al., 1965, somewhere"
+  end
+end

data/spec/csl/styles/tex_citealp_numeric_spec.rb

@@ -0,0 +1,42 @@
+# coding: utf-8
+
+require_relative "../../citation_helper"
+
+describe "citealp macro with numeric style" do
+  let(:options) { { "bibliography-tex-style" => "numeric" } }
+
+  it "formats a single citation" do
+    expect(formatted_citation("citealp:[Erdos65]", options: options)).
+      to eq "1"
+  end
+
+  it "formats a grouped citation" do
+    expect(formatted_citation("citealp:[Erdos65]+[Einstein35]", options: options)).
+      to eq "1, 2"
+  end
+
+  it "formats a single citation with a prefix" do
+    expect(formatted_citation("citealp:[Erdos65, prefix=see]", options: options)).
+      to eq "see 1"
+  end
+
+  it "formats a single citation with a suffix" do
+    expect(formatted_citation("citealp:[Erdos65, suffix=new edition]", options: options)).
+      to eq "1, new edition"
+  end
+
+  it "formats a single citation with both a prefix and a suffix" do
+    expect(formatted_citation("citealp:[Erdos65, prefix=see, suffix=new edition]", options: options)).
+      to eq "see 1, new edition"
+  end
+
+  it "formats a single citation with a standard locator" do
+    expect(formatted_citation("citealp:[Erdos65, page=41-43]", options: options)).
+      to eq "1, pp. 41-43"
+  end
+
+  it "formats a single citation with a custom locator" do
+    expect(formatted_citation("citealp:[Erdos65, locator=somewhere]", options: options)).
+      to eq "1, somewhere"
+  end
+end

data/spec/csl/styles/tex_citealps_authoryear_spec.rb

@@ -0,0 +1,42 @@
+# coding: utf-8
+
+require_relative "../../citation_helper"
+
+describe "citealp* macro with authoryear style" do
+  let(:options) { { "bibliography-tex-style" => "authoryear" } }
+
+  it "formats a single citation" do
+    expect(formatted_citation("citealp*:[Erdos65]", options: options)).
+      to eq "Erdős, Heyting, and Brouwer, 1965"
+  end
+
+  it "formats a grouped citation" do
+    expect(formatted_citation("citealp*:[Erdos65]+[Einstein35]", options: options)).
+      to eq "Erdős, Heyting, and Brouwer, 1965; Einstein, Podolsky, and Rosen, 1935"
+  end
+
+  it "formats a single citation with a prefix" do
+    expect(formatted_citation("citealp*:[Erdos65, prefix=see]", options: options)).
+      to eq "see Erdős, Heyting, and Brouwer, 1965"
+  end
+
+  it "formats a single citation with a suffix" do
+    expect(formatted_citation("citealp*:[Erdos65, suffix=new edition]", options: options)).
+      to eq "Erdős, Heyting, and Brouwer, 1965, new edition"
+  end
+
+  it "formats a single citation with both a prefix and a suffix" do
+    expect(formatted_citation("citealp*:[Erdos65, prefix=see, suffix=new edition]", options: options)).
+      to eq "see Erdős, Heyting, and Brouwer, 1965, new edition"
+  end
+
+  it "formats a single citation with a standard locator" do
+    expect(formatted_citation("citealp*:[Erdos65, page=41-43]", options: options)).
+      to eq "Erdős, Heyting, and Brouwer, 1965, pp. 41-43"
+  end
+
+  it "formats a single citation with a custom locator" do
+    expect(formatted_citation("citealp*:[Erdos65, locator=somewhere]", options: options)).
+      to eq "Erdős, Heyting, and Brouwer, 1965, somewhere"
+  end
+end

data/spec/csl/styles/tex_citealps_numeric_spec.rb

@@ -0,0 +1,42 @@
+# coding: utf-8
+
+require_relative "../../citation_helper"
+
+describe "citealp* macro with numeric style" do
+  let(:options) { { "bibliography-tex-style" => "numeric" } }
+
+  it "formats a single citation" do
+    expect(formatted_citation("citealp*:[Erdos65]", options: options)).
+      to eq "1"
+  end
+
+  it "formats a grouped citation" do
+    expect(formatted_citation("citealp*:[Erdos65]+[Einstein35]", options: options)).
+      to eq "1, 2"
+  end
+
+  it "formats a single citation with a prefix" do
+    expect(formatted_citation("citealp*:[Erdos65, prefix=see]", options: options)).
+      to eq "see 1"
+  end
+
+  it "formats a single citation with a suffix" do
+    expect(formatted_citation("citealp*:[Erdos65, suffix=new edition]", options: options)).
+      to eq "1, new edition"
+  end
+
+  it "formats a single citation with both a prefix and a suffix" do
+    expect(formatted_citation("citealp*:[Erdos65, prefix=see, suffix=new edition]", options: options)).
+      to eq "see 1, new edition"
+  end
+
+  it "formats a single citation with a standard locator" do
+    expect(formatted_citation("citealp*:[Erdos65, page=41-43]", options: options)).
+      to eq "1, pp. 41-43"
+  end
+
+  it "formats a single citation with a custom locator" do
+    expect(formatted_citation("citealp*:[Erdos65, locator=somewhere]", options: options)).
+      to eq "1, somewhere"
+  end
+end

data/spec/csl/styles/tex_citealt_authoryear_spec.rb

@@ -0,0 +1,42 @@
+# coding: utf-8
+
+require_relative "../../citation_helper"
+
+describe "citealt macro with authoryear style" do
+  let(:options) { { "bibliography-tex-style" => "authoryear" } }
+
+  it "formats a single citation" do
+    expect(formatted_citation("citealt:[Erdos65]", options: options)).
+      to eq "Erdős et al. 1965"
+  end
+
+  it "formats a grouped citation" do
+    expect(formatted_citation("citealt:[Erdos65]+[Einstein35]", options: options)).
+      to eq "Erdős et al. 1965; Einstein et al. 1935"
+  end
+
+  it "formats a single citation with a prefix" do
+    expect(formatted_citation("citealt:[Erdos65, prefix=see]", options: options)).
+      to eq "Erdős et al. see 1965"
+  end
+
+  it "formats a single citation with a suffix" do
+    expect(formatted_citation("citealt:[Erdos65, suffix=new edition]", options: options)).
+      to eq "Erdős et al. 1965, new edition"
+  end
+
+  it "formats a single citation with both a prefix and a suffix" do
+    expect(formatted_citation("citealt:[Erdos65, prefix=see, suffix=new edition]", options: options)).
+      to eq "Erdős et al. see 1965, new edition"
+  end
+
+  it "formats a single citation with a standard locator" do
+    expect(formatted_citation("citealt:[Erdos65, page=41-43]", options: options)).
+      to eq "Erdős et al. 1965, pp. 41-43"
+  end
+
+  it "formats a single citation with a custom locator" do
+    expect(formatted_citation("citealt:[Erdos65, locator=somewhere]", options: options)).
+      to eq "Erdős et al. 1965, somewhere"
+  end
+end

data/spec/csl/styles/tex_citealt_numeric_spec.rb

@@ -0,0 +1,42 @@
+# coding: utf-8
+
+require_relative "../../citation_helper"
+
+describe "citealt macro with numeric style" do
+  let(:options) { { "bibliography-tex-style" => "numeric" } }
+
+  it "formats a single citation" do
+    expect(formatted_citation("citealt:[Erdos65]", options: options)).
+      to eq "Erdős et al. 1"
+  end
+
+  it "formats a grouped citation" do
+    expect(formatted_citation("citealt:[Erdos65]+[Einstein35]", options: options)).
+      to eq "Erdős et al. 1, Einstein et al. 2"
+  end
+
+  it "formats a single citation with a prefix" do
+    expect(formatted_citation("citealt:[Erdos65, prefix=see]", options: options)).
+      to eq "Erdős et al. see 1"
+  end
+
+  it "formats a single citation with a suffix" do
+    expect(formatted_citation("citealt:[Erdos65, suffix=new edition]", options: options)).
+      to eq "Erdős et al. 1, new edition"
+  end
+
+  it "formats a single citation with both a prefix and a suffix" do
+    expect(formatted_citation("citealt:[Erdos65, prefix=see, suffix=new edition]", options: options)).
+      to eq "Erdős et al. see 1, new edition"
+  end
+
+  it "formats a single citation with a standard locator" do
+    expect(formatted_citation("citealt:[Erdos65, page=41-43]", options: options)).
+      to eq "Erdős et al. 1, pp. 41-43"
+  end
+
+  it "formats a single citation with a custom locator" do
+    expect(formatted_citation("citealt:[Erdos65, locator=somewhere]", options: options)).
+      to eq "Erdős et al. 1, somewhere"
+  end
+end