This repository contains my personal blog powered by Pelican and hosted on GitHub Pages. It's accessible at forestdussault.com.
To create a new blog post, use the new-post command in the Justfile:
just new-post "Your Post Title" "Category"
This will create a new Markdown file in the content directory with the proper frontmatter. The category parameter is optional and defaults to "General".
To publish a post to GitHub Pages, run the following:
just github
This command will:
- Generate the site
- Pull the latest changes from the repository
- Push the generated content to the
gh-pagesbranch - Configure the custom domain (if set in the
Justfile)
The blog uses GitHub Pages for hosting with the following workflow:
- Content is written in Markdown in the
contentdirectory - Pelican converts the Markdown to HTML
- The
just githubcommand usesghp-importto push the generated HTML to thegh-pagesbranch - GitHub Pages serves the content from the
gh-pagesbranch
This blog uses a customized version of the Cid theme. To customize the theme futher:
- Modify the theme settings in
pelicanconf.py - Theme templates are located in
themes/cid/templates/ - CSS styling can be modified in
themes/cid/static/css/ - To change social links or contact information, update the
CONTACTSandCONTACT_EMAILvariables inpelicanconf.py
For more advanced theme customization, you can modify the templates directly to change the layout and appearance of the blog.