HUGO

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

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:

Screen Shot 2020-03-10 at 13.43.18

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

Thanks

@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.

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.

@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.

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

1 Like

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