Pagination about zola HOT 6 CLOSED

Now that we have a _index.md for sections we could use its front matter to setup pagination but that doesn't really work in the case of a simple blog with only posts.

We could have a default pagination setting in config.toml for that case but it feels like having the behaviour in 2 places.

The sensible way (it seems) is to:

• have a default for pagination in config.toml: defaults to no pagination but can be set up to paginate by setting num_per_page, pagination_path and paginate. This will apply to the index only.
• Sections have to enable paginations and can override num_per_page and path_name in their frontmatter, no pagination will be created implicitely.

pagination_path is the path to be used in the URL, it could be page by default. It would like mysite.com/page/2 etc in that case.

That should cover 99% of the cases

from zola.

We could also have a _index.md for the actual index page instead of putting the default in the config but I'm not sure it's worth it.
In practice, in a mixed content site (landing page + blog for example), the index page will not be the one paginated. I can't think of an example where it would be the case: paginating different kind of content doesn't really make sense.

from zola.

No clue on how to handle pagination for the index page: what do you do if you have a couple of static pages + posts? Having your about page in the pagination doesn't make sense.

I'll only paginate sections for now and we can figure out the index section later (maybe only paginate pages that have a date or a weight?)

from zola.

See #34 for basic implementation, doesn't paginate index page yet

from zola.

Will be easier after #14 to generalise I think and with the _index.md for the index page

from zola.

#55 should do the trick

from zola.