pelican-theme/README.md

# lugh Pelican theme

This theme is based on the [simple theme](https://github.com/getpelican/pelican/tree/main/pelican/themes/simple/templates).
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](https://docs.getpelican.com/en/stable/themes.html)
- [Tailwind CSS quick start](https://tailwindcss.com/docs/installation)

## 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.

```shell
npm install -D @tailwindcss/typography
```

### Run the Tailwind build process

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

### Run Pelican dev server

```shell
conda activate pelican
./devserver.sh
```