gohugoio / hugoDocs

The source for https://gohugo.io/
Apache License 2.0
1.03k stars 1.47k forks source link

page.Sections example seems wrong #2610

Closed willfaught closed 1 month ago

willfaught commented 1 month ago

From https://gohugo.io/methods/page/sections/:

With this content structure:

content/
├── auctions/
│   ├── 2023-11/
│   │   ├── _index.md     <-- front matter: weight = 202311
│   │   ├── auction-1.md
│   │   └── auction-2.md
│   ├── 2023-12/
│   │   ├── _index.md     <-- front matter: weight = 202312
│   │   ├── auction-3.md
│   │   └── auction-4.md
│   ├── _index.md         <-- front matter: weight = 30
│   ├── bidding.md
│   └── payment.md
├── books/
│   ├── _index.md         <-- front matter: weight = 10
│   ├── book-1.md
│   └── book-2.md
├── films/
│   ├── _index.md         <-- front matter: weight = 20
│   ├── film-1.md
│   └── film-2.md
└── _index.md

And this template:

{{ range .Sections.ByWeight }}
 <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

On the home page, Hugo renders:

<h2><a href="/films/">Films</a></h2>
<h2><a href="/books/">Books</a></h2>
<h2><a href="/auctions/">Auctions</a></h2>

Since the weight of books is 10, it has the lowest weight, so shouldn't it be listed first?