Sur cette page

• Configurer la pagination
• La surcharger pour une section
• Afficher les pages paginées
• Ajouter les liens de navigation

Paginer une liste de pages

Lorsqu’une section contient de nombreuses pages, Cecil peut découper sa liste en plusieurs pages (ex. : /blog/, /blog/page/2/, /blog/page/3/, etc.) et fournit un paginator pour construire les liens de navigation.

Configurer la pagination

La pagination est activée par défaut pour les pages de liste (homepage, section et term), avec 5 entrées par page. Modifiez-la dans cecil.yml :

pages:
  pagination:
    max: 10    # nombre maximum d’entrées par page
    path: page # chemin des pages paginées

La surcharger pour une section

Définissez la variable pagination dans le front matter du fichier index de la section (ex. : pages/blog/index.md) :

---
title: Blog
pagination:
  max: 20
---

Ou désactivez-la pour cette section uniquement :

---
pagination: false
---

Afficher les pages paginées

Le paginator n’existe que lorsque la liste contient plus de pages que max. Lorsque la pagination est désactivée, ou lorsque toutes les pages tiennent sur une seule page, page.paginator est vide.

Dans le template de liste (ex. : layouts/blog/list.html.twig), bouclez sur page.paginator.pages et utilisez page.pages.showable en l’absence de paginator :

{% for p in page.paginator.pages ?? page.pages.showable %}
  <article>
    <h2><a href="{{ url(p) }}">{{ p.title }}</a></h2>
    <time datetime="{{ p.date|date('c') }}">{{ p.date|date('j M Y') }}</time>
  </article>
{% endfor %}

Ajouter les liens de navigation

Les liens du paginator sont des identifiants de pages : utilisez la fonction url() pour créer des liens fonctionnels. Le test {% if page.paginator %} masque la navigation en l’absence de paginator :

{% if page.paginator %}
<nav>
  {% if page.paginator.links.prev is defined %}
  <a href="{{ url(page.paginator.links.prev) }}" rel="prev">Previous</a>
  {% endif %}
  <span>Page {{ page.paginator.current }} of {{ page.paginator.count }}</span>
  {% if page.paginator.links.next is defined %}
  <a href="{{ url(page.paginator.links.next) }}" rel="next">Next</a>
  {% endif %}
</nav>
{% endif %}

Pour lister tous les numéros de page, itérez de 1 à page.paginator.count :

{% if page.paginator %}
<nav>
  {% for i in 1..page.paginator.count %}
    {% if i == page.paginator.current %}
  <span aria-current="page">{{ i }}</span>
    {% elseif i == 1 %}
  <a href="{{ url(page.paginator.links.first) }}">{{ i }}</a>
    {% else %}
  <a href="{{ url(page.paginator.links.path ~ '/' ~ i) }}">{{ i }}</a>
    {% endif %}
  {% endfor %}
</nav>
{% endif %}