What is jekyll ?

Jekyll is a simple, blog-aware, static site generator perfect for personal, project, or organization sites. Think of it like a file-based CMS, without all the complexity. Jekyll takes your content, renders Markdown and Liquid templates, and spits out a complete, static website ready to be served by Apache, Nginx or another web server. Jekyll is the engine behind GitHub Pages which you can use to host sites right from your GitHub repositories.

Quick start

$ gem install jekyll
$ jekyll new my-awesome-site
$ cd my-awesome-site
$ jekyll serve
# => Now browse to http://localhost:4000 

Deploy to Github pages

  1. Create a repository and name repository with format username.github.io
  2. Clone the repository

    $ git clone https://github.com/username/username.github.io 

  3. Create site

    $ jekyll new site

  4. Move all in site

    $ mv site/* username.github.io 

  5. Enter the project folder

    $ cd username.github.io

  6. Push it :

    $ git add --all
    $ git commit -m "fush"
    $ git push -u origin master

  7. You're done, go to http://username.github.io

Check out the Jekyll docs for more info on how to get the most out of Jekyll. File all bugs/feature requests at Jekyll’s GitHub repo. If you have questions, you can ask them on Jekyll’s dedicated Help repository.