Jekyll: Instalar, configurar y desplegar en GitHub Pages

Esta es una actualización a Junio 2018 con la version 3.8.3 de Jekyll.

Esta es una guia básica de como instalar Jekyll y desplegar un blog en GitHub Pages.

Instalación

Esta instalacion es sobre OSX asi que toda instalacion sera via Homebrew.

1. Para mepezar hay que instalar GEM Ruby

    $ brew install ruby
   

2. Instalamos Jekyll

    $ gem install bundler jekyll
   

3. El siguiente paso creara un proyecto básico con un post de ejemplo.

    $ jekyll new my-awesome-site
   

4. Ejecutamos el servidor local http://127.0.0.1:4000/

    $ cd my-awesome-site
    $ bundle exec jekyll serve
   

Agregar el proyecto en GitHub Pages

Para esta configuracion es necesario tener una cuenta en GitHub

Creamos el repositorio con el mismo nombre que nuesta cuenta. Por ejemplo si nuestra cuenta se llama username creamos una cuenta como username.github.io

Dentro de nuestro blog inicializamos el repositorio.

$ git init
$ git add .
$ git commit -m "Initial commit blog"
$ git remote add https://github.com/username/username.github.io.git
$ git push -u origin master

Y con eso podemos acceder a nuestra blog con la url https://username.github.io

Con esto ultimo podemos ver nuestro proyecto en http://127.0.0.1:4000/