Open netllama opened 1 year ago
Hi @netllama ! Thanks you so much for your kind words.
It's true that being set up as a Python package and a Pelican plugin makes it less straightforward how to hack on this. Depending on how extensively your proposed changes, there are several ways to go about this. Here's a couple of tips that might help get you started:
seafoam/pelican/plugins
directory to your list of plugins. If Pelican doesn't load your version of the plugin, you might have to install the theme as a Python package (i.e. pip install .
from the repo's root directory). Note that if you do this, you'll have to install it and not use editable mode (-e
) for pip, as that doesn't seem to work as with namespace packages (like Pelican plugins). So you'll need to reinstall the package each time to make changes.CUSTOM_CSS
and CUSTOM_CSS_LIST
; provide a link to your custom CSS that exists in your generated Pelican site, with relative links assumed to be realitive to the SITE_URL
. This may be the way to go if you changes are relatively simple, one-off, or mostly applicable to your usecase.css_src/less
(here). Make your pull requests against here rather than the generated CSS.pelican/plugins/seafoam/templates
folder (here)Hopefully that helps you get started. If you need more help, let me know. I'm looking forward to your PR :)
This theme is awesome! Thanks so much for creating and maintaining it.
One thing that I'm unclear how to accomplish is customizing the CSS for the theme. For a "normal" pelican theme, I'd clone the theme repo, then make my changes (and maybe send out a PR). But since this theme comes from a package, I have no repo to clone, and the theme isn't available under the
themes
directory anyway.Is there some approved way to hack on the CSS to make changes that will be detected automatically when I run
make publish
ormake html
? thanks!