Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/BillRaymond/install-jekyll-apple-silicon

Last synced: 3 months ago
JSON representation

Host: GitHub
URL: https://github.com/BillRaymond/install-jekyll-apple-silicon
Owner: BillRaymond
Created: 2021-12-16T19:58:56.000Z (over 2 years ago)
Default Branch: main
Last Pushed: 2023-10-03T19:47:47.000Z (9 months ago)
Last Synced: 2024-01-16T11:42:28.276Z (5 months ago)
Size: 5.86 KB
Stars: 33
Watchers: 3
Forks: 50
Open Issues: 0
Metadata Files:
- Readme: README.md

Lists

my-awesome-stars - BillRaymond/install-jekyll-apple-silicon - (Others)

README

# This is the documentation for my YouTube video, titled "Install Jekyll on Apple Silicon"
Video: [Install Jekyll on Apple Silicon](https://studio.youtube.com/channel/UCo63gWfWRfEciJ98mJLIU0Q)

## 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!