search

cobalt-org / cobalt.rs

Static site generator written in Rust
cobalt-org.github.io/
Apache License 2.0
1.38k stars 102 forks source link

What do we call "pagination" #680

Open epage opened 5 years ago

epage commented 5 years ago

Really, what we are calling "pagination" is auto-generating of some kind of index page with the option to paginate it. Is there a more clear name?

Geobert commented 5 years ago

It is true that at the beginning, I only wanted to provide a way to have a per_page attributes of some kind in order to limit the number of posts in my home page.

It changed to something way more powerfull and it's great but maybe the name does not fit anymore.

I'll put a background task in my brain, maybe a shower idea will pop up ^^

EDIT: pagination of index is not an option, only tweakable with the per_page but it is always active

Geobert commented 5 years ago

"Paginated indexation"?

epage commented 5 years ago

I don't think we need paginated in the name. That is a feature within it.

Keep in mind, this will also impact things like the paginator object.

Geobert commented 5 years ago

"Indexation"?

So we change paginator to indexator? But having fields like indexes, index… can be confusing, can't it?

epage commented 5 years ago

"Indexation" looks to only be a word related to economics.

This might be something helped by us going back over and comparing where we ended up with how other SSGs do any of this. Maybe they came up with good names. Plus, if we have a name that matches a popular feature in another SSG, it can help in comparison / migration.

Geobert commented 5 years ago

When reading: https://gohugo.io/templates/pagination/ https://jekyllrb.com/docs/pagination/ https://www.getzola.org/documentation/templates/pagination/ https://github.com/sverrirs/jekyll-paginate-v2/blob/master/README-GENERATOR.md

It really feels that our feature is doing the same. The only thing is that we support Date, and some of them support pagination of collections.

epage commented 5 years ago

For Hugo, it looks like their equivalent is a Section Page, Home Page, and Taxonomy Pages which can then have a paginator configured.