BibTeX References
This site was build using the jekyll-scholar plugin (version 7.1.3):
$ gem list | grep scholar
jekyll-scholar (7.1.3)
This post describes how this plugin can be used to cite BibTeX references stored in .bib files on a website built with Jekyll.
Step-by-step instructions
1. Install jekyll-scholar plugin:
$ gem install jekyll-scholar
2. Add gem 'jekyll-scholar', group: :jekyll_plugins to ./Gemfile.
3. Create ./_plugins directory and write: require 'jekyll/scholar' to ext.rb file.
4. Set the jekyll-scholar plugin configuration settings in ./_config.yml, this site uses:
# jekyll-scholar plugin settings
scholar:
style: apa
locale: en
sort_by: none
order: ascending
source: ./_bibliography
bibliography: simple.bib
bibliography_template: ""
replace_strings: true
join_strings: true
details_dir: bibliography
details_layout: bibtex.html
details_link: Details
query: "@*"
5. Create ./_bibliography directory and add some .bib files to it, for example simple.bib:
@book{ruby,
title = {The Ruby Programming Language},
author = {Flanagan, David and Matsumoto, Yukihiro},
year = {2008},
publisher = {O'Reilly Media}
}
@book{smalltalk,
title = {Smalltalk Best Practice Patterns},
author = {Kent Beck},
year = {1996},
publisher = {Prentice Hall}
}
6. Finally, add some content markdown files to _posts directory for testing. See the post ./_posts/2024-04-23-bibtex-references.md as an example.