Mermaid rendering issue when using hugo v0.145.0

[csviri]

Environment

• Version of Docsy you are using: 0.11.0
• How are you using Docsy? As a:
  • Hugo module
  • NPM module
  • Git submodule
  • Other:
• Version of Hugo you are using (output of hugo version): hugo v0.145.0+extended+withdeploy darwin/arm64 BuildDate=2025-02-26T15:41:25Z VendorInfo=brew
• OS:
  • Linux
  • macOS
  • Windows
  • Other:

Problem

When try to render locally with this hugo version, it fails on mermaid scripts error:

ERROR render of "path/docs/content/en/docs/workflows/_index.md" failed: "/Users/me/Library/Caches/hugo_cache/modules/filecache/modules/pkg/mod/github.com/google/docsy@v0.11.0/layouts/docs/baseof.html:33:7": execute of template failed: template: docs/list.html:33:7: executing "docs/list.html" at <partial "scripts.html" .>: error calling partial: "/Users/me/Library/Caches/hugo_cache/modules/filecache/modules/pkg/mod/github.com/google/docsy@v0.11.0/layouts/partials/scripts.html:73:4": execute of template failed: template: partials/scripts.html:73:4: executing "partials/scripts.html" at <partial "scripts/mermaid.html" .>: error calling partial: "//Users/me/Library/Caches/hugo_cache/modules/filecache/modules/pkg/mod/github.com/google/docsy@v0.11.0/layouts/partials/scripts/mermaid.html:5:10": execute of template failed: template: partials/scripts/mermaid.html:5:10: executing "partials/scripts/mermaid.html" at <.Err>: can't evaluate field Err in type resource.Resource

[deining]

When try to render locally with this hugo version, it fails on mermaid scripts error:

This is a known issue, reported with #2176 and fixed with #2177.

There are three options your you:

• You can either wait for a new release (as proposed/demanded from others, too).
• Or you can copy over latest version of layouts/partials/scripts/mermaid.html to your site, thus overriding the faulty script file from the theme. Once upgrading to a docsy version that contains the fix, don't forget to remove this file again!
• Or you can update your site to HEAD of repo:

  hugo mod get -u github.com/google/docsy@latest
  

  Afterwards, you should be able to run your site with hugo 0.145.0.

Hope that helps.

[csviri]

awesome, thx @deining !

[Frank-Krick]

In case somebody else is not a Hugo expert and wonders what Or you can copy over latest version of [layouts/partials/scripts/mermaid.html](https://raw.githubusercontent.com/google/docsy/refs/heads/main/layouts/partials/scripts/mermaid.html) to your site, thus overriding the faulty script file from the theme. Once upgrading to a docsy version that contains the fix, don't forget to remove this file again! practically means:
go into you site directory, and do the following:

cd layouts
mkdir -p partials/scripts
cd partials/scripts
wget https://raw.githubusercontent.com/google/docsy/refs/heads/main/layouts/partials/scripts/mermaid.html