Version 5.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
5.0.0 (2022-07-05)
Breaking
-
Breaking The theme changed how JavaScript and CSS dependencies are loaded to provide a better performance. In case you’ve added own JavaScript code that depends on the themes jQuery implementation, you have to put it into a separate
*.js
file (if not already) and add thedefer
keyword to thescript
element. Eg.<script defer src="myscript.js"></script>
Change
-
Change The way archetypes are used to generate output has changed. The new systems allows you, to redefine existing archetypes or even generate your own ones.
Your existing markdown files will still work like before and therefore you don’t need to change anything after the upgrade. Nevertheless, it is recommended to adapt your existing markdown files to the new way as follows:
-
for your home page, add the front matter parameter
archetype = "home"
and remove the leading heading -
for all files containing the deprecated front matter parameter
chapter = true
, replace it witharchetype = "chapter"
and remove the leading headings
-
-
Change The front matter options
pre
/post
were renamed tomenuPre
/menuPost
. The old options will still be used if the new options aren’t set. Therefore you don’t need to change anything after the upgrade.
New
-
New Adding new partials
heading-pre.html
/heading-post.html
and according front matter optionsheadingPre
/headingPost
to modify the way your page`s main heading gets styled. -
New The new shortcode
math
is available to add beautiful math and chemical formulae. See the documentation for available features. This feature will not work with Internet Explorer 11.