Using Pelican as blogging platform for GitHub
Posted on Tue 28 September 2021 in Blogging • Tagged with Pelican, GitHub pages, Blog
So I guess my first blog should be about setting up this blog.
I wanted to use GitHub pages. By default they use Jekyll, which is built with Ruby. I have no experience with that language, so I tried to use something Python-based. I found this post about using Pelican, but I had some problems. I'm going to try to give here step by step instructions, using Linux.
Create a directory for the blog, an environment and activate it:
mkdir blog
cd blog
python -m venv .venv
source .venv/bin/activate
Install pelican with one of these options:
# This option only allows reStructuredText
python -m pip install pelican
# This allows markdown and reStructuredText
python -m pip install "pelican[markdown]"
Create the basic structure:
pelican-quickstart
I'll leave the standard theme. Read in the mentioned post if you want to change the theme.
Note I've created a new post about how to change the style to Flex
To test locally the blog, generate the site with:
make html
Now start a web server with:
make serve
You …
Continue reading