README.md

Formatted Reference Links for Jupyter Notebooks based on .bib Files

Example

Output gives <a href=http://dx.doi.org/...></a> link to the original paper with title text full citation:

Nanocrystals, such as those produced by Zhang et. al., 2012 posses interesting interfacial chemistry.

This exact reference used in custom_bibliography.js can be found here.

Installation

This requires the bibtex-parser package also.

First, download the dependencies and package to the ~/.jupyter/custom location

mkdir ~/.jupyter/custom
cd ~/.jupyter/custom
git clone git@github.com:mikolalysenko/bibtex-parser.git
git clone git@github.com:michaelplews/jupyter_markdown_citations.git
cd jupyter_markdown_citations

Next, symlink (or copy) your .bib file (mine is exported from Mendeley) to the same folder:

ln -s /directory/to/bib_file.bib #for symlinking
cp /directory/to/bib_file.bib . #for copying
#only use one of the above options

Generate the custom_bibliography.js file with the make_bib_js.py file:

python make_bib_js.py bib_file.bib

Lastly, add this app to your custom.js file:

cd ~/.jupyter/custom
echo "require(['custom/jupyter_markdown_citations/citations']);" >> custom.js

Reloading your .iPyNb page in the browser should now load this package.

Enjoy!