Skip to content

Instantly share code, notes, and snippets.

@marckassay
Last active February 26, 2018 13:17
Show Gist options
  • Save marckassay/45f186d0f51a1d58621a0cf4acb10457 to your computer and use it in GitHub Desktop.
Save marckassay/45f186d0f51a1d58621a0cf4acb10457 to your computer and use it in GitHub Desktop.
Notes on: Install Jekyll (and Ruby) on Windows for GitHub pages
1. Install Ruby that is greater or equal to 2.4.0, this will install "DevKit" that developers refer to:
	https://rubyinstaller.org/downloads/

	*** If you come across any issues and search online, be mindful that when recommended to '$ ruby dk.rb init' they are referring to an older version of Ruby than 2.4.0 ***

2. As of this writing there is bug in ridk ( https://github.com/oneclick/rubyinstaller2/issues/101 ).  So after Ruby install, restart CLI and execute:
	$ ridk exec pacman -Syu --needed --noconfirm --ask 20
	$ ridk install 2 3

3. Unable to run Jekyll following GitHub instructions ( bundle exec jekyll _3.3.0_ new NEW-JEKYLL-SITE-REPOSITORY-NAME ), so use the following instead:
	$ jekyll new marckassay.github.io -f
	
4. Overwrite generated Gemfile from step 3, with the following:
	source "https://rubygems.org"
	# Hello! This is where you manage which Jekyll version is used to run.
	# When you want to use a different version, change it below, save the
	# file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
	#
	# bundle exec jekyll serve
	#
	# This will help ensure the proper Jekyll version is running.
	# Happy Jekylling!
	# gem "jekyll", "~> 3.3.0"
	# This is the default theme for new Jekyll sites. You may change this to anything you like.
	gem "minima", "~> 2.0"
	# If you want to use GitHub Pages, remove the "gem "jekyll"" above and
	# uncomment the line below. To upgrade, run `bundle update github-pages`.
	gem "github-pages", group: :jekyll_plugins
	# If you have any plugins, put them here!
	group :jekyll_plugins do
	gem "jekyll-feed", "~> 0.6"
	end
	# Windows does not include zoneinfo files, so bundle the tzinfo-data gem
	gem 'tzinfo-data', platforms: [:mingw, :mswin, :x64_mingw, :jruby]

5. Execute the following:
	$ bundle install
	$ bundle update github-pages
	$ jekyll serve

ref:

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