Skip to content

mat-0/TheChels.uk

Repository files navigation

Site

A blog hosted on GitHub is available at TheChels.uk. The site uses Jekyll, a static site generator, on Ruby. DNS and SSL by Cloudflare. It also uses GitHub actions, GitHub issues, and Python for extensive automation.

It is called "weak notes" as a play on words of the popular "week notes" blogging style - due to the likelihood, I will have an inconsistent and irregular cadence for posting.

Badges

Quality Control

Run tests CodeQL Lighthouse Link Checker Linter Clear Cache Pages

Content Management

Add Book Add Film Add Offers Add Post Add Podcast Add Quotes Add Stock

Configuration

There are several optional settings for you to configure. Use the example _config.yml file in the repo and use the documentation below to configure your site:

Config

Using includes

There are 2 main includes: one for the header and one for the footer, largely to minimise repetition.

Using layouts

Layouts are almost one-to-one with pages, handling any page specifics. post.html is the layout used for every blog post. There are also default templates and an empty template used for scss and other special pages such as humans.txt

Using Data

Data files power many aspects of the site and these are updated via issues and GitHub Actions.

Site navigation

Using configuration yml, navigation is provided by three collections for header, footer, and around_the_web (on the about page) and are fairly self-explanatory.

Post Types

Postings

Mixtape Monthly Guide

  • Monthly, create a mixtape running the shortcut
  • Open the produced and resize to 832px width
  • Copy the image to theimage/mixtapes/ folder ensuring the name matches the format yyyy-MM.png
  • Push a commit to Prod

Add a Film

  • Run the python script typing in a Film title and a Rating. Or;
  • Run a workflow dispatch - entering the inputs Film and Rating

Add a Book

  • Run a workflow dispatch - entering the ISBN
  • Download the cover image
  • Resize to a height of 183px
  • Save the cover image into the images/books folder ensuring the name matches the format book-[isbn].png
  • Push a commit to Prod

Quote posts

  • Capture the selection on a page in safari
  • Share to Drafts and click Save
  • In Drafts run the cite to blog if it's a quotable post. Or;
  • In Drafts run the post to blog if it's a regular post