- Install Ruby 2.4.3 via RubyInstaller (not 2.5, conflicts with things later)
- Let it install MSYS2 or do it yourself.
gem install bundler
gem install github-pages
(this includesjekyll
itself and is where things break most)jekyll -v
(3.6.2
at the time of writing, a little behind latest3.7
)jekyll new myblog
- Edit
myblog/Gemfile
to comment outjekyll
line and uncommentgithub-pages
line. bundle install
(inmyblog
)bundle exec jekyll serve
(inmyblog
)
I had random segfault on first install attempt, which went away by itself.
I was getting "invalid crypto" errors in pacman
commands and had to set SigLevel = Never
in c:\msys64\etc\pacman.conf
for pacman -Syu
to complete.
I was getting 'Could not open library 'libcurl'
errors inside jekyll-remote-theme
and had to get libcurl.dll
from this specific source and place into c:\Ruby24-x64\bin\
(via this SO answer, other libcurl.dll
didn't work for me).
Chocolatey initially installed Ruby 2.5, which conflicted with one of the gems, and downgrade to Ruby 2.4 broke Jekyll binary for me. Might have been sequence of events, but I just went to RubyInstaller on next attempt.
Jekyll Windows docs refer to Ruby DevKit, but with recent Ruby versions what you need is MSYS2 instead (as above).
They also refer to manually installing Nokogiri gem, but by now the kinks seem to be gone and it installs just fine with github-pages
gem.