Welcome to Jekyll!

Type 2+ characters.

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.

Quick blog/wiki cheatsheet

  • Front matter (blog): title, date, tags, optional categories, layout: post.
  • Front matter (wiki): title, summary, category, subcategory, tags, date, layout: wiki.
  • Internal links: [text](/wiki/slug/).
  • External images: ![alt](https://...) or {% include external-image.html src="https://..." alt="..." max="800px" caption="..." %}.
  • Code blocks: fenced ruby etc.
  • Sorting: date drives ordering (newest first); set date:.
  • Tags: tags: [tag1, tag2] show on home and /tags/.