Instalación de Jekyll en nuestro equipo y configuración del nuestro sitio para subirlo a GitHub.

Crear el repositorio en GitHub siguiendo las instrucciones oficiales:

Recordar que index.md tiene prioridad sobre README.md

Clonar nuestro repositorio

Clonar el repo en VS Code:

Lo primero que haremos será clonar nuestro repositorio. Para ello usaremos VS Code.

Instalación de Jekyll

Una vez configurado nuestro sitio en GitHub, lo que vamos a hacer ahora es utilizar todo el poder de Jekyll para facilitarnos enormemente la tarea de actualizar nuestro sitio y publicar entradas en nuestro blog.

Lo que haremos será instalar Jekyll siguiendo las instrucciones oficiales.

Jekyll es una herramienta creada en Ruby, por lo que cuenta con múltiples extensiones denominadas Gems (Gemas). Éstas deben almacenarse en el directorio /home, por lo que debes seguir puntualmente las instrucciones que se te indican.

Configuración de nuestro tema

Ahora comienza lo bueno: vamos a crear nuestro sitio utilizando tema basado en gemas:

jekyll new . --force

Con esta instrucción estamos creando un nuevo sitio Jekyll con un tema por defecto llamado Minima, el cual es precisamente el tema de este sitio.

Debemos usar el parámetro --force porque nuestro directorio no se encuentra vacío, sino que conttiene el archivo README.md que descargamos de nuestro repositorio.

Ahora lo siguiente es probar como luce nuestro sitio local:

bundle exec jekyll serve --livereload

Con esta instrucción ocurren varias cosas:

  1. Se “compilan” nuestros archivos Markdown a archivos HTML.
  2. Se ejecuta un servidor local (http://127.0.0.1:4000) donde podemos visualizar nuestro sitio.
  3. Incluímos el parámetro --livereload para que se actualice inmediatamente en nuestro sitio HTML cualquier cambio que hagamos en Markdown.

Al hacer Ctrl+clic

Pantallazo del tema Minima

Configurar archivo Gemfile para usar GitHub pages: