hugo-theme-relearn/exampleSite/content/introduction/releasenotes/5/0.en.md

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

## 5.0.0 (2022-07-05) {#5-0-0}

### 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.

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

### Change

- {{% badge style="note" title=" " %}}Change{{% /badge %}} The way [archetypes](authoring/frontmatter/designs) 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 with `archetype = "chapter"` and remove the leading headings

- {{% badge style="note" title=" " %}}Change{{% /badge %}} The front matter 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](shortcodes/math) for available features. This feature will not work with Internet Explorer 11.
docs: restructure changelog #917 2024-09-18 18:36:42 +00:00			`+++`
			`disableToc = false`
			`hidden = true`
			`title = "Version 5.0"`
			`type = "releasenotes"`
			`weight = -0`
			`+++`

docs: change anchor naming scheme #917 2024-09-18 18:47:07 +00:00			`## 5.0.0 (2022-07-05) {#5-0-0}`
docs: restructure changelog #917 2024-09-18 18:36:42 +00:00
			`### 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.

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

			`### Change`

docs: finalize dir structure of chapter 3 #567 2024-10-11 21:01:56 +00:00			`- {{% badge style="note" title=" " %}}Change{{% /badge %}} The way [archetypes](authoring/frontmatter/designs) are used to generate output has changed. The new systems allows you, to redefine existing archetypes or even generate your own ones.`
docs: restructure changelog #917 2024-09-18 18:36:42 +00:00
			`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:`

docs: chapter 3 content-complete #567 add other stuff 2024-10-12 16:37:59 +00:00			- for your home page, add the front matter parameter `archetype = "home"` and remove the leading heading
docs: restructure changelog #917 2024-09-18 18:36:42 +00:00
#docs: call it front matter #567 2024-10-06 18:52:53 +00:00			- for all files containing the deprecated front matter parameter `chapter = true`, replace it with `archetype = "chapter"` and remove the leading headings
docs: restructure changelog #917 2024-09-18 18:36:42 +00:00
docs: chapter 3 content-complete #567 add other stuff 2024-10-12 16:37:59 +00:00			- {{% badge style="note" title=" " %}}Change{{% /badge %}} The front matter 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.
docs: restructure changelog #917 2024-09-18 18:36:42 +00:00
			`### New`

#docs: call it front matter #567 2024-10-06 18:52:53 +00:00			- {{% 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.
docs: restructure changelog #917 2024-09-18 18:36:42 +00:00
			- {{% 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](shortcodes/math) for available features. This feature will not work with Internet Explorer 11.