nishiki/hugo-theme-relearn
1
0
Fork 0
mirror of https://github.com/McShelby/hugo-theme-relearn.git synced 2025-05-18 15:54:11 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

docs: add migration findings

Browse source
This commit is contained in:
Sören Weber 2025-03-19 22:52:36 +01:00
parent 4753a3e2e3
commit 67d43d0a8a
No known key found for this signature in database
GPG key ID: BEC6D55545451B6D
4 changed files with 18 additions and 3 deletions
docs/content/configuration/branding/colors
_index.en.md

10
docs/content/configuration/branding/colors/_index.en.md
View file

@ -171,6 +171,16 @@ In case you like a shipped variant but only want to tweak some aspects, you have
In comparison to _copy and change_, this has the advantage that you profit from any adjustments to the `relearn-light` variant while keeping your modifications.
### Non-standard Modifications
You may feel tempted to add further modifications besides just setting CSS variables in your custom variant stylesheet.
While this is possible, please note that due to the way the theme uses the variant files, the following will not work
- `@font-face` rules - they need to be moved to `assets/css/fonts.css`, `assets/css/custom.css` or `layouts/partials/custom-header.html`
- rules selecting the `html` element - replace `html` with `:root`
### React to Variant Switches in JavaScript
Once a color variant is fully loaded, either initially or by switching the color variant manually with the variant selector, the custom event `themeVariantLoaded` on the `document` will be dispatched. You can add an event listener and react to changes.