Zero to Hosted Jekyll Blog in 3 Minutes

1 - Create a New Repository

Go to your https://github.com and create a new repository named USERNAME.github.com

2 - Install Jekyll-Bootstrap


$ git clone https://github.com/plusjade/jekyll-bootstrap.git USERNAME.github.com
$ cd USERNAME.github.com
$ git remote set-url origin git@github.com:USERNAME/USERNAME.github.com.git
$ git push origin master

3 - Profit

After GitHub has a couple minutes to do its magic your blog will be publicly available at http://USERNAME.github.com

*Already have your blog on GitHub?

I'll assume you have the Jekyll gem installed on your local machine. Run Jekyll-Bootstrap-Core locally to see what all the fuss is about: 


$ git clone https://github.com/plusjade/jekyll-bootstrap.git
$ cd jekyll-bootstrap
$ jekyll --server

See it in action at http://localhost:4000.

Next Steps

Jekyll Quick Start →

The Quickest Way to Blog on GitHub Pages.

Jekyll-Bootstrap is a lean blogging framework
made for developers and designers.

  • Create content in markdown or textile.
  • Manage everything with git.
  • Publish from terminal.
  • No database.
  • No hosting headaches.

New to blogging with Jekyll? Read the introduction.

Install and Switch Blog Themes With One Command.

Jekyll Bootstrap is the first Jekyll blogging engine to support modular theming.
This makes designing and sharing themes for Jekyll blogs much easier and automatic.

Browse Current Themes (new window)

Support For All Major Blog Comment Engines.

Installation is as easy as pasting in your account identifier.

  • Disqus
  • Livefyre
  • Intense Debate
  • Facebook

Built-in Post and Page File Creation.

Easily create post and page file stubs using Jekyll Bootstrap's built in rake tasks.
Plus dynamically generated page stubs for all these goodies:

  • archive.html
  • pages.html
  • tags.html
  • categories.html
  • sitemap.xml
  • atom.xml

Free and Easy Blog Hosting With GitHub Pages.

Jekyll-bootstrap is 100% compatible with deploying to GitHub.
Just push your repository to a valid GitHub Pages endpoint and GitHub hosts your website <3.

Project Status: Maintenance

I don't actively contribute to JB anymore.
Not having control over jekyll development essentially means this is all one big hack, and the more I hack the more I sacrifice simplicity; but I am looking for help!

HELP! Looking for Committers

If you are interested in being a core-contributor to Jekyll-bootstrap
please email me: plusjade@gmail.com
I really need help to manage the issues and pull requests piling up.

My New Project

http://ruhoh.com is the Universal Static Blog Generator.
ruhoh is simpler, faster, and language agnostic.

ruhoh is made for technical blogging and will be developed at lightning speed.
Conversely, GitHub depends on Jekyll to run GitHub Pages and development has plateaued.

Thank You! If you like JB, please give ruhoh a try!

Fork me on GitHub