Jieiku / abridge

Fast & Lightweight Zola Theme
https://abridge.pages.dev/
MIT License
142 stars 41 forks source link

Upgrade steps? #170

Closed cskwrd closed 1 month ago

cskwrd commented 1 month ago

What are the appropriate upgrade steps?

I have a site using what looks like v1.2. is the only way to upgrade to manually checkout each version and diff the config along the way?

Jieiku commented 1 month ago

If you are running abridge as a submodule then you can update it:

git submodule update --init --recursive
git submodule update --remote --merge

You do not need to incrementally update, you can go straight to the latest, and as long as you don't miss anything when you diff the config it should build. Zola is pretty good at pointing out the problem with their error messages if you miss something.

You should diff the config for the changes, which is exactly what I do when I update. Check config.toml as well as the overrides in the copy to root sass folder:

https://github.com/Jieiku/abridge/blob/master/config.toml

https://github.com/Jieiku/abridge/tree/master/COPY-TO-ROOT-SASS

The abridge.css demo uses abridge as a submodule, and I recently update it to latest here:

https://github.com/Jieiku/abridge.css/commit/6cbf633b49e0938e2c15be123c026dfd025c31ab

cskwrd commented 1 month ago

You should diff the config for the changes, which is exactly what I do when I update. Check config.toml as well as the overrides in the copy to root sass folder:

https://github.com/Jieiku/abridge/blob/master/config.toml

https://github.com/Jieiku/abridge/tree/master/COPY-TO-ROOT-SASS

That is what I thought, thank you!