Step 2) Customize and view your site

Enter your site name, description, avatar and many other options by editing the _config.yml file. You can easily turn on Google Analytics tracking, Disqus commenting and social icons here too.

Making a change to _config.yml (or any file in your repository) will force GitHub Pages to rebuild your site with jekyll. Your rebuilt site will be viewable a few seconds later at http://yourgithubusername.github.io - if not, give it ten minutes as GitHub suggests and it’ll appear soon

There are 3 different ways that you can make changes to your blog’s files:

Edit files within your new username.github.io repository in the browser at GitHub.com (shown below).

Use a third party GitHub content editor, like Prose by Development Seed. It’s optimized for use with Jekyll making markdown editing, writing drafts, and uploading images really easy.

Clone down your repository and make updates locally, then push them to your GitHub repository.

Step 3) Publish your first blog post

You can add additional posts in the browser on GitHub.com too! Just hit the + icon in /_posts/ to create new content. Just make sure to include the front-matter block at the top of each new blog post and make sure the post’s filename is in this format: year-month-day-title.md

Local Development

Install Jekyll and plug-ins in one fell swoop. gem install github-pages This mirrors the plug-ins used by GitHub Pages on your local machine including Jekyll, Sass, etc.

Commit any changes and push everything to the master branch of your GitHub user repository. GitHub Pages will then rebuild and serve your website.

Moar!

I’ve created a more detailed walkthrough, Build A Blog With Jekyll And GitHub Pages over at the Smashing Magazine website. Check it out if you’d like a more detailed walkthrough and some background on Jekyll. :metal:

It covers:

A more detailed walkthrough of setting up your Jekyll blog

Common issues that you might encounter while using Jekyll

Importing from Wordpress, using your own domain name, and blogging in your favorite editor

Theming in Jekyll, with Liquid templating examples

A quick look at Jekyll 2.0’s new features, including Sass/Coffeescript support and Collections

Contributing

Issues and Pull Requests are greatly appreciated. If you’ve never contributed to an open source project before I’m more than happy to walk you through how to create a pull request.

You can start by opening an issue describing the problem that you’re looking to resolve and we’ll go from there.

I want to keep Jekyll Now as minimal as possible. Every line of code should be one that’s useful to 90% of the people using it. Please bear that in mind when submitting feature requests. If it’s not something that most people will use, it probably won’t get merged. :guardsman: