Referencia rápida para configurar y publicar sitios web estáticos con Jekyll en GitHub Pages.
Estructura de directorios
.
├── _config.yml # Configuración del sitio
├── _includes/ # Fragmentos reutilizables de plantillas
├── _layouts/ # Diseños base de página
├── _posts/ # Publicaciones del blog (YYYY-MM-DD-title.md)
├── _sass/ # Parciales de estilo SASS / SCSS
├── assets/ # Imágenes, estilos compilados, JS
└── index.md # Contenido de la página principal
Configuración (_config.yml)
title: My Documentation
description: Quick reference cheatsheets
baseurl: "/my-repo"
url: "https://username.github.io"
# Dependencias de GitHub Pages
plugins:
- jekyll-feed
- jekyll-seo-tag
- jekyll-sitemap
markdown: kramdown
theme: minima
Cabecera Frontmatter
---
layout: post
title: "Getting Started with Jekyll"
date: 2026-10-25 12:00:00 +0000
categories: [development, tools]
tags: [jekyll, static-site]
---
Ayudantes de plantillas Liquid
Salida y variables
{{ site.title }}
{{ page.title }}
{{ content }}
Condicionales y bucles
{% if page.comments %}
{% include comments.html %}
{% endif %}
<ul>
{% for post in site.posts limit:5 %}
<li><a href="{{ post.url | relative_url }}">{{ post.title }}</a></li>
{% endfor %}
</ul>
Pruebas locales
# Instalar dependencias
bundle install
# Ejecutar servidor local de desarrollo con recarga en vivo
bundle exec jekyll serve --livereload