Izar Jekyll documentation

Updating Izar

Get new versions of Izar and keep your content safe while you update.

Updates are free for buyers. When a new version is released, download it again from the link in your purchase email or from your Lemon Squeezy orders. See also the general updates guide.

Before you update

Commit your project to Git, or copy the whole folder somewhere safe.

If you changed content and settings only

Your own work lives in a few places:

  • _config.yml
  • index.md, works.md, notes.md, notes-tags.md, contact.md and thank-you.md
  • _projects/ and _posts/
  • _data/strings.yml
  • assets/img/, assets/favicon.svg and any font you changed in assets/fonts/
  • Colour changes in _includes/css/theme.css, colors.css or scale.css
  1. Unzip the new version into a new folder.
  2. Copy those files and folders from your project into it, replacing the samples.
  3. Run bundle install, then bundle exec jekyll serve, and check everything looks right.
  4. Read the release notes. If a section gained a new field or _config.yml a new setting, add it to your copy. The comments at the top of each file in _includes/sections/ list every field.

If you changed the design

Compare your changed files with the new version and copy your changes across. In VS Code, select two files in the explorer, right-click and choose Compare Selected.

Updating Jekyll

The Gemfile pins the gem set GitHub Pages runs. To keep your site matching it, update when we release a new version of Izar. If you only want newer gems, run bundle update, then bundle exec jekyll build and check the site.