Docsy: Contents hierarchy depth change between Hugo v0.56.3 and v0.67.0

[myitcv]

Hi - I wonder if someone can point me in the right direction. Apologies in advance if I don’t use the right terms to describe the problem we’re seeing.

The Hugo page in question is: https://cuelang.org/docs/references/spec/#closed-structs
Hugo v0.56.3, docsy theme.

As you can see from the RHS contents index section, all heading levels are included in the result, including h4 (e.g. “Closed Structs”) - linked above.

However upgrading from Hugo v0.56.3 to v0.67.0, with no other changes, results in only headings down to h3 being included in the contents index:

Can anyone point me in the right direction? Is there a default value that has changed which now needs to be overridden?

Thanks

[alexandros]

@myitcv

A lot of things have changed since Hugo 0.56.3 and it seems that you need to update Docsy, since the theme in the cuelang.org repo, has not been updated in 7 months.

If updating does not solve the issue, then this question is better suited for the Docsy theme repo.

This is a very complex theme. Personally I do not have the time to debug it. If others have the time to look into it hopefully they will come forward.

Thanks for the understanding.

[myitcv]

Thanks for taking the time to response.

Not sure why I didn’t think about raising an issue in the docsy repo. I’ll do that now.

[bep]

@myitcv we added Goldmark as the default markdown engine some time ago. That also allowed us to fix the ToC – which now defaults to starting from level2 (which I suspect most people want).

You can configure this (see docs) or configure the site to use Blackfriday.

Note that this is something you can configure in your own site.

[myitcv]

Thanks very much, @bep. That’s exactly it - adding the relevant configuration for Goldmark (https://gohugo.io/getting-started/configuration-markup/) did the trick.