Setting up Github Make an account on Github

Installing Ruby & Jekyll

Installing Command line tools & Ruby
Follow through “Configure Git on Mac” - Skip generate SSH key steps

Check if MacOS is updated - update if needed

Creating ~/.zshrc in home folder

touch .zshrc

Install Homebrew (it will install command line tools)

/bin/bash -c "$(curl -fsSL”

Adding homebrew to $PATH

Copy commands provided by homebrew

Configure GIT

Git config —global “Naam Naam”
Git config —global

Set SDKROOT (see

export SDKROOT=$(xcrun --show-sdk-path)
Skip to Install Ruby with Homebrew (
Install Ruby
Brew install ruby

Edit ~/.zshrc, set $PATH

if [ -d "/opt/homebrew/opt/ruby/bin" ]; then
	  export PATH=/opt/homebrew/opt/ruby/bin:$PATH
 export PATH=`gem environment gemdir`/bin:$PATH

Install Jekyll

Install RubyGems, GCC and Make


gem update --system


brew install gcc


brew install make
Install Jekyll and Bundler
gem install --user-install bundler jekyll

Add Gem direction to $PATH

echo 'export PATH="$HOME/.gem/ruby/X.X.0/bin:$PATH"' >> ~/.zshrc

Setting up Github pages

See (
  1. Make new repository on GitHub “”

  2. Make parent folder Github site ~/documents/Github_Site

  3. Initialize empty Git repository in ~/documents/Github_Site/WaagDoc

  4. Create Jekyll site in repository

  5. Edit Gem file

    1. added # to gem “jekyll”
    2. removed # from gem “github_pages” and set version to 225

       Bundle install
  6. Edit _config.yml

  7. Test site - error


bundler: failed to load command: jekyll (/opt/homebrew/lib/ruby/gems/3.1.0/bin/jekyll)
/opt/homebrew/lib/ruby/gems/3.1.0/gems/jekyll-3.9.0/lib/jekyll/commands/serve/servlet.rb:3:in `require': cannot load such file -- webrick (LoadError)


bundle add webrick

What is it:

Webrick is missing. Webrick is not included anymore in Ruby 3.0 - thus we need to add in manually

  1. Test site - site is running

  2. Commit site


(use "git add <file>..." to include in what will be committed)


Delete current file

Git rm —-cached .DS_Store 

Add .DS_Store to .gitignore file

What is it:

.DS_Store is a file automatically created my Mac when opening a file in Finder. It stores information about thumbnails.

  1. Add repository op as a remote

  2. Push site to github

Now we have a super simple site! - Next: Personalize site with theme!

Frequently used command cheat-sheet:

cd change directory

mkdir make directory

git init creates repository

Jekyll new —skip-bundle . creates new Jekyll site in repo

Bundle exec Jekyll serve builds site and serves at http://localhost:4000/

-—livereload Updates changes live when serving website

git add . adds every change to commit

git commit -m ‘naam commit’ commits changes

git remote ad

git push -u origin main push changes

bundle update update all gems