Only auto-create sections for home and first level

[bep]

I'm in the process of a simplification of how we create the "page tree" (and especially the section tree) in preparation for #6041 -- but also needed for the things coming ahead.

This is mostly code simplification which also should (probably) make it a little faster. But there is one part of the "section logic" that I will remove. Both because it is complicated and hard to maintain, but also because I suspect many people don't like the current behaviour, and it's kind of impossible to opt-out off.

Currently, with this tree:

content
├── a
│   └── b
│       └── c
│           └── d
│               └── _index.md
└── b

• Hugo will create a section for a/b/c/d because it has a "_index.*" content file.
• Hugo will also create sections for a, a/b, a/b/c and b.
• Hugo will also create a home page (aka the root section).

With the new simplified behaviour, Hugo will only "auto create" sections for the home page and the top level folders.

So in the example above, home page and a and b will be "auto created", a/b/c/d will be a section because of its _index.md file.

Also related:

#6153
#6154

[kaushalmodi]

So in the example above, home page and a and b will be "auto created", a/b/c/d will be a section because of its _index.md file.

Sounds fair.. so if one needs to retain the auto-creation of a/b and a/b/c, they simply need to create those two _index.md that I show below with the † sign, right?

content
├── a
│   └── b
│       ├── _index.md†
│       └── c
│           ├── _index.md†
│           └── d
│               └── _index.md
└── b

[kaushalmodi]

@bep So from your content tree structure:

content
├── a
│   └── b
│       └── c
│           └── d
│               └── _index.md
└── b

below is a good summary?

	Created right now?	Will be created after this change?
Hugo will create a section for a/b/c/d, because it has a content file.	Yes	Yes
Hugo will also create sections for a and b, because they are top level folders.	Yes	Yes
Hugo will also create a home page (aka the root section).	Yes	Yes
Hugo will also create sections for a/b and a/b/c.	Yes	No, because they do not have any content _index.md file.

[bep]

Sounds fair.. so if one needs to retain the auto-creation of a/b and a/b/c, they simply need to create those two _index.md that I show below with the † sign, right?

Yes. Which is kind of "manual" and not automatic... But I think less magical and certainly more flexible.

Your table is almost spot on.: No, because they don't have any "_index.*" file

[bep]

Ref. the discussion above, and esp. @kaushalmodi 's table: Does this change make sense? If you see some unforeseen consequences, please explain below.

[bep]

This was fixed in 7ff0a8e

[github-actions]

This issue has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.