This repository contains an (almost) completely blank Jekyll website, which has been deployed to Netlify (https://jekyll-blank.beh.uk/) and GitHub Pages (https://benjaminehowe.github.io/jekyll-blank/). It's is mostly for my own reference, but I've made it public in case anyone else on the internet finds it useful! GitHub allows you to easily create a new repository using this one as a template.
What's the point?
The first time I created a Jekyll site I used the command jekyll new myblog
, which gave me a basic blog-style website using the minima theme. That's great if you want to create a blog, but if not there's some work to do (and having the gem-based theme code hidden makes it harder to see what's going on). I then tried jekyll new myblog --blank
, but even with the enhanced --blank
scafolding it wasn't as quick to get started as I'd like; I still needed to set up Git, create a Gemfile, set up Netlify, etc. This repository streamlines this process, as well as acting as documentation for myself!
I've created a new repository - what needs changing?
Assuming you've already installed Ruby and Jekyll:
- update
_config.yml
- double check my
netlify.toml
defaults make sense for you (or removenetlify.toml
completely if you're not using Netlify) - And finally, change this README file
Once you've done this, you're good to go, and you can start customising the liquid behind the (minimal) theme. You can preview your Jekyll site locally by running bundle exec jekyll serve
(and navigating to http://127.0.0.1:4000), and then commit your changes to git.