jekyll.md

Create a repo

Create a new repo to host your blog site, call it "blog" https://github.com/new

Clone the theme

Using this theme: https://jekyllthemes.io/theme/forty-jekyll-theme

In your terminal:

git clone git@github.com:andrewbanchich/forty-jekyll-theme.git blog

cd blog
git remote remove origin
git remote add origin git@github.com:<your-guthub-username>/blog.git
git push origin master

Setup a Personal Access Token

Go to this address and create a PAT - doesnt matter what you call it. Make sure it has access to all of "repo" https://github.com/settings/tokens

Add the token to your repo

• Go to GitHub | <Repo> | Settings | Secrets
• Add a repository secret called JEKYLL_PAT and paste in your secret from before

Working Locally

add docker-compose.yml

Add a docker-compose.yml to the root of the blog project

version: '3'

services:
  jekyll:
    image: jekyll/jekyll:4.2.0
    command: jekyll serve --watch --incremental
    ports:
      - 4000:4000
    volumes:
      - .:/srv/jekyll:cached

Docker/Jekyll commands

To start Jekyll, type docker compose up

To force a rebuild docker compose exec jekyll jekyll build