Jekyll-Improved-Paginator-Plugin

Jekyll's built-in paginator sucks! You are forced to use index.html to paginate only posts, for reasons I don't understand, and you have to work-around with what I feel is too much restriction; so this repo contains a plugin that fixes that, or attempts to (would be great to contrib to mainline). You can list a specific collection, or all posts, and pagination works seamlessly supporting some edge use-cases I felt the paginator did not address.

Usage:

1. download the _plugins/listing_pages.rb and place in your _plugins folder

2. In the page(s) you wish to use include the relevant frontmatter (changing as required) list_for: posts list_limit: 2

3. Include the relevant liquid to list your objects

   ```liquid

   {% if page.pages >= 1 %}

   Page {{ page.curpage }} of {{ page.pages }}, {{ page.list_for }} {{ page.min_rec }} to {{ page.max_rec }} {% for item in page.list %}

   • {{ item.title }}

     {{ item.date | date: "%b %-d, %Y" }} {{ item.excerpt }} More...
   {% endfor %}

   {% endif %} {% if page.pages > 1 %} {% capture nextpg %}{{ page.curpage | to_i | plus: 1 }}{% endcapture %} {% capture prevpg %}{{ page.curpage | to_i | minus: 1 }}{% endcapture %}

   {% if page.curpage > 1 %} « Prev {% endif %} {% for pg in (1..page.pages) %} {% if page.curpage == pg %} {{ pg }} {% else %} {{ pg }} {% endif %} {% endfor %} {% if page.curpage < page.pages %} Next » {% endif %}

   {% endif %}