swcarpentry/boot-camps — pull request #2 by jiffyclub (2012-12-18 17:15:47+00:00)
Title: GitHub Pages Jekyll framework for boot camp pages

I've put together a [Jekyll](http://jekyllrb.com/) framework for the boot-camps gh-pages branch. With this instructors can write pages in Markdown and have them converted to HTML by Jekyll when they push to the gh-pages branch.

I've seeded the pages directory with a couple examples. They can be viewed live at:
http://jiffyclub.github.com/boot-camps/pages/example_page/
http://jiffyclub.github.com/boot-camps/pages/2012-10-caltech/

For a page to be compiled by Jekyll it must have some YAML at the very top of the file:

```yaml
---
layout: base
title: Example Page
---
```

This works for both Markdown and HTML files. It's optional, though. Instructors can also push fully formed HTML.

With lesson plans in the master branch written in Markdown it will be simple to convert a lesson plan to a web page by adding the above YAML block.

There are currently two layouts to choose from:
- base: Matches the style of http:software-carpentry.org minus the banner and navbar
- bare-bootstrap: Just the default styles of [Bootstrap](http://twitter.github.com/bootstrap/).

Both layouts include Disqus comments and full access to [Bootstrap's](http://twitter.github.com/bootstrap/) CSS and JavaScript. Syntax highlighting can be turned on using [Jekyll's Liquid extensions](https://github.com/mojombo/jekyll/wiki/Liquid-Extensions):

```
{% highlight python %}
def hello_world():
print 'Hello, world!'
{% endhighlight %}
```

If this gets accepted I'll add documentation to the boot-camps wiki on creating boot camp pages.