Posts Directory
If you want to start a blog, create a _posts
directory to store your blog posts as per normal Jekyll usage, with layout: post
.
Creating a Post
Create a new file in the _posts
directory with the filename format yyyy-mm-dd-blog-post-name.md
where yyyy is the year, mm is the month and dd is the day.
In the front matter, use the layout: post
. You can also use the same settings as when creating a page to configure the hero.
layout: post
title: The Blog Post Title
subtitle: The blog post subtitle
hero_image: /path/to/image.jpg
hero_darken: true
Blog Page
Next, create a blog
directory with an index.html file that has layout: blog
.
Pagination
Set paginate
and paginate_path
in your site’s _config.yaml
to configure the posts per page and blog pagination path.
paginate: 5
paginate_path: "/blog/page:num"
Other settings
It will display an image in the blog page if you set image: /path/to/image.jpg
in your post’s or page’s front matter, or in the defaults in your site’s _config.yml
.