Hugo 0.146.3: preview of docsy userguide fails

support
1

How to reproduce:

git clone https://github.com/google/docsy.git
cd docsy/userguide
hugo server --themesDir ../..

Preview fails with hugo 0.146.1:

WARN  Module "docsy" is not compatible with this Hugo version: Min 0.110.0 extended; run "hugo mod graph" for more information.
Error: html/template:_markup/render-heading.html:1:12: no such template "_default/_markup/td-render-heading.html"

With hugo 0.145.0, preview succeeds.

2

Should I run npm i? If yes, should I run it in the root directory or in the userguide directory?

4

Yes.

Run it in the userguide directory, please.

Thanks for investigating!

5

When I do this:

git clone https://github.com/google/docsy.git
cd docsy/userguide
npm i

I get this:

> prepare
> cd .. && npm install

npm warn deprecated npmlog@5.0.1: This package is no longer supported.
npm warn deprecated rimraf@3.0.2: Rimraf versions prior to v4 are no longer supported
npm warn deprecated are-we-there-yet@2.0.0: This package is no longer supported.
npm warn deprecated glob@8.1.0: Glob versions prior to v9 are no longer supported
npm warn deprecated gauge@3.0.2: This package is no longer supported.
npm error code 7
npm error path /home/jmooring/temp/docsy/node_modules/netlify-cli/node_modules/sharp
npm error command failed
npm error command sh -c (node install/libvips && node install/dll-copy && prebuild-install) || (node install/can-compile && node-gyp rebuild && node install/dll-copy)
npm error A complete log of this run can be found in: /home/jmooring/.npm/_logs/2025-04-13T14_37_00_154Z-debug-0.log
npm error code 7
npm error path /home/jmooring/temp/docsy/userguide
npm error command failed
npm error command sh -c cd .. && npm install
npm error A complete log of this run can be found in: /home/jmooring/.npm/_logs/2025-04-13T14_36_55_509Z-debug-0.log
6

After spending far too long messing with this, I can finally build the site by doing this:

git clone https://github.com/google/docsy.git
cd docsy/
sed -i /netlify-cli/d package.json   # don't install the netlify-cli package
sed -i /hugo-extended/d package.json # don't install hugo-extended package
cd userguide/
npm i
hugo --themesDir ../..

The above emits the error as described:

Error: error building site: html/template:_markup/render-heading.html:1:12: no such template "_default/_markup/td-render-heading.html"

The error is triggered by this call in layouts/_default/_markup/render-heading.html:

{{ template "_default/_markup/td-render-heading.html" . -}}

The _markup directory is for render hooks, not partial templates, so the above is unexpected and doesn’t make sense to me. Additionally, I don’t understand why it calls the template function instead of the partial function. To fix this, use a partial template and update the related documentation in content/en/docs/adding-content/navigation.md.

After fixing the above, the next error is:

Error: error building site: html/template:_partials/head.html:23:46: no such template "partials/page-description.html"

The error is triggered by this call in layouts/partials/head.html:

{{ template "partials/page-description.html" . }}

Change the above to:

{{ partial "page-description.html" . }}"

Both of these are related to https://github.com/gohugoio/hugo/issues/13599, which I suspect we won’t address. Please read my commentary at the bottom of that issue description.

1 Like
7

This topic was automatically closed 2 days after the last reply. New replies are no longer allowed.