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 _index.md file that acts as a section page with a corresponding template in layouts/docs/list.html.

There is currently no index.md or _index.md 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 _index.md 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: