Jekyll Basics

What It Is

Jekyll is an awesome static website generator. It allows you to use dynamic constructs like templates and reusable components, while not having to deal with complexities associated with content management systems, such as databases and framework backend services.

Its a great choice for developing personal sites, professional portfolio style sites, blogs, and product detail sites.

What You Need

  • Docker - since Jekyll uses Ruby, we’ll be using docker due to complexities associated with getting a Ruby environment and its dependencies set up. This setup will be specifically for development only, which will generate simple HTML files that you’ll be able to deploy the files to your website’s production host.
  • Any Text Editor
  • Any OS - since we’re using docker, this should work on any OS. Some command line commands below are specific to ‘*nix’ type systems, but should be easily translatable to Windows.

What You’ll Get

An awesome statically generated website using Jekyll, which can be hosted for free on a variety of plaforms such as Git Pages and Netlify.

Install Jekyll Container

Create a workspace directory in a location of your choosing.

mkdir ~/your_dev_directory_name
cd ~/your_dev_directory_name

docker run --name dev-jekyll-container --rm -p 4000:4000 --volume="$PWD:/srv/jekyll" -it jekyll/jekyll:4 jekyll serve