Розбиття списку постів на сторінки застосовується на багатьох сайтах, і в особливості блогах. У Jekyll є плагін для розбивки на сторінки і ви можете автоматично генерувати необхідні для цього каталоги і файли.
У Jekyll версії 2 розбивка на сторінки була вбудованої, починаючи з версії 3 треба підключати плагін jekyll-paginate в Gemfile і в _config.yml.
Розбивка на сторінки працює лише з HTML-файл
Розбивка на сторінки не працює з файлами Markdown або Textile, тільки HTML. Але це навряд чи буде проблемою, так як ви використовуєте розбивку для списку постів
Активація розбивки
Для активації розбивки на сторінки в вашому блозі треба додати в _config.yml наступний параметр, що визначає кількість записів на сторінці:
Ви також можете визначити місце призначення для сторінок з розбивкою:
Це буде зчитуватися в blog / index.html. кожна сторінка з розбивкою буде доступна як змінна liquid paginator. а висновок буде записуватися в blog / page: num /. де num номер сторінки з розбивкою, починаючи з 2. Якщо на сайті 12 постів і задано paginate: 5. Jekyll створить blog / index.html з першими 5 постами, blog / page2 / index.html з наступними 5 постами і blog / page3 / index.html з двома останніми постами.
Не ставте постійне посилання
Завдання постійної посилання у вступній вашого блогу може порушити розбивку на сторінки.
Доступні атрибути Liquid
Плагін розбивки на сторінки робить доступним об'єкт paginator і його атрибути:
Рендеринг сторінок з розбивкою
Наступна річ, яку вам треба зробити це безпосередньо вивести список постів, використовуючи доступну вам змінну paginator. Швидше за все, ви захочете це зробити на одній з основних сторінок свого сайту. Ось зразок простого рендеринга розбитих на сторінок постів в файлі HTML:
Остерігайтеся сторінки №1
Jekyll не створює каталог page1. тому код з прикладу не зможе працювати з посиланням на / page1. Нижче зазначений спосіб вирішення цієї проблеми