docs: add migration findings

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/introduction/releasenotes/7

View file

@ -18,7 +18,12 @@ weight = -2
Fixing this resulted in major changes how stylesheets are bundled during built and ultimately leads to different stylesheets been loaded in the browser. If you haven't done any undocumented stuff with the stylesheets, this change should not have any negative effects to your site.
Anyways, please note that now the [variant generator](configuration/branding/generator) is not included in the theme release anymore but is only available in the docs. As a sideeffect, less JavaScript will be loaded on your site.
You need to make changes to your custom theme variant stylesheet if it contains
- `@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`
Also, please note that now the [variant generator](configuration/branding/generator) is not included in the theme release anymore but is only available in the docs. As a side effect, less JavaScript will be loaded on your site.
### New

View file

@ -18,7 +18,7 @@ weight = -5
The directory structure will be adjusted so all 3rd-party dependencies are stored in their appropriate module sub directory. So what previously was `static/js/js-yaml.js` will become `assets/j/js-yaml/js-yaml.js`.
Take a look into the [new `assets` directory](https://github.com/McShelby/hugo-theme-relearn/tree/main/assets). If you have overridden some of these files, you will have to adjust their paths accordingly.
Take a look into the [new `assets` directory](https://github.com/McShelby/hugo-theme-relearn/tree/main/assets). **Only if you have overridden some of these files**, you will have to adjust their paths accordingly. All other additional files should stay where they are.
- {{% badge style="note" title=" " %}}Change{{% /badge %}} Buttons for languages written right to left are now rendered correctly, so you will experience visual differences in those cases. This applies to