Simpl.world Website

The simpl.world website is a static site compiled with Jekyll.

To Install / Run Locally

To run Jekyll locally (see Procfile to see what's going on):

$ gem install jekyll bundler foreman
$ foreman start
# => Now browse to http://localhost:8000

To manually run Jekyll sans foreman:

$ bundle exec jekyll serve
# => Now browse to http://localhost:4000

If you get GemNotFound errors from either command, you may need to also run:

$ bundle install

To test the site (before deploying)

$ bundle exec rake test

To Run Jekyll via Docker

We are using Docker Compose which requires installing it for the platform of your choice.

$ docker-compose pull
$ docker-compose up --build
# => Now browse to http://localhost:8000

For Mac OS High Sierra

Install ruby using homebrew, add to .bash_profile:

# Ruby exports
export GEM_HOME=$HOME/gems
export PATH=$HOME/gems/bin:$PATH

# Add Homebrew's executable directory to the front of the PATH
export PATH=/usr/local/bin:$PATH

then run:

$ sudo gem install -n /usr/local/bin bundler jekyll foreman
$ foreman start
# => Now browse to http://localhost:8000

If you run into gem version errors, these may clear them:

$ gem pristine commonmarker --version 0.17.9
$ gem install rake && bundle install