Managing a bilbliography.

[martinjuckes]

For our literature survey it will be useful to have a single file listing relevant literature. I've started putting something together in Overleaf as a BibTeX file. BibTeX is a widely recognised and used standard for holding metadata about published documents.

There is a widely praised jekyll extension, jekyll-scholar, which allows BibTeX files to be integrated and used in jekyll based websites.

Unfortunately, github pages does not support jekyll-scholar directly, the documentation suggests keeping the markdown in a separate branch, doing the conversion md --> html on a local server and then pushing the resulting site to master.

I think we should keep the current default for pages that don't need academic citations and avoid the need for a complex workflow where it is not needed.

For now, it may be easier to keep the bibliography and pages citing it in a separate repo, and migrate pages into this one, e.g. as blog pages.

[martinjuckes]

Initial testing shows that jekyll-scholar only deals cleanly with a limited range of bibtex properties. URLs, for instance, are rendered as plain text.

[martinjuckes]

Using htlatex to create a html view of a set of bibtex references is cleaner. This approach would imply using htlatex for blog posts ... which might be an unwanted complexity. The latex content can, however, be kept simple.

[agstephens]

@martinjuckes please can you share your project on overleaf with me (ag.stephens@stfc.ac.uk).