Content

Content

This document is designed to help you write and edit content on the website.

Creating a blog post

Blog posts are stored as markdown files inside the _posts directory. The files must be named using the following format: YYYY-MM-DD-title.md.

All blog posts must use the following template to be displayed correctly:

---
layout: post
title:  "My first blog post!"
date:   YYYY-MM-DD HH:MM:SS
categories: blog post
---

This is my *first* blog post. It uses Markdown, which you can [Google](http://google.com) to learn about.

To create a blog post, copy that template and modify it to include your content. Take care to modify the categories, the date and the title from the header (the bit between the --- lines)! Save your file using the naming scheme describe - for example 2001-12-25-holiday-wishes.md.

Creating a main page

To create a main page, such as an about us page, a markdown file should be saved in the project's root directory, using the desired URL as the filename. For example, to create an about us page that will be served at /about.html, name the file about.md.

Formatting

In addition to markdown, there are several liquid tags that can be used to format your posts. These tags surround the content to be modified.

Code snippets

To embed a highlighted code snippet in your post, wrap the code in highlight liquid tags. The output will look similar to the code snippet below.

{% highlight ruby %}
  # your code goes here
{% endhighlight %}

To add line numbers, use the following open tag: {% highlight ruby linenos %}.