delucis / v3.chrisswithinbank.net

:computer: Jekyll-based personal website

• Installation
  • Environment Set-Up
  • Repository Set-Up
  • Running local server and building
• Deployment

Installation

The following steps are for OS X. Skip steps if something is already installed, though updating/checking versions is probably advisable.

Environment Set-Up

Make sure you have a user version of Ruby installed

brew install ruby
export PATH=/usr/local/bin:$PATH

The first line installs Ruby via Homebrew.
The second line updates the $PATH to use the Homebrew copy of Ruby ahead of OS X’s system copy.

Install ImageMagick

brew install ImageMagick

Used for jekyll-picture-tag image processing.

Install Bundler

gem install bundler

Bundler will handle dependencies for the repository.

Repository Set-Up

Download repo

cd to the directory where you want to clone the repo, then do:

git clone https://github.com/delucis/v3.chrisswithinbank.net.git
cd v3.chrisswithinbank.net

Install dependencies

bundle install

Bundler will read the repository’s Gemfile and install listed dependencies.

Running local server and building

bundle exec jekyll serve

This will attempt to build the site and serve to http://0.0.0.0:4000/.

The site files are built to _site/.

To build without serving locally do:

bundle exec jekyll build

Building for production

To make sure URLs are processed using the correct host for deployment (rather than localhost:4000/):

JEKYLL_ENV=production bundle exec jekyll build

Deployment

Changes pushed to this repository will be automatically deployed via Netlify.