Configuración del entorno de desarrollo

Este proyecto es un sitio estático generado con Jekyll y Sass. Para trabajar localmente es necesario tener un entorno Ruby con las gemas adecuadas, o usar el contenedor Docker descrito a continuación.

Requisitos previos (modo nativo)

1. Ruby 2.7+ (se recomienda 3.x) instalado en el sistema. En Windows puede instalarse con RubyInstaller.
2. Bundler: ejecutar gem install bundler.
3. Node.js (opcional) si se usan herramientas npm; no es obligatorio en la configuración actual.

Inicialización

# desde la raíz del repositorio
bundle install        # instala las gemas listadas en Gemfile
# Si el Gemfile.lock no existe se creará.

Si deseas bloquear versiones usa bundle lock.

Servir el sitio

bundle exec jekyll serve --watch --force_polling --drafts

Abre http://localhost:4000 en tu navegador. Cualquier cambio en los ficheros .scss, .html, o .md se recompilará automáticamente.

Alternativa con Docker (recomendado para Windows)

El contenedor contiene Ruby, Bundler y todas las dependencias necesarias. No necesitas instalar nada aparte salvo Docker Desktop.

1. Construye la imagen:

   docker build -t moon-blog .
   

2. Inicia el servicio:

   docker-compose up
   

   Esto montará el directorio actual dentro del contenedor, de modo que los cambios se reflejarán al instante.

Abre el navegador en http://localhost:4000.

Para detener el servicio, usa docker-compose down.

Scripts útiles

Puedes ejecutar tareas con:

# compilar el CSS sin servidor jekyll
bundle exec jekyll build
# limpiar la carpeta _site
bundle exec jekyll clean

Tips

• Si actualizas la versión de Jekyll u otras gemas, borra Gemfile.lock y ejecuta bundle install de nuevo.
• Para depurar el CSS no es necesario instalar Sass por separado; Jekyll utiliza la gema sassc.
• Añade plugins al Gemfile y _config.yml según tus necesidades, por ejemplo jekyll-paginate.

¡Listo! Con esto tendrás tu entorno preparado para desarrollar el blog y probar los cambios de diseño desde la rama feature/tematizacion.