pelican-theme/pelican/themes/simple/README.md

lugh Pelican theme

This theme is based on the simple theme. It's heavily customized to what I need here, so no efforts have been made to keep it useful for others. Amongst other things, I:

• removed translations
• changed the structure (HTML <footer> etc.)

Docs

• Pelican: how to create your own theme
• Tailwind CSS quick start

Doing

Prepare Pelican development server config

Adapt Pelican's publishconf.py for local development. E.g. RELATIVE_URLS = False

Install Tailwind CSS Typography plugin

Typography enables sane defaults for longer texts. In this case, we use it for the body content only, which is always Markdown. Typography is a bit of a beast to configure/align to standard Tailwind.

npm install -D @tailwindcss/typography

Run the Tailwind build process

npx tailwindcss -i static/css/in.css -o static/css/out.css --watch

Run Pelican dev server

conda activate pelican
./devserver.sh