Skip to content

bug(docs): local docs site fails to build with recommended Hugo version #7028

Closed

Description

@Prachi-Gupta2808

What happened:
Running make run/site to preview the docs locally fails with a Hugo template error in docs/layouts/partials/scripts.html.

The error might be occuring because hugo.IsServer and .Store.Get are not supported in Hugo 0.92.2 which is the version recommended in the docs README.

What you expected to happen:
make run/site should successfully build and serve the documentation site locally at http://localhost:1313 as stated in the README.

How to reproduce it:

  1. Clone the repo
  2. Install Hugo v0.92.2+extended as recommended in docs/README.md
  3. Run make run/site from the root of the repository
  4. Site fails to build with the above errors

Environment:

  • piped version: N/A
  • control-plane version: N/A
  • Others:
    • Hugo version: v0.92.2+extended
    • OS: Tested on both Windows and WSL/Ubuntu
    • Errors are in docs/layouts/partials/scripts.html lines 14 and 23

I am attaching error ss for reference

Image

Activity

  1. Prachi-Gupta2808 commented on Jul 14, 2026

    @Prachi-Gupta2808
    Author

    @Ayushmore1214 we can discuss here, please consider assigning me this issue after discussion. Thank you.

  2. Ayushmore1214 commented on Jul 14, 2026

    @Ayushmore1214
    Member
  3. rahulshendre commented on Jul 14, 2026

    @rahulshendre
    Contributor

    thanks for raising the issue @Prachi-Gupta2808, it was fixed in #6910

  4. Prachi-Gupta2808 commented on Jul 16, 2026

    @Prachi-Gupta2808
    Author

    @rahulshendre @Ayushmore1214 After the merge of #6910 and doing everything write I am still getting error while running docs locally. I tried to understand and from what I can understand there are two line in docs/layouts/partials/scripts.html which are not compatible with the mentioned hugo version.

    Line 14:

    {{ if hugo.IsServer }}
    

    hugo.IsServer is not supported in Hugo 0.148.2.

    Line 23:

    {{ if .Store.Get "hasMermaid" }}
    

    .Store is not available in the context when this partial is called.

    I have used AI too for figuring this out and then verified this, It will be very helpful if you guys can see if this is an actual issue. I can think of two fixes, first is to fix the the template syntax and second is to update the required Hugo version to the one which supports this syntax. Please reply to this when feasible.

    Image
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    kind/bugSomething isn't working as expected

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions