Issue: Hugo auto-generates an undesired list page

For reference, this question is related to the Jaeger webpage.

I have a docs section of the site with two documentation versions: 1.5 and 1.6, stored in content/docs/1.5 and content/docs/1.6, respectively. Each of those versions has a file that acts as a section page with a corresponding template in layouts/docs/list.html.

There is currently no or in content/docs and this is by design, because I don’t want there to be a /docs/index.html page. And yet Hugo is auto-generating a /docs/index.html page using the docs list template. Is there a way to keep it from doing this?

Known issue.

See this Forum thread for workarounds: Override section url

Also search around the Forum.

BTW in Hugo the top level Section list page is always generated. An can be used to pass front matter to that list page but its inclusion is not related to the generation of that page.

I’d redirect docs/ to the latest version of the docs.

That’s what I ended up doing. Works fine from a navigation perspective, although I do wish I didn’t have that page sitting on the internet with SEO tags and such. Oh well, no biggie :slight_smile: