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.

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

Afterward, 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\blog.jabref.org":/site bretfisher/jekyll-serve

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

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.