mojombo/jekyll — pull request #709 by mojombo (2012-12-26 22:53:07+00:00)
Title: Site generation and release process

I'd like to deploy @cobyism's awesome site to jekyllrb.com soon. Before we do that it's prudent to have a process in place whereby the site can be modified, previewed, and deployed with ease. This branch brings the site files into the master branch (under the `site` dir) and provides some Rake tasks to make it easy to preview and deploy the site via gh-pages.

To preview the site, run:

`rake site`

To release the site to production (don't do this!), run:

`rake site_release`

The above command will copy the site to the gh-pages branch and push it to GitHub. Once the site is in master it will be easy for people to update it when they update code, making it possible to finally keep code and docs in sync. When a new version is released, the site can also be released with a single command.

Down the road I'd like to pull the actual docs out of the Jekyll site and into a more appropriate format that is then converted into the Jekyll format. But that's another story and will take some time to figure out. For now, this gets us much closer to a workable solution with the new site.

This will also mean the deprecation of the Wiki. When the new site goes live I'd like to update all the Wiki pages (except the list of example sites) to point to the new website pages.