Fork me on GitHub

The post_list.html include renders lists of blog posts, with support for filtering by category or tag.

Listing all published posts

To render a list of all the site’s posts:

{% include post_list.html %}

Listing draft posts

To render a list of draft posts only, pass drafts=true:

{% include post_list.html drafts=true %}

Listing posts in a category

To render only posts from a given category pass category="some-category" to post_list.html:

{% include post_list.html category="some-category" %}

Listing posts with a tag

To render the list of posts with a given tag pass tag="some-tag" to post_list.html:

{% include post_list.html tag="some-tag" %}