Configurando jekyll 3.2
23 Aug 2016categorias: 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.
- Jekyll Sitemap: Genera un sitemap con todos nuestros post y páginas.
gems:
- jekyll-sitemap
- Jekyll SEO Tag: añade información SEO a la página.
Añadir en la sección de gems del archivo_config.yml
gems:
- jekyll-seo-tag
Y añadir {% seo %}
en nuestro código.
- Jekyll Archives: Este plugin permite generar distintas paginas agrupando los articulos por tag, categoria, mes o año.
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