hugo-theme-relearn/exampleSite/content/introduction/releasenotes/5/0.en.md
2024-10-11 16:47:38 +02:00

2.1 KiB

+++ disableToc = false hidden = true title = "Version 5.0" type = "releasenotes" weight = -0 +++

5.0.0 (2022-07-05)

Breaking

  • {{% badge style="warning" title=" " %}}Breaking{{% /badge %}} 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 the defer keyword to the script element. Eg.

    <script defer src="myscript.js"></script>
    

Change

  • {{% badge style="note" title=" " %}}Change{{% /badge %}} 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 frontmatter parameter archetype = "home" and remove the leading heading

    • for all files containing the deprecated front matter parameter chapter = true, replace it with archetype = "chapter" and remove the leading headings

  • {{% badge style="note" title=" " %}}Change{{% /badge %}} The frontmatter options pre / post were renamed to menuPre / 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

  • {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} Adding new partials heading-pre.html / heading-post.html and according front matter options headingPre / headingPost to modify the way your page`s main heading gets styled.

  • {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} 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.