$pagination
The $pagination object divides a collection of pages, files etc. into discrete pages consisting of the number of defined items. The pagination object can then be used to navigate between these pages, create a navigation etc.
- 
		
			new Pagination()
 - 
		
			$pagination->clone()
 - 
		
			$pagination->end()
 - 
		
			$pagination->firstPage()
 - 
		
			$pagination->firstPageUrl()
 - 
		
			Pagination::for()
 - 
		
			$pagination->hasNextPage()
 - 
		
			$pagination->hasPage()
 - 
		
			$pagination->hasPages()
 - 
		
			$pagination->hasPrevPage()
 - 
		
			$pagination->isFirstPage()
 - 
		
			$pagination->isLastPage()
 - 
		
			$pagination->lastPage()
 - 
		
			$pagination->lastPageUrl()
 - 
		
			$pagination->limit()
 - 
		
			$pagination->nextPage()
 - 
		
			$pagination->nextPageUrl()
 - 
		
			$pagination->offset()
 - 
		
			$pagination->page()
 - 
		
			$pagination->pageUrl()
 - 
		
			$pagination->pages()
 - 
		
			$pagination->prevPage()
 - 
		
			$pagination->prevPageUrl()
 - 
		
			$pagination->range()
 - 
		
			$pagination->rangeEnd()
 - 
		
			$pagination->rangeStart()
 - 
		
			$pagination->start()
 - 
		
			$pagination->toArray()
 - 
		
			$pagination->total()
 
How to create a $pagination object
To create a $pagination object, you have to paginate a collection of pages and then call the pagination() method:
$articles   = page('blog')->children()->listed()->paginate(5);
$pagination = $articles->pagination();
This will give us 5 articles per pagination page.
Examples
With the object in place, we can now use the methods to create our pagination navigation
<?php if ($pagination->hasPages()): ?>
<nav class="pagination">
  <?php if ($pagination->hasNextPage()): ?>
  <a class="next" href="<?= $pagination->nextPageURL() ?>">older posts</a>
  <?php endif ?>
  <?php if ($pagination->hasPrevPage()): ?>
  <a class="prev" href="<?= $pagination->prevPageURL() ?>">newer posts</a>
  <?php endif ?>
</nav>
<?php endif ?>
Pagination
When a list of pages grows longer and longer you need to paginate it.