Со временем в блогах появляется множество постов, тогда необходимо выводить их в небоьлшой список и выводить в несколько страниц. В Jekyll появляется плагин для пагинации и возможность генерировать соответствующие файлы и папки автоматически. Для этого необходимо добавить jekyll-paginate плагин в список плагинов _config.yml.

plugins:
  - jekyll-paginate

Внимание Пагинация работает только в файле index.html, не работает в других разметках. Чтобы указать количество постов на странице используется свойства paginate, а ссылка с помощью pagination_path

paginate: 5
pagination_path: /blog/:num/

Jekyll запишет первые 5 постов в /blog/index.html, следующие пять /blog/2/index.html и так далее. В index.html доступен массив paginator со значениями:

  • page - номер текущей страницы
  • per_page - количество постов на странице
  • posts - список всех постов на текущей странице
  • total_posts - количество всех постов на сайте
  • total_pages - количество страниц пагинации
  • previous_page - предыдущая страница пагинации или nil
  • previous_page_path - путь до предыдущей страницы пагинации
  • next_page - следующая страница пагинации или nil
  • next_page_path - путь до следующей страницы пагинации