=begin rakudoc

Prerequisites

Currently the citations support is provided using the `citeproc` and `pandoc` utilities, qudos to John MacFarlane, which are written in Haskell.

Some of the alternative citation block formats are supported by converting other xml formats to the one used by pandoc.

Consequently, these need to be installed. Assuming an Ubuntu OS.

• pandoc

sudo apt install pandoc

• cabal, which creates the citeproc utility

sudo apt install cabal-install cabal user-config init cabal --version ghc --version cabal update

• citeproc, download repo, compile, then place in path

git clone https://github.com/jgm/citeproc.git citeproc cd citeproc cabal build -fexecutable sudo ln -sr dist-newstyle/build/x86_64-linux/ghc-*/citeproc-*/x/citeproc/build/citeproc/citeproc /usr/local/bin/citeproc

• citeproc styles, download to a standard directory

sudo mkdir /usr/share/csl sudo git clone https://github.com/citation-style-language/styles.git /usr/share/csl

• bibutils, needed to convert some bibliographic formats

mkdir bibutils cd bibutils wget https://sourceforge.net/projects/bibutils/files/latest/download -O bibutils.tgz tar -xzf bibutils.tgz && rm bibutils.tgz cd bibutils_* sh -f configure sudo make install

=end rakudoc