savjee / eleventy-plugin-bibtex

Converts Bibtex references to APA notation in HTML

eleventy-plugin-bibtex

Converts Bibtex references to APA notation in HTML

Installation

Install with npm:

npm install --save-dev eleventy-plugin-bibtex

Eleventy configuration

Add to your .eleventy.js config file (depending on the template language you use).

Liquid

eleventyConfig.addPairedShortcode(
  "bibtex", 
  require('eleventy-plugin-bibtex')
);

Nunjucks

eleventyConfig.addPairedAsyncShortcode(
    "bibtex",
    require("eleventy-plugin-bibtex")
);

Usage

In Liquid:

{% bibtex %}
@article{kocher2018spectre,
  title={Spectre Attacks: Exploiting Speculative Execution},
  author={Kocher, Paul and Genkin, Daniel and Gruss, Daniel and Haas, Werner and Hamburg, Mike and Lipp, Moritz and Mangard, Stefan and Prescher, Thomas and Schwarz, Michael and Yarom, Yuval},
  journal={arXiv preprint arXiv:1801.01203},
  year={2018},
  url={https://arxiv.org/pdf/1801.01203},
}
{% endbibtex %}

Will output:

<div data-csl-entry-id="2" class="csl-entry">Kocher, P., Genkin, D., Gruss, D., Haas, W., Hamburg, M., Lipp, M., Mangard, S., Prescher, T., Schwarz, M., &amp; Yarom, Y. (2018). Spectre Attacks: Exploiting Speculative Execution. <i>ArXiv Preprint ArXiv:1801.01203</i>. <a href="https://arxiv.org/pdf/1801.01203" class="no-underline no-underline-url" target="_blank" rel="noopener noreferrer">https://arxiv.org/pdf/1801.01203</a></div>

Notes

• If the output APA contains URLs, it will create actual a hrefs for them using Autolinker.js.

• Bibtex requires unique IDs for all citations. This plugin does not require that, so be aware of possible duplicates.

eleventy-plugin-bibtex's Issues

[object Promise] instead of rendering

Hi, thank you so much for creating this! It's exactly what I'm looking for.

I followed the setup instructions, but instead of getting the HTML for the citation, it's just displaying "[object Promise]" for each citation. Googling around it seems to have something to do with asynchronous loading, but I can't quite work out how to fix it. Any ideas would be wonderful!