Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
tree: 1b14bbda22
Fetching contributors…


Cannot retrieve contributors at this time

file 88 lines (49 sloc) 2.502 kb


This repository drives Brighter Planet's blog, Safety in Numbers via Jekyll on GitHub Pages.

To start blogging

$ git clone

To add a post

Always start out with

$ git pull

You're going to create a file in the _posts directory named like:


So, for example:

$ mate _posts/

The extension says what markup language you want to use. "md" is for Markdown, which is my fave, but you can use "textile," "html," etc.

At the top of your file you'll need a metadata section that looks like this:

title: Relaunching the blog
author: Andy
layout: post
categories: meta

(The three dashes at the top and bottom are important.)

Author is your first name, layout should always stay "post", and categories (if you want any) can either be a single category or a list of categories in brackets (e.g. [rails, middleware]). If you use categories, make sure they've been created (see below).

Whatever goes below this metadata section is your post.

To specify what goes in "Read More"

Wrap the part that gets hidden with these HTML comments: (verbatim!)

title: some post
layout: post

Some intro, this will be visible on the index page.

<!-- more start -->

More content, this will not be visible on the index page.

<!-- more end -->

The "more end" comment should go at the bottom of the document, below everything else.

See 2011-01-13-announcing-our-new-parcel-shipment-model.markdown for a good example and make sure that you always put BOTH comments, "more start" and then "more end".

The process is taken from

To preview your post/changes

$ jekyll --server

Then go to localhost:4000

To push your post/changes

$ git add _posts/
$ git commit -m "First draft of 'My Awesome Post'"
$ git push

Then go to

To add a category/tag

Open _config.yml and add your tag to the list:

cats: [rails, middleware, meta, awesometag]

Copy rails.html to awesometag.html, change the title at the top and the header on line 5.

When in doubt

Just look at older posts for guidance

Something went wrong with that request. Please try again.