Escribiendo la primera entrada del blog en el tema Minimal Mistakes

3 minuto(s) de lectura

Ha llegado el momento de que empecemos a generar contenido real para nuestro sitio web, ¿verdad? Comencemos publicando la primera entrada o artículo del blog, bien para presentar la propia página, bien a nosotros mismos o, como resultó en mi caso, para declarar una lista de intenciones relacionadas con Infinitos Contrastes.

En esta ocasión, en lugar de utilizar el comando rake, como hacíamos en aquellos días del tema Hooligan, directamente acudiremos a nuestro editor de texto plano favorito (Sublime Text 3 para mí en la actualidad) y escribiremos aquello que nos interese compartir. A la hora de guardar el archivo, lo haremos siguiendo el formato fecha-título, donde:

  • La fecha seguirá el formato AAAA-MM-DD, es decir, empezaremos tecleando el año usando cuatro dígitos, para a continuación introducir tanto el mes como el día en el que se publicará el artículo, usando dos dígitos y separando cada una de las partes con guiones, -.
  • El título, que recordemos no será necesariamente el que aparezca luego encabezando el documento (pero sí formará parte de la url final del artículo a no ser que mediante el permalink lo configuremos de forma distinta), conviene que lo escribamos separando las palabras también con guiones, -, y sin utilizar caracteres extraños a ojos del alfabeto inglés, por los motivos que comenté en su momento en esta entrada.

Por ejemplo, el archivo asociado a mi primera entrada del blog en esta nueva versión de Infinitos Contrastes lleva por nombre: 2017-07-29-caminando-hacia-una-version-2-0-de-infinitos-contrastes.md.

Una vez tengamos completo el cuerpo del artículo que deseamos publicar, crearemos, dentro del directorio raíz donde hemos almacenado el sitio web en nuestro disco duro, una carpeta denominada _posts. Será en su interior donde ubiquemos tanto el archivo que acabamos de generar como todos aquellos que queramos formen parte del blog de la página web.

El siguiente paso consiste en añadir una cabecera al cuerpo de la entrada, con ciertos metadatos de interés, para que Jekyll la reconozca adecuadamente y organice ciertas características suyas de manera automática. Al igual que hacíamos con el tema Hooligan, encerraremos los elementos de dicha cabecera entre ---, y contendrá, entre otros, elementos asociados al artículo tales como:

  • title: el título.
  • date: la fecha de publicación.
  • excerpt: un breve resumen.
  • categories: la lista de categorías.
  • tags: la lista de etiquetas.

Por ejemplo, la cabecera de mi primera entrada del blog presenta el siguiente aspecto:

---
title: "Caminando hacia una versión 2.0 de *Infinitos Contrastes*"
date: 2017-07-29 06:00:00
excerpt: "En las próximas semanas, y con la esperanza de que no termine convirtiéndose en meses, voy a llevar a cabo una importante reorganización de los contenidos que actualmente están disponibles en *Infinitos Contrastes*. En parte debido a que ahora dispongo de más tiempo libre, pero sobretodo porque algunos aspectos que caracterizan el sitio web, en el momento de escribir estas líneas, no terminan de convencerme."
categories: 
  - Reflexiones
tags: 
  - Blog
  - Infinitos Contrastes
  - Reorganización
---

En futuros artículos de esta serie, veremos que podemos declarar el valor de elementos adicionales en el interior de la cabecera. No obstante, para no abrumar en este momento, estimo que los introducidos componen un conjunto mínimo razonable de atributos con el que personalizar nuestros artículos.

Ahora, volviendo a citar aquella entrada que advertía del extraño comportamiento de Jekyll cuando empleábamos ciertos caracteres, directamente he decidido modificar la estructura del permalink de las entradas, para así evitar futuras “sorpresas”.

Para ello, tenemos que editar el fichero _config.yml, que a estas alturas ya sabemos de memoria que se encuentra en el directorio raíz del sitio web, y desplazarnos hacia el bloque encabezado por # Outputting que, actualmente, presenta el siguiente aspecto:

# Outputting
permalink: /:categories/:title/
paginate: 5 # amount of posts to show
paginate_path: /page:num/
timezone: # http://en.wikipedia.org/wiki/List_of_tz_database_time_zones

Modificaremos la línea asociada a permalink, suprimiendo la parte correspondiente a /:categories/, que presentará problemas si utilizamos categorías como “Estadística” o “Matemáticas”, por ejemplo. En su lugar, podemos optar por incluir la fecha de publicación del artículo, tal y como actúa WordPress. De esta forma, el anterior bloque de código quedaría ahora:

# Outputting
permalink: /:year/:month/:day/:title/
paginate: 5 # amount of posts to show
paginate_path: /page:num/
timezone: # http://en.wikipedia.org/wiki/List_of_tz_database_time_zones

Así pues, el resultado queda:

Aspecto del listado de entradas

Aspecto de la entrada en concreto

Únicamente queda aplicar el combo de git add ... commit ... push para que nuestra entrada pueda consultarla cualquier persona que visite el sitio web.

En el próximo artículo de la serie dedicada al tema Minimal Mistakes estudiaremos cómo generar una sección en la página web dedicada a las entradas que escribamos para el blog, desplazando así el contenido que ahora aparece en la página de inicio a dicha sección.

Nota: esta entrada se ha almacenado dentro del proyecto MetaBlog, quedando así disponible para su consulta también a través del siguiente enlace.

Comentar