Version 3.0
See the changelog of this version for a detailed list of changes.-
0.126.0 Minimum required Hugo version
-
Breaking Change requiring action after upgrade
-
Change Change of behavior, may require action
-
New New behavior, often introducing new options
3.0.0 (2022-02-22)
Breaking
-
Breaking We made changes to the menu footer. If you have your
menu-footer.html
partial overridden, you may have to review the styling (eg. margins/paddings) in your partial. For a reference take a look into themenu-footer.html
partial that is coming with the exampleSite.This change was made to allow your own menu footer to be placed right after the so called prefooter that comes with the theme (containing the language switch and Clear history functionality).
-
Breaking We have changed the default colors from the original Learn theme (the purple menu header) to the Relearn defaults (the light green menu header) as used in the official documentation.
This change will only affect your installation if you’ve not set the
themeVariant
parameter in yourhugo.toml
. If you still want to use the Learn color variant, you have to explicitly setthemeVariant="learn"
in yourhugo.toml
.Note, that this will also affect your site if viewed with Internet Explorer 11 but in this case it can not be reconfigured as Internet Explorer does not support CSS variables.
Change
-
Change Due to a bug, that we couldn’t fix in a general manner for color variants, we decided to remove
--MENU-SEARCH-BOX-ICONS-color
and introduced--MENU-SEARCH-color
instead. You don’t need to change anything in your custom color stylesheet as the old name will be used as a fallback. -
Change For consistency reasons, we renamed
--MENU-SEARCH-BOX-color
to--MENU-SEARCH-BORDER-color
. You don’t need to change anything in your custom color stylesheet as the old name will be used as a fallback.
New
-
New With this release you are now capable to define your own dark mode variants.
To make this possible, we have introduced a lot more color variables you can use in your color variants. Your old variants will still work and don’t need to be changed as appropriate fallback values are used by the theme. Nevertheless, the new colors allow for much more customization.
To see what’s now possible, see the new variants
relearn-dark
andneon
that are coming with this release. -
New To make the creation of new variants easier for you, we’ve added a new interactive theme variant generator. This feature will not work with Internet Explorer 11.
-
New You can now configure multiple color variants in your
hugo.toml
. In this case, the first variant is the default chosen on first view and a variant selector will be shown in the menu footer. See the documentation for configuration.Note, that the new variant selector will not work with Internet Explorer 11 as it does not support CSS variables. Therefore, the variant selector will not be displayed with Internet Explorer 11.