Add documentation about paginate_path to "Templates" page in the docs. Closes #1129.

This commit is contained in:
Parker Moore 2013-06-08 17:46:58 +02:00
parent 03bdc2a2df
commit c4cf167ff1
1 changed files with 12 additions and 0 deletions

View File

@ -32,6 +32,18 @@ paginate: 5
The number should be the maximum number of Posts youd like to be displayed per-
page in the generated site.
You may also specify where the destination of the pagination pages:
{% highlight yaml %}
paginate_path: "blog/page:num"
{% endhighlight %}
This will read in `blog/index.html`, send it each pagination page in Liquid as `paginator`
and write the output to `blog/page:num`, where `:num` is the pagination page number,
starting with `2`. If a site has 12 posts and specifies `paginate: 5`, Jekyll will write
`blog/index.html` with the first 5 posts, `blog/page2/index.html` with the next 5 posts
and `blog/page3/index.html` with the last 2 posts into the destination directory.
## Liquid Attributes Available
The pagination plugin exposes the `paginator` liquid object with the following