Version 6.0
See the changelog of this version for a detailed list of changes.0.121.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
6.0.0 (2024-04-27)
Breaking
-
Breaking This release requires you to move your self-defined variant (
theme-*.css) and chroma stylesheets (chroma-*.css) fromstatic/csstoassets/css.This was necessary to avoid permission errors on build if running in certain Unix configurations.
In addition it is not allowed anymore to
@importyour chroma stylesheet from inside of your variant stylesheet.Say, your chroma stylesheet is named
chroma-monokai.css, you have to add the following inside your variant stylesheet: -
Breaking The parameter
descriptionin yourhugo.tomlwill now be ignored.With the newly introduced unified handling of descriptions throughout the theme, the only place the old parameter would have been used was your home page.
For migration, move the
descriptionparameter of yourhugo.tomlinto the front matter section of your home page. -
Breaking Search support for the
jsonoutputformat deprecated in 5.4.0 was removed.Change it to
searchfor the homepage in yourhugo.toml. See the docs for detailed configuration. -
Breaking The front matter option
menuTitledeprecated in 5.24.0 was removed in favor for Hugo’s ownlinkTitle.Additionally, if set,
linkTitlewill now be used instead oftitleto generate the breadcrumb. -
Breaking The
swaggershortcode deprecated in 5.13.0 was removed in favor for theopenapishortcode with the same set of parameter. -
Breaking Support for Internet Explorer 11 was finally dropped.
Change
-
Change With the removal of support for Internet Explorer 11, Font Awesome was upgraded to version 6.5.2.
You may experience slight changes for some icons. In addition you have additional ~1700 icons to chose from.
-
Change The
childrenshortcode was fixed to adhere to its documentation, generating the description based on this rule: When no description or summary exists for the page, the first 70 words of the content is taken.Previously, the summary erroneously was ignored which now can lead to different output if you set
description=trueas a parameter.
New
-
New The
includeshortcode is now able to resolve links to resources as well as to files in the file system (the old behavior). You can configure to generate warnings or errors during build by settinginclude.errorlevelto eitherwarningorerrorin yourhugo.tomlif a path can not be resolved. -
New Math is now usable without enclosing it in a shortcode or Markdown codefence by using Hugo’s passthrough configuration.
-
New Translation into Romanian.