forked from github/pelican
43 lines
1.1 KiB
Markdown
43 lines
1.1 KiB
Markdown
# 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
|
|
```
|