Jekyll trabaja tanto con archivos transformables (renderizable files) como estáticos o no transformables. Hasta el momento, hemos presentado los transformables. Ha llegado el momento de presentar los estáticos.

Al finalizar, sabrá:

  • Cómo añadir a un sitio Jekyll archivos estáticos.

Introducción

Un archivo de contenido estático (static file) es aquel que no es transformado por Jekyll, lo añade al sitio web sin procesamiento extra como ocurre con otros tipos de archivos como, por ejemplo, las páginas. Estos archivos son aquellos que no presentan encabezamiento (front matter) explícito y pueden ser tanto archivos Markdown como HTML e incluso PDFs o imágenes. Así pues, de cara a Jekyll, todo archivo que defina un encabezamiento explícitamente debe ser transformado. En cambio, aquellos que no presenten un encabezamiento explícito, se copiarán tal cual al sitio web final.

Aunque hemos presentando ya el concepto de encabezamiento, tenga en cuenta que puede estar vacío. Lo siguiente es posible, indicándole a Jekyll que debe procesarlo, pero no deseamos definir propiedades explícitamente:

---
---

Aquí el contenido.

Encabezamientos implícitos de los archivos estáticos

Aunque un archivo de contenido estático no tiene encabezamiento explícito, sí lo tiene realmente. Simplemente, tenga en cuenta que el encabezamiento definido explícitamente en el archivo le dice a Jekyll que lo trasnforme. En ocasiones, se necesita añadir un encabezamiento implícito. Esto lo haremos mediante la propiedad defaults del archivo de configuración _config.yaml. Así, por ejemplo, si deseamos añadir al encabezamiento implícito de un determinado directorio que su contenido está formado por imágenes, podríamos hacerlo como sigue:

defaults:
  - scope:
      path: /ruta/donde/ubicamos/imágenes
    vaues:
      image: true # propiedad a añadir al encabezamiento

Podemos definir propiedades tanto predefinidas como personalizadas mediante este mecanismo.

Propiedad site.static_files

De la misma manera que tenemos las propiedades site.pages y site.posts con objetos de tipo página y artículo, respectivamente, la variable global site también proporciona una propiedad static_files, de tipo lista, que contiene todos los archivos de contenido estático. Cada elemento de esta lista contiene las siguientes propiedades y cualquier otra definida mediante defaults:

Propiedad Tipo de datos Descripción
name Texto Nombre del archivo con la extensión.
basename Texto Nombre del archivo sin la extensión.
extname Texto Extensión del archivo como, por ejemplo, .png.
path Texto Ruta al archivo.
modified_time Fecha Fecha de la última modificación del archivo.

Directorio assets

Por convenio y buenas prácticas, las imágenes y las hojas de estilo deben ubicarse en el directorio assets (assets directory) del directorio del sitio. Los archivos aquí definidos se trasladarán a su homólogo en el destino.