Windows-Manual-Install-Fixes.md

1. Install GitForWindows

skip if you already have GitBash working

2. 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 .....

3. 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

4. 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!!!!!!!

5. Follow instructions on the GhostScript downloads page.
6. Open GitBash
7. Check for Ruby with ruby -v and convert -version. (We can skip the checks for gs and vips from the Wiki.)
8. Install Bundler with the command gem install bundler
9. Change directory into your project folder, e.g., cd ~/Desktop/my-wax-site
10. Install the project gems with bundle install
11. Open the project in atom with atom .
12. 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 }
    

13. Save the file.
14. In atom, the file called Gemfile. Replace the whole contents with:

    # frozen_string_literal: true
    
    source 'https://rubygems.org'
    gemspec
    
    # 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'
    end
    

15. Save the file.
16. Back in GitBash, update the dependencies with bundle update
17. Check for the rake tasks with bundle exec rake --tasks
18. 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: http://127.0.0.1:4000/wax/ Server running... press ctrl-c to stop", at which point you should open that link in your Browser.