bibjekyll

bibjekyll

A bibtex plugin for Jekyll (based on bibtex2html)

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.

jekyll logo

Want a Jekyll website built?

Hire a Jekyll developer