Entrada

Cómo configurar el tema Jekyll Chirpy para tu blog

Cómo configurar el tema Jekyll Chirpy para tu blog

Chirpy es un tema elegante y rico en funciones para Jekyll, ideal para blogs personales y páginas alojadas en GitHub Pages. En esta guía, te mostraré cómo configurarlo desde cero.

Requisitos previos

Antes de empezar, asegúrate de tener:

  • Git
  • Ruby (preferiblemente ≥ 2.7)
  • Bundler (gem install bundler)
  • Jekyll (gem install jekyll)
  • Node.js y Yarn (necesarios para activos como JS/CSS)

Configuración Local

Paso 1: Clonar Chirpy y ejecutar init.sh

  1. Clona el repositorio oficial de Chirpy:
1
2
git clone https://github.com/cotes2020/jekyll-theme-chirpy.git my_blog
cd my_blog
  1. Ejecuta el script init.sh (esto limpia cosas del tema demo y te da un punto limpio):
1
bash tools/init.sh

run script init

Este script:

  • Elimina el historial de git del tema original
  • Cambia algunas configuraciones básicas
  • Inicializa tu propio repositorio

Asegúrate de darle permisos de ejecución si no lo tiene: chmod +x tools/init.sh


Paso 2: Instalar dependencias

Después de ejecutar init.sh, instala las dependencias:

1
bundle install

Bundle install


Paso 3: Servir localmente

Ya con todo listo, puedes correr el servidor local de Jekyll:

1
bash tools/run.sh

Abre en tu navegador: http://localhost:4000

Bundle install


Configuraciones Extras

Configura _config.yml

Revisa y edita _config.yml según tus necesidades. Algunos cambios útiles:

1
2
3
4
title: Tu Blog
description: Tu descripción
url: "https://tu-usuario.github.io"
baseurl: "" # si lo estás sirviendo desde la raíz

Y en site.*, ajusta tus datos personales, redes sociales, etc.


Despliegue en GitHub Pages

  1. Crea un nuevo repositorio en GitHub
1
2
3
4
5
git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/tu-usuario/tu-repo.git
git push -u origin main
  1. Asegúrate de tener un flujo de despliegue. Chirpy ya incluye uno en .github/workflows/pages-deploy.yml. GitHub Actions se encargará de desplegar automáticamente.

En la configuración del repositorio en GitHub, activa GitHub Pages en la rama main (o en la rama gh-pages si decides usar despliegue automático).

Recomendaciones

Puedes cambiar colores, fuentes y otras configuraciones en _sass/addon/variables.scss y _data/.

Esta entrada está licenciada bajo CC BY 4.0 por el autor.