install-jekyll-apple-silicon

This is the documentation for my YouTube video, titled "Install Jekyll on Apple Silicon"

Install homebrew

Think of Homebrew as an app store for the command line. Everything you install for Jekyll will be free and open source.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Finalize homebrew

Note: be sure to replace [username] with the username you use on your Mac.

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/[yourusername]/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
export SDKROOT=$(xcrun --show-sdk-path)

Install Ruby 3.0.x

You can see the version of Ruby pre-installed with your Mac, by typing:

ruby -v

You will need to install your own copy of Ruby using Homebrew with the following command:

brew install [email protected]

Finalzie the Ruby installation

Type:

echo $SHELL

The result will be zsh or bash

For zsh, type:

echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc

For bash, type:

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

Type:

exit

Quit terminal

Run terminal again and type:

ruby -v

(make sure it is ruby 3.0.x)

Install Jekyll and Bundler

Type:

gem install --user-install bundler jekyll

Type:

echo $SHELL

For zsh, type:

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

For bash, type:

echo 'export PATH="$HOME/.gem/ruby/3.0.0/bin:$PATH"' >> ~/.bash_profile

Type:

gem env

Look for the "GEM PATHS" section and make sure they all refer to 3.0.0

Create a folder for your new Jekyll site

Type:

cd desktop
mkdir jekylltest
cd jekylltest

If you are even thinking of using Git, create a .gitignore file

Create a .gitignore file at the rooy of your jekylltest folder

Add the following lines to the file:

_site/
.sass-cache/
.jekyll-cache/
.jekyll-metadata
.bundle/
vendor/

# optional for macs:
**/.DS_Store

Create a Jekyll site based on the default Minima theme

You will create a Jekyll site based on the default Minima theme that ships with Jekyll. If you want to choose a different type of site (different theme, blank site, etc), follow this link: https://jekyllrb.com/docs/usage

Type:

bundle init
bundle add jekyll --version "~>4.2"
bundle config set --local path 'vendor/bundle'
bundle install
bundle exec jekyll new --force --skip-bundle .
bundle add webrick
bundle install
bundle update

Run the Jekyll site

bundle exec jekyll serve --livereload

Copy the resulting URL (it usually ends in 4000) Paste the text into a browser The site should run!