Top Contributors
-
matthewowen - 2
-
cnunciato - 2
-
LawrenceWoodman - 2
-
tsmango - 2
-
stereobooster - 2
Most Forked
- jekyll_alias_generator - 32
- jekyll-tagging - 30
- jekyll-scholar - 18
- jekyll-tweet-tag - 18
- jekyll-asset_bundler - 18
Most Watched
- jekyll-author-plugin - 10
- Simple-Jekyll-Search - 9
- jekyll-press - 9
- jekyll-scholar - 9
- jekyll_alias_generator - 8
Most Starred
- Simple-Jekyll-Search - 244
- jekyll-scholar - 176
- jekyll-tagging - 104
- jekyll_alias_generator - 102
- jekyll_indextank - 90
Plugin Information
jekyll-citation
Jekyll plugin to parse/render BibTeX-encoded citations included in posts/pages
README.md
jekyll-citation
This is a plugin for Jekyll and Octopress that is designed to render citations encoded in BibTeX as part of posts and pages.
This plugin is based on Pablo Oliveira's bibjekyll plugin and Sylvester Keil's jekyll-scholar gem, but uses neither.
Setup
Install the
citeproc-ruby
andbibtex-ruby
gems.Copy
citation.rb
to your_plugins/
directory (orplugins/
for Octopress)Add the following lines to your
_config.yml
file for Jekyll:
# BibTex Citation plugin
citation:
citation_style: apa
citation_locale: en
- Optionally, you can use other citation styles encoded in the Citation Style Language (CSL). The entire CSL 1.0 Style Repository is available on Github at citation-style-language/styles. For example, if you wanted to use the Chicago Manual of Style "author-date" format, you would save this file locally to
_plugins
and change your_config.yml
to read:
# BibTex Citation plugin
citation:
citation_style: _plugins/chicago-author-date.csl
citation_locale: en
Usage
This plugin parses BibTeX entries that are enclosed in a special Liquid block:
{% bibtex %}
....
{% endbibtex %}
For example:
---
layout: post
title: "Test"
date: 2012-02-26 17:27
comments: true
---
This is an example citation of Brothman's 1991 article.
{% bibtex %}
@article{brothman1991orders,
title={Orders of value: probing the theoretical terms of Archival Practice},
author={Brothman, B.},
journal={Archivaria},
volume={32},
number={1},
year={1991}
}
{% endbibtex %}
As a result you would get the following output (dependent on the templates you use, of course):
<h1>Test</h1>
<p>This is an example citation of Brothman's 1991 article.</p>
<p>Brothman, B. (1991). Orders of value: probing the theoretical terms of Archival Practice. <i>Archivaria</i>, <i>32</i>(1).</p>
License
This plugin is released under the MIT License, the same license as Jekyll.