Working with Jekyll

You’ll find this post in your _posts directory. Go ahead and edit it and re-build the site to see your changes. You can rebuild the site in many different ways, but the most common way is to run jekyll serve, which launches a web server and auto-regenerates your site when a file is updated.

Jekyll requires blog post files to be named according to the following format:

YEAR-MONTH-DAY-title.MARKUP

Where YEAR is a four-digit number, MONTH and DAY are both two-digit numbers, and MARKUP is the file extension representing the format used in the file. After that, include the necessary front matter. Take a look at the source for this post to get an idea about how it works.

Jekyll also offers powerful support for code snippets:

def print_hi(name)
  puts "Hi, #{name}"
end
print_hi('Tom')

=> prints 'Hi, Tom' to STDOUT

Check out the Jekyll docs for more info on how to get the most out of Jekyll. File all bugs/feature requests at Jekyll’s GitHub repo. If you have questions, you can ask them on Jekyll Talk.

This is more of a reminder for me, but feel free to use them if it’s helpful. I’m currently in the process of converting my old Wordpress site to Jekyll.

Useful Markdown and Jekyll Links

• Quick-Start Guide for Minimal Mistakes my current theme.
• Handy Minimum Mistakes Cheatsheet that should help me as I’m updating my blog.
• Wordpress addon called Wordpress Jekyll Explorer that I’m going to try and use to export my old Wordpress Site to a Jekyll. Here is a helpful links that describe a number of options for converting WordPress to Jekyll. I’ll update these link as then try them, at the moment they are a reminder to myself.
• Markdown Cheatsheet for Github and Jekyll -Install instructions for Algolia search integration for my Jekyll Website.
• Jekyll-Algolia Algolia Community Website for Jekyll -Personal Website of Peter Wills where I found some handy tutorials and tips on using Minimal Mistakes
• Personal Website of Renato Golia where I found some handy tutorials and tips on using Minimal Mistakes
• Shanto Roy’s Minimal Mistakes Website, here I found some good instuctions on setting up google analytics.