docs: honing #917

This commit is contained in:
Sören Weber 2024-09-21 11:12:54 +02:00
parent 77bcea562c
commit 06c45128ec
No known key found for this signature in database
GPG key ID: BEC6D55545451B6D
5 changed files with 8 additions and 4 deletions

View file

@ -1,4 +1,5 @@
+++
alwaysopen = false
disableToc = false
title = "Changelog"
type = "changelog"

View file

@ -1,4 +1,5 @@
+++
alwaysopen = false
disableToc = false
title = "Changelog"
type = "changelog"

View file

@ -8,7 +8,7 @@ weight = -0
## 7.0.0 (XXXX-XX-XX) {#7-0-0}
> [!secondary]
> [!primary]
> {{% icon fire-flame-curved %}} The release you didn't know you want! {{% icon fire-flame-curved %}}
### Hugo 0.126.0
@ -22,13 +22,13 @@ weight = -0
- suffered from poor build performance for sites with 1000 or more pages
- reinvented the wheel instead of using available Hugo mechanisms
_What do I gain_, you may ask. A significant performance boost during build! Usually the build time has been cut in half. It is now possible to build even larger sites with 5000 or more pages. This was previously almost impossible due to rapidly increasing build time the more pages you've introduced. For even bigger sites, the theme now has configurable performance optimizations (at the price of feature limitations).
_What do I gain_, you may ask. A significant performance boost during build! Usually the build time has been cut at least in half for bigger sites. It is now possible to build even larger sites with 5000 or more pages. This was previously almost impossible due to rapidly increasing build time with the more pages you've introduced. For even bigger sites, the theme now has configurable performance optimizations (at the price of feature limitations).
If you haven't done customizations to any partials, you can update right away.
If you have customized your templates, in best cases you will get build warnings or even errors. In worst cases, your build succeeds but the site will not work as intended by you.
Specifically, you will most likely have to adapt your site if you have
Specifically, you will have to adapt your site if you have
- overwritten the `header.html`, `menu.html` or `footer.html` partials
- self-defined output formats that display HTML
@ -37,7 +37,7 @@ weight = -0
There is a separate section in the documentation covering these cases.
- {{% badge style="warning" title=" " %}}Breaking{{% /badge %}} This release changes the way, the search index and the dedicated search page are generated. This may require reconfiguration by you to still work as you intended.
- {{% badge style="warning" title=" " %}}Breaking{{% /badge %}} This release changes the way, the search index and the dedicated search page are generated. This may require reconfiguration by you to still work as you have intended.
You need to remove the now obsolete `search` and `searchpage` output format from `[outputs.home]` in your `hugo.toml`, resulting in something similar to

View file

@ -1,4 +1,5 @@
+++
alwaysopen = false
disableToc = false
title = "What's New"
type = "releasenotes"

View file

@ -1,4 +1,5 @@
+++
alwaysopen = false
disableToc = false
title = "What's New"
type = "releasenotes"