How can I create a page in jekyll?

Question

I know how to create a post in jekyll, but how can I create a page (like About) without it being considered as a post?

Also, I use Github pages, so I can't use extensions.

Answer 1

If you create a file called about.html, about.markdown or about.textile in the root of your project it will be treated as a static page.

You can still give it some YAML front matter and jekyll if you wish to share a template etc.

It's all explained on the jekyll wiki at https://github.com/mojombo/jekyll/wiki/usage

Here's an excerpt from my about.markdown file

---
layout: default
title: About | Purebreeze
---

I'm a software developer based in London...

That's saying use the default template, set title to "About | Purebreeze" (which is rendered via a liquid tag in my default template) and then the contents of my about page.

This is then rendered at http://purebreeze.com/about by github (by default this would have been (http://levent.github.com/about)

Answer 2

This looks like a bug. But there's a workaround: create a directory called eg. "about" and put your content into about/index.[fill in the blank]. (oh, and by the way, report it.)