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.
Quality Control
Content Management
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
There are 2 main includes: one for the header and one for the footer, largely to minimise repetition.
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
Data files power many aspects of the site and these are updated via issues and GitHub Actions.
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.
Postings
- Monthly, create a mixtape running the shortcut
- Open the produced and resize to 832px width
- Copy the image to the
image/mixtapes/folder ensuring the name matches the formatyyyy-MM.png - Push a commit to Prod
- Run the python script typing in a Film title and a Rating. Or;
- Run a workflow dispatch - entering the inputs Film and Rating
- Run a workflow dispatch - entering the ISBN
- Download the cover image
- Resize to a height of 183px
- Save the cover image into the
images/booksfolder ensuring the name matches the formatbook-[isbn].png - Push a commit to Prod
- Capture the selection on a page in safari
- Share to Drafts and click Save
- In Drafts run the
cite to blogif it's a quotable post. Or; - In Drafts run the
post to blogif it's a regular post
Local Development
-
Clone the repository:
git clone https://github.com/thechelsuk/uk.thechels.git
-
Navigate into the project directory:
cd uk.thechels -
Install the required dependencies:
bundle install
-
Build and serve the site locally:
bash run.sh
-
Open your browser and go to
http://localhost:4000to see your site.
Content-Security-Policy
Add the following Content-Security-Policy (CSP) rules to your Cloudflare settings to enhance the security of your site:
default-src 'self'; img-src 'self' https:; script-src 'self' <https://static.cloudflareinsights.com> 'unsafe-inline'; connect-src 'self' <https://cloudflareinsights.com>; style-src 'self' 'unsafe-inline'; font-src 'self'; manifest-src 'self';
