Pagination options

[tim-at-topos]

Description

At the moment, pagination for listings shows the current page number and up to two pages either side. It would be nice to have slightly more control over this. For example, it would be very helpful to be able to have a button for the first/last page to always be present — at the moment trying to navigate to the last page of a ~20 page listing takes a lot of clicks!

[mcanouil]

This should be customisable in the EJS listing templates.
Did you try?

Or maybe you are asking to add YAML options for the default listings?

[tim-at-topos]

I'm currently using the default listing templates, so a YAML option would be easiest, and I think useful to people in general, since the default listing templates are pretty solid.

If there's a simple way to customise this in EJS though, it would be useful as a workaround. I just know that it's a bit complicated to try to create a new custom template based on one of the existing ones (#5837)

[mcanouil]

I'll take a look and maybe I'll figure out something to make a PR otherwise it will be a workaround until the team can work on this.

[tim-at-topos]

oh amazing, thank you!

[mcanouil]

Hum, actually, the pagination is styled with Bootstrap but performed by list.js.
I can easily achieve the following (outerWindow: 1):

Compared to:

To change the default, it would require a little change:

• quarto-cli/src/project/types/website/listing/website-listing-template.ts

  Lines 531 to 532 in 3ff49d5

  	pagination: { item: "<li class='page-item'><a class='page page-link' href='#'></a></li>" },`
  	: "";

- pagination: { item: "<li class='page-item'><a class='page page-link' href='#'></a></li>" },`
+ pagination: { item: "<li class='page-item'><a class='page page-link' href='#'></a></li>", outerWindow: 1 },`

The complete API is https://listjs.com/docs/pagination/

If pagination takes a list of values, it should take them all.

I'm not sure there is a workaround here as far as my JavaScript expertise goes.
Even without adding parameters, I think the default should set outerWindow: 1.

[mcanouil]

Very early but I have something that works

• feat: customise pagination options for listings #13126