Hugo 0.146.3: preview of docsy userguide fails

support
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