¿Cómo crearte un blog personal con Jekyll?

October 21, 2017

Hay muchas posibilidades para la creación de blogs personales, siendo Wordpress o Blogspot de los más utilizados, sin embargo, ¡hay alternativas!.

Una de las que más me gusta es Jekyll, aunque Hugo también es una buena opción. Jekyll es a grandes rasgos un generador de páginas web estáticas, con una serie de ventajas que lo diferencias de otros modos de hacerte un blog:

  • La facilidad de edición de nuevos post mediante lenguaje markdown (en algún editor de escritorio como Atom o Haroopad), o a partir de otros editores web como prose.io.
  • Tiene una rápida y fácil instalación que más abajo se detalla
  • Gran cantidad de temas/plantillas predefinidas
  • La posibilidad de alojarlo en páginas como Github o Gitlab, permitiendo tener un espacio en la web

En el caso de que queramos visualizar el resultado de nuestro blog, podemos montar Jekyll en nuestro ordenador (con linux) o servidor. Por otro lado, si el destino del blog es subirlo a github, no hace falta realizar este paso, tan solo hay que modificar los archivos necesarios y subir tus nuevos posts en formato markdown.

Pre-instalación Jekyll. Requisitos

  • Un SO GNU/Linux o macOS
  • Tener instalado git
$ sudo apt install git
  • La versión de Ruby 2.1 o superior
$ sudo apt install ruby ruby-dev make gcc
  • Las RubyGems. Si no tienes las RubyGems instaladas, puedes hacerlo manualmente descargándolas desde esta página
# Entrar (cd) a la carpeta descargada y descomprimida y ejecutar
$ ruby setup.rb

En el caso de que las tengas, únicamente actualízalas:

# Tienes que ser administrador o root
$ sudo gem update --system  
  • Comprueba que GCC y Make se han instalado
gcc -v
make -v

Instalación de Jekyll

# Instalación de Jekyll
$ sudo apt install jekyll 
$ sudo apt install bundler

# Si tienes problemas con la gema nokogiri
$ sudo apt-get install build-essential patch ruby-dev zlib1g-dev liblzma-dev
$ gem install nokogiri

Fuente

También puedes probar a actualizar las gemas

$ bundle update && bundle install

Descargar repositorios y realizar cambios

A modo de ejemplo voy a simular que descargo el repositorio donde tengo alojado mi blog, el cual es un fork de uno de los muchos temas de Jekyll.

git clone https://github.com/JoanCano/joancano.github.io.git

# Entraría a la carpeta del blog
$ cd joancano.io/
# Ejecutaría el siguiente comando para evitar fallos de gemas en mi repo
$ bundle update github-pages

En este punto es cuando crearíamos el nuevo post dentro de la carpeta _post, donde guardaremos las nuevas publicaciones. Estas deben deben seguir el siguiente formato: YEAR-MONTH-DAY-title.md

La carpeta _site es donde se generarán los nuevos post una vez sean transformados por Jekyll.

Cada post empezará de la siguiente manera, escrito en markdown:

---
layout: post
title:  "Welcome to Jekyll!"
date:   2015-11-17 
categories: jekyll update
---

Visualización del blog

Como se ha descargado el blog desde Github, lo primero será iniciar el repositorio en git.

$ cd joancano.github.io
$ git init

Jekyll también viene con un servidor de desarrollo incorporado que te permitirá previsualizarlo cómo en tu navegador localmente.

$ bundle exec jekyll serve

En caso de que no nos permita visualizarlo, es por los permisos del navegador. Tenemos que activar el puerto 4000.

$ sudo ufw allow 4000

Ya tenemos nuestro blog corriendo en local!. Ahora solo tendremos que subirlo a Github para poder tener nuestro blog en la web.