Construcción del sitio (Hub técnico y docente)

¿Qué es este proyecto?

Un hub técnico y docente.

• Centraliza docencia + desarrollo en un único sitio.
• Conecta Blog (teoría), Projects (práctica) y Repositorios (código).
• Publicación directa con Markdown, sin builds complejos ni dependencias pesadas.

Objetivos

Claridad, mantenibilidad y enlaces estables.

• Mantener una estructura simple y escalable.
• Tener un diseño coherente (botones/cards) y buena lectura en posts.
• Facilitar navegación rápida para estudiantes y desarrolladores.

Decisiones de diseño (lo importante)

Importante: el sitio prioriza la lectura y la claridad por encima de “efectos”. Un hub técnico debe ser rápido, entendible y mantenible.

• Jekyll + GitHub Pages: hosting sencillo, gratuito y muy fácil de mantener.
• Markdown-first: el contenido manda; el layout acompaña.
• CSS modular:
  • site.css: layout, hero, nav, botones, estilos generales y pulido Markdown.
  • cards.css: sistema de cards (cardx), grids y componentes (chips/stack).
• Componentes reutilizables:
  • Cards para explicar estructura (Blog / Projects / Repos).
  • Listados (blog/projects) con look “card” para escanear rápido.

Estructura del repo (resumen práctico)

• _posts/ → entradas del blog (formato YYYY-MM-DD-titulo.md)
• projects/ → índice y páginas “manuales” (ej. projects/index.md)
• _projects/ → colección de Projects (auto-listado con site.projects)
• assets/css/ → estilos (site.css, cards.css)
• _includes/ → navegación (nav.html)
• _layouts/ → default.html (cabecera + contenido + footer)

Cómo crear un nuevo proyecto (plantilla rápida)

1. Crear un archivo en _projects/ con front-matter:

---
layout: project
title: "Construcción de un proyecto docente"
date: 2025-12-28
nivel: "Intermedio"
promocion: "Destacado"
stack: [Jekyll, Docker, ...]
---

1. Escribir contenido en Markdown: problema → solución → cómo ejecutar → demo → repositorio.

2. Se lista automáticamente en /projects/ (si tu projects/index.md recorre site.projects).

Desarrollo local (opcional pero recomendado)

bundle exec jekyll serve

Abrir:

• http://localhost:4000/
• http://localhost:4000/blog/
• http://localhost:4000/projects/

Mejoras futuras (ideas con impacto)

• Proyectos destacados en home (featured: true) y mostrar 3.
• Buscador simple (cliente) para blog/projects.
• Añadir plantilla estándar de proyecto: problema → arquitectura → endpoints → cómo ejecutar → learnings.
• Generar automáticamente un bloque de “últimos cambios” (últimos posts + últimos proyectos).