CoderHub Academy Slides

Repositorio de diapositivas HTML estaticas para clases de CoderHub Academy.

El proyecto esta pensado para publicar presentaciones de programacion, inteligencia artificial, desarrollo web y otros cursos sin backend, sin npm y sin proceso de build obligatorio.

Como abrir localmente

Abre index.html directamente en el navegador.

Tambien puedes levantar un servidor estatico desde la raiz del repositorio:

python3 -m http.server 8000

Luego visita http://localhost:8000/.

Estructura

/
├── index.html
├── README.md
├── assets/
│   ├── css/
│   │   └── shared.css
│   ├── js/
│   │   └── shared.js
│   ├── logos/
│   │   ├── .gitkeep
│   │   └── coderhub-logo.png
│   └── images/
│       └── .gitkeep
├── templates/
│   └── slide-template.html
└── courses/
    └── software-developer-n1/
        └── clase-01-ia-generativa/
            ├── presentacion.html
            ├── ia-clase-1.html
            ├── white-logo-0.5.png
            ├── assets/
            │   └── images/
            │       ├── .gitkeep
            │       └── ia-evolucion-timeline.png

Como agregar una nueva clase

1. Crea una carpeta en courses/<curso>/<clase>/.
2. Usa nombres en minusculas y con guiones. Ejemplo: clase-02-prompting-basico.
3. Copia templates/slide-template.html como index.html dentro de la nueva carpeta.
4. Ajusta el titulo, el nombre del curso, los chips y el contenido de las slides.
5. Verifica que la ruta al CSS compartido sea correcta. Desde courses/<curso>/<clase>/ debe ser:

<link rel="stylesheet" href="../../../assets/css/shared.css">

6. Guarda las imagenes especificas de esa clase en courses/<curso>/<clase>/assets/images/.
7. Agrega el enlace de la nueva clase o presentacion en el index.html principal.

Convenciones de nombres

• Carpetas en minusculas.
• Usar guiones en lugar de espacios.
• Evitar acentos y caracteres especiales en rutas.
• Ejemplo recomendado: clase-02-prompting-basico.

Imagenes y recursos

• Usa rutas relativas para que todo funcione en GitHub Pages.
• Guarda imagenes globales en assets/images/.
• Guarda imagenes de cada clase en assets/images/ dentro de la carpeta de esa clase.
• Optimiza imagenes antes de subirlas al repositorio.
• Copia las presentaciones reales directamente en la carpeta de la clase cuando ya existan como HTML final.

Publicar con GitHub Pages

1. Sube el repositorio a GitHub.
2. Entra a Settings > Pages.
3. En Build and deployment, selecciona Deploy from a branch.
4. Selecciona la rama main y la carpeta /root.
5. Guarda la configuracion.

El sitio quedara disponible en una URL similar a:

https://usuario.github.io/nombre-repositorio/

Las rutas internas usan enlaces relativos para funcionar correctamente bajo ese subpath.