13 January 2014

TL;DR

All instructions are based on Mac OS X Mavericks (10.9.1) and assumes you already have Ruby installed. See further reading for more details.

  • Install Jekyll: gem install jekyll

  • Setup Jekyll-Bootstrap

  • From scratch:

    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
    
  • From existing Github repo:

    git clone https://github.com/myaccount/jekyll-bootstrap.git
    cd jekyll-bootstrap
    jekyll serve --watch
    
  • Test your pages before pushing any changes to Github.

  cd /mypath/jekyll-bootstrap
  jekyll serve --watch

Background

This blog is based on Github Pages, which is a Jekyll-Bootstrap generated site. All posts and pages are written in markdown and then compiled to static web pages by jekyll.

Further Reading

Jekyll and Github Pages

https://help.github.com/articles/using-jekyll-with-pages

http://jekyllbootstrap.com

http://andytaylor.me/2012/11/03/installing-ruby-and-jekyll

Markdown reference

http://daringfireball.net/projects/markdown/



blog comments powered by Disqus