Overview

This is contains the code I was/am using make my personal website hosted on github pages. It contains a lot cruft.

Look at this for info on

• configuring DNS for Github Pages
• the publishing workflow for pelican with Github Actions
• using github actions to deploy the website (NB configure custom domain with the repo UI, not a CNAME file)
• let cloudflare handle HTTPS and certificates (not github pages)
• remember the CNAME file in content/extra/ and the CNAME config in pelicanconf.py. Relevant pelican docs.

helpful utilities:

• Squoosh app to compress images

Build dev site

Build using the dev settings and serve the site locally with:

pelican --autoreload --listen

and navigate to http://localhost:8000/. If you just want to build the site use can use pelican content -s publishconf.py

Build prod site

Compile production site with pelican content -s publishconf.py. I am currently deploying to github pages via a github action with source code at .github/workflows/pelican.yml

Blogs with source code using Pelican

using markdown

• Leonardo Giordani's blog (active as of 2024)
• Full Stack Python site and blog (active as of 2021)
• Kevin Yap (active as of 2021)
• This week in rust (active as of 2024)

using rst:

• Ben Hoff's blog (active as of 2019)
• Official Pelican blog (active as of 2023)