JabRef's blog

This repository contains the source of the JabRef blog.

Feel free to send blog entries. Find details in our CONTRIBUTING.md file.

The layout is based on Chirpy. We use Jekyll as static site generator. See GitHub pages for more details on the mechanics behind.

Local Development

For local development, follow the Jekyll installation instructions. Installing the latest version of ruby followed by gem install bundler should be enough.

Afterwards, run

bundle install
jekyll serve --livereload

and go to http://localhost:4000/ in your browser.

On Windows, using a dockerized environment is recommended:

docker run -p 4000:4000 --rm --volume="C:\git-repositories\jabref\blog.jabref.org":/srv/jekyll jekyll/jekyll:4 jekyll serve

In case you get errors regarding Gemfile.lock, just delete Gemfile.lock and rerun.

Incremental building is also possible:

docker run -p 4000:4000 --rm --volume="C:\git-repositories\jabref\blog.jabref.org":/srv/jekyll jekyll/jekyll:4 jekyll serve --incremental

Updating the theme

1. Update Gemfile
2. Update assets:
   1. cd assets/lib
   2. git pull
   3. cd ../..
3. git commit and PR creation
4. In case build fails because of missing assets, roll back the assets to the commit matching the release version of the theme.