[SECTION/TAXONOMY]/index.html
[SECTION/TAXONOMY]/page/1/index.html => redirect to [SECTION/TAXONOMY]/index.html
[SECTION/TAXONOMY]/page/2/index.html
....
The partial below shows how the pagination navigation is built:
I believe this should be pretty feature-complete, and most of the terms I’m pretty happy with.
But there is a Paginator with a Paginated slice … This sounds fishy. The top level Paginator sounds OK, I guess – and the Paginated should be Pages, but that’s in use for something else.
Note: I will make sure that you would have to turn this feature on, and if you do nothing it will work as before.
While we’re still in pre-1.0, my vote is to turn on pagination by default. That’s what anyone migrating to Hugo is going to expect.
I also think you should add the pagination ul from above as a built in partial / shortcode. That makes a good default for most people, and people can copy it out if they want to customize it.
I also think the built-in redirect for /page/1 is a great touch.
I just glanced through the code in your PR, and I don’t see why you couldn’t have a {{ .Paginator.Pages }}. I think the top level Paginator is good, but I would definitely rename .Paginated to .Pages.
I actuallly have .Pages – which is what you would expect in Hugo, all the pages for “that page”, and what you would use to actually iterate and show post/page info in the list template:
{{ range .Data.Paginator.Pages }}
And then there is the Paginated list, holding pagination info (next, prev, page count etc.), used to build the paginator buttons:
{{ range .Data.Paginator.Paginated }}
I guess it boils down to having a different term for the last one.
Sorry for the delay I only found the time now to test. I’ve downloaded your branch, compiled Hugo, changed the variable name to loop over as you mentioned in a comment above in my theme and built my website but I still have nothing (whether on the homepage or categories pages).
Did you changed something else on my testing example to make it works ?
I will add a pull request later to your branch with my changes - but I’m pretty confident that if works fine. I have it runnng full throttle on 4 sites now, 2 of them use a theme.