Skip to content

Instantly share code, notes, and snippets.

What would you like to do?
  1. Install GitForWindows

skip if you already have GitBash working

  1. Uninstall "ImageMagick Display" app if you installed it previously.

skip if running convert -version in GitBash gives you something like Version: ImageMagick 7.0.11-1 .....

  1. Install Ruby using the RubyInstaller for Windows 10

IMPORTANT! Make sure you install a Ruby version > 2.4 and less than 3.0! Recommended is “Ruby+Devkit 2.7.3-1”. On the last step of the installation wizard, make sure to run the ridk install option. skip if running ruby -v in GitBash gives you a proper version >=2.4 & < 3.0

  1. Install ImageMagick by following the instructions on the ImageMagick Downloads page

IMPORTANT!!! About half way down one of the install option menus is a checkbox with something like “Install legacy components (convert.exe etc)”. Tick this box!!!!!!!

  1. Follow instructions on the GhostScript downloads page.
  2. Open GitBash
  3. Check for Ruby with ruby -v and convert -version. (We can skip the checks for gs and vips from the Wiki.)
  4. Install Bundler with the command gem install bundler
  5. Change directory into your project folder, e.g., cd ~/Desktop/my-wax-site
  6. Install the project gems with bundle install
  7. Open the project in atom with atom .
  8. In atom, find the file called Rakefile. Delete everything except for the last two lines:
    spec = Gem::Specification.find_by_name 'wax_tasks'
    Dir.glob("#{spec.gem_dir}/lib/tasks/*.rake").each { |r| load r }
  9. Save the file.
  10. In atom, the file called Gemfile. Replace the whole contents with:
    # frozen_string_literal: true
    source ''
    # Temporarily pin jekyll to avoid absolute_url bug in 4.2
    gem 'jekyll', '4.1'
    # Windows patches
    platforms :mswin, :mingw, :x64_mingw, :jruby do
      gem 'wdm', '>= 0.1.0' if Gem.win_platform?
      gem 'tzinfo-data'
  11. Save the file.
  12. Back in GitBash, update the dependencies with bundle update
  13. Check for the rake tasks with bundle exec rake --tasks
  14. Try serving your site to your browser with bundle exec jekyll serve

NOTE: This command will stay running forever until you stop with with Control-C! It will serve the site as long as it's running. After ~30 seconds, the command should return something like "Server address: Server running... press ctrl-c to stop", at which point you should open that link in your Browser.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment