Configurando jekyll 3.2

categorias: jekyll

tags: configuracion jekyll

Si vamos a alojar nuestra página creada con Jekyll en github, una primer paso es tener instalada su misma versión de librerias. La versión actual es la 93, que acaba de incluir la version 3.2 de Jekyll.

$ gem install github-pages -v 93

Aprovechando los multiples plugins que dispone jekyll, he dedicido utilizar alguno de los disponibles en Github.

gems:
  - jekyll-sitemap

Añadir en la sección de gems del archivo_config.yml

gems:
  - jekyll-seo-tag

Y añadir {% seo %} en nuestro código.

Por desgracia esta gem no esta soportada por Github, por lo que la tendremos que instalar manualmente y realizar un pequeño “hack” para poder utilizarlo en github. Otra alternativa

$ gem install jekyll-archives

Al igual que en el anterior, añadir en la sección de gems del archivo _config.yml y su configuración.

gems:
  - jekyll-archives

jekyll-archives:
  enabled:
    - categories
    - tags
  layout: 'archive'
  permalinks:
    tag: '/archive/tag/:name/'
    category: '/archive/category/:name/'

En nuestro caso, activamos solamente páginas por tag y categoria, y definimos el formato del link y layout.

La solución “low-cost” por la que he optado, es justo antes de realizar la subida a Github, es copiar las páginas generadas por el plugin en local, como si fuera contenido propio.

$ rm -rf archive | cp _site/archive . 

Con este proceso, ya que tenemos dos fuentes (la carpeta copiada y el plugin archives) que generan en la misma ubicación _sites/archive es necesario borrar la carpeta ./archive antes de arrancar el servidor en local para evitar conflictos