Grzegorz Milka’s Blog

This is the source repository for my personal blog.

The blog is hosted on GitHub Pages at https://gregorias.github.io and uses Jekyll for site generation.

Development

Dev environment setup

1. Install rbenv and direnv and hook them into your shell.

2. Install Lefthook.

   lefthook install

3. Allow .envrc.

   direnv allow

4. Install project dependencies:

   rbenv install
   gem install bundler
   bundler install

Testing

To preview your drafts, run

jekyll serve --drafts

This will run a local server instance with live updates.

Build

To build the static website before release, run

jekyll build

Updating dependencies

Updating Ruby

To update the used Ruby version:

1. Update .ruby-version.

   1. (Optional) Install the new version on your system with rbenv install x.y.z.

2. Update .github/workflows/jekyll-build-and-deploy.yml.

3. Clean currently generated files and regenerate them:

   git clean -xdf
   bundler install
   just build

Updating gems

To update the used Bundler, delete the lockfile and regenerate with bundler install.