A bibtex plugin for Jekyll (based on bibtex2html)
TeX Ruby HTML CSS
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
example
CHANGELOG
LICENSE
README.md
bibjekyll.rb
style.bst

README.md

bibjekyll v0.1.1

This plugin interfaces bibtex2html with Jekyll to generate an html bibliography list from bibtex entries. For this to work, the bibtex entries must be enclosed in a special liquid Tag:

{% bibtex _plugins/style.bst bibtex_file.bib %}

where _plugins/style.bst is a bibtex style file (which you can, of course, rename or move to another directory)

and bibtex_file.bib is a bibtex file (its path is relative to the jekyll source file including the bibtex tag).

Setup

  • Install bibtex2html.
  • Copy bibjekyll.rb to your _plugins/ directory.
  • Edit bibjekyll.rb to tweak the options that are passed to bibtex2html.
  • A default style.bst is provided. You can edit it to suit your needs or replace it with any other .bst file.

Example

You can find a short usage example inside the example/ directory (the actual pdf files are missing, so the links will be broken). This code is what I use (with some css minor differences) to generate my own publication list.

Limitations

The options that are passed to bibtex2html can only be changed in the plugin source. We should be able to change them per bibtex block.

License

This plugin is released under the MIT License.

Contributors

Diogo Gomes patched bibjekyll to use tags instead of blocks.

Contributions and Pull Requests are welcome.

Contact

You can reach me at Pablo de Oliveira pablo@sifflez.org.