Jekyll, as it turns out, is a really nice blogging platform parsing engine. One of the nice things about it is the flexibility. In my current Jekyll set up I’ve added metadata to the YAML for posts, so that I can optionally define a post cover (or image, if you’d prefer) and a width for the cover.
This can be done easily enough by simply adding new lines to the YAML block at the top of your markdown. The default YAML block is as follows:
---
layout: post
title:
categories:
tags:
---
To add your own, you just need to create a key: value line in the block as follows:
---
layout: post
title:
categories:
tags:
cover: http://path/to/image.png
cover_width: 520px
---
These are all accessible within the page templates, as for example {{ page.title }} or {{ page.tags }}, as detailed on the Jekyll Bootstrap template API page.
To access these new values we just need to use {{ page.cover }} or {{ page.cover_width }} within our template.
Defining these each time we create a post can be a bit of a waste of time though, as it means we need to add these lines to the YAML block – why not just add them to the Rakefile that generates a new post? To do this, we need to edit the Rakefile:
- Open the
Rakefilein your text editor - Look for the line starting with
puts "Creating new post: #{filename}"(this should be line #23) - Below this, you should see the default YAML block, this is where you add your lines.
You can see my modified YAML block from the Rakefile below (note: I don’t use the categories or tags in the YAML block, so I have removed these lines):
puts "Creating new post: #{filename}"
open(filename, 'w') do |post|
post.puts "---"
post.puts "layout: post"
post.puts "title: \"#{title.gsub(/-/,' ')}\""
post.puts "cover: "
post.puts "cover_width: "
post.puts "---"
post.puts "{% include JB/setup %}"
end
Now, next time you run rake post title="Some new post" your new post markdown file will contain your custom lines in the YAML block, ready to be used in your post templates.