Referencia rápida

Hoja de referencia del generador de sitios estáticos Jekyll

Guía de referencia completa para Jekyll: estructura de directorios, YAML front matter, etiquetas y filtros Liquid, variables, colecciones y GitHub Pages.

· Publicado

Jekyll es un generador de sitios estáticos orientado a blogs escrito en Ruby que impulsa GitHub Pages.

Estructura de directorios

├── _config.yml      # Configuración global del sitio
├── _drafts/         # Borradores sin publicar
├── _includes/       # Fragmentos de plantilla reutilizables
├── _layouts/        # Envoltorios de diseño para páginas y artículos
├── _posts/          # Artículos publicados (YYYY-MM-DD-title.md)
├── _data/           # Archivos estructurados de datos JSON/YAML
├── _site/           # Salida HTML estática generada
└── index.md         # Archivo de entrada de la portada

YAML Front Matter

---
layout: post
title: "Announcing Version 2.0"
date: 2026-11-08 10:00:00 +0800
categories: news tech
tags: [release, ruby]
published: true
---

Sintaxis de plantillas Liquid

Salida y variables

{{ site.title }}
{{ page.title }}
{{ content }}
{{ post.date | date: "%B %d, %Y" }}

Control de flujo e iteración

{% if page.comments %}
  {% include comments.html %}
{% endif %}

{% for post in site.posts limit:5 %}
  <h2><a href="{{ post.url }}">{{ post.title }}</a></h2>
  <p>{{ post.excerpt }}</p>
{% endfor %}

Filtros comunes

Filtro Descripción Ejemplo
date: "%Y-%m-%d" Formatear fecha y hora {{ page.date | date: "%Y" }}
truncate: 100 Truncar cadena con puntos suspensivos {{ post.content | truncate: 100 }}
strip_html Eliminar todo el marcado HTML {{ post.content | strip_html }}
jsonify Serializar datos a texto JSON {{ site.data.authors | jsonify }}
markdownify Convertir Markdown a HTML {{ text | markdownify }}

Referencia de variables globales

  • site.posts: Lista cronológica inversa de todos los artículos.
  • site.pages: Lista de todas las páginas estáticas.
  • site.html_pages: Subconjunto de site.pages que genera HTML.
  • site.data: Datos sin procesar cargados de archivos _data/*.yml.
  • site.time: La marca de tiempo actual de compilación.

Referencias

Temas relacionados