create-openclass-uniminuto 1.4.0

package/template/.github/workflows/deploy.yml

@@ -0,0 +1,64 @@
+name: Deploy Open Class to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: Build Open Class
+    runs-on: ubuntu-latest
+
+    env:
+      SITE_BASE: /${{ github.event.repository.name }}/
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Configure GitHub Pages
+        uses: actions/configure-pages@v5
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Install Chromium for Slidev export
+        run: npx playwright install chromium --with-deps
+
+      - name: Generate and build Open Class
+        run: npm run pages:build
+
+      - name: Upload GitHub Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: dist
+
+  deploy:
+    name: Deploy GitHub Pages
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

package/template/README.md

@@ -0,0 +1,326 @@
+# Open Class UNIMINUTO · Slidev
+
+Proyecto generado con `create-openclass-uniminuto` o creado desde la plantilla `openclass-uniminuto-template`.
+
+Este curso está diseñado para organizar una Open Class de **8 semanas**, con generación progresiva de cada semana, portal principal, lanzadores individuales, exportación de PDF/PPTX y publicación automática en **GitHub Pages**.
+
+---
+
+
+## Crear el curso dentro de un repositorio ya creado en GitHub
+
+Si primero creaste el repositorio en GitHub, clónalo y aplica la plantilla desde npm dentro de la carpeta del repositorio:
+
+```bash
+git clone https://github.com/herrerawilliamh/openclass-iot.git
+cd openclass-iot
+npm create openclass-uniminuto@latest . -- --iot
+npm install
+npm run semana -- 1
+npm run dev
+```
+
+Si el repositorio ya tenía archivos iniciales y deseas reemplazarlos por los de la plantilla:
+
+```bash
+npm create openclass-uniminuto@latest . -- --iot --force
+```
+
+La sincronización con GitHub se hace después con Git:
+
+```bash
+git add -A
+git commit -m "Configura Open Class"
+git push
+```
+
+
+## 1. Primer uso
+
+Instala dependencias:
+
+```bash
+npm install
+```
+
+Configura el curso desde consola:
+
+```bash
+npm run nuevo
+```
+
+Genera la primera semana:
+
+```bash
+npm run semana -- 1
+```
+
+Ejecuta el portal principal:
+
+```bash
+npm run dev
+```
+
+Una semana específica se abre con:
+
+```bash
+npm run dev:s1
+npm run dev:s2
+npm run dev:s3
+```
+
+---
+
+## 2. Tres formas de crear este curso
+
+### Opción A · Desde npm
+
+```bash
+npm create openclass-uniminuto@latest openclass-iot -- --iot
+cd openclass-iot
+npm install
+npm run semana -- 1
+npm run dev
+```
+
+### Opción B · Desde GitHub Template
+
+1. Entra al repositorio `openclass-uniminuto-template`.
+2. Clic en **Use this template**.
+3. Crea un repositorio nuevo, por ejemplo `openclass-iot`.
+4. Clónalo.
+5. Ejecuta los comandos del curso.
+
+```bash
+git clone https://github.com/herrerawilliamh/openclass-iot.git
+cd openclass-iot
+npm install
+npm run nuevo
+npm run semana -- 1
+npm run dev
+```
+
+### Opción C · Repo creado en GitHub y curso generado en local
+
+Esta opción combina GitHub y npm.
+
+#### Si el repositorio fue creado desde plantilla
+
+```bash
+git clone https://github.com/herrerawilliamh/openclass-iot.git
+cd openclass-iot
+npm install
+npm run nuevo
+npm run semana -- 1
+npm run dev
+```
+
+Luego:
+
+```bash
+git add -A
+git commit -m "Generar semana 1"
+git push
+```
+
+#### Si el repositorio está vacío
+
+```bash
+npm create openclass-uniminuto@latest openclass-iot -- --iot
+cd openclass-iot
+npm install
+npm run semana -- 1
+npm run dev
+```
+
+Después conecta el remoto:
+
+```bash
+git init
+git branch -M main
+git add -A
+git commit -m "Publicación inicial Open Class"
+git remote add origin https://github.com/herrerawilliamh/openclass-iot.git
+git push -u origin main
+```
+
+---
+
+## 3. Generar semanas una a una
+
+El curso siempre se organiza en **8 semanas**. Puedes generarlas progresivamente.
+
+```bash
+npm run semana -- 1
+npm run semana -- 2 --title "Título de la semana 2" --date "Junio 15 de 2026"
+npm run semana -- 3 --title "Título de la semana 3" --theme "Tema central"
+```
+
+El comando `semana` actualiza automáticamente:
+
+```text
+openclass.config.json
+slides.md
+scripts/decks.mjs
+package.json
+curso_semanaN.md
+semanas/curso_semanaN.md
+```
+
+El contenido ya editado dentro de `semanas/*.md` se conserva. Solo se sobrescribe si usas:
+
+```bash
+npm run semana -- 4 --force-content
+```
+
+Para activar únicamente una semana:
+
+```bash
+npm run semana -- 4 --only
+```
+
+---
+
+## 4. Editar contenido académico
+
+El contenido real de cada presentación está en:
+
+```text
+semanas/
+```
+
+Ejemplo:
+
+```text
+semanas/iot_semana1.md
+semanas/iot_semana2.md
+semanas/iot_semana3.md
+```
+
+Los archivos de la raíz como `iot_semana1.md` funcionan como lanzadores. Normalmente no debes editarlos manualmente.
+
+---
+
+## 5. Recursos del curso
+
+Usa estas carpetas:
+
+```text
+public/imagenes/    imágenes del curso
+public/videos/      videos y recursos audiovisuales
+public/descargas/   PDF, PPTX u otros descargables
+public/fondos/      fondos institucionales
+```
+
+---
+
+## 6. Construcción local
+
+Construir el portal y las semanas activas:
+
+```bash
+npm run pages:build
+```
+
+Previsualizar la versión estática:
+
+```bash
+npm run pages:preview
+```
+
+Revisar configuración para GitHub Pages:
+
+```bash
+npm run pages:check
+```
+
+---
+
+## 7. Publicar en GitHub Pages
+
+Este proyecto ya incluye:
+
+```text
+.github/workflows/deploy.yml
+```
+
+El workflow construye el sitio y publica la carpeta `dist` en GitHub Pages.
+
+En GitHub configura:
+
+```text
+Settings → Pages → Build and deployment → Source → GitHub Actions
+```
+
+Luego sube cambios:
+
+```bash
+git add -A
+git commit -m "Actualizar Open Class"
+git push
+```
+
+Cada `push` a `main` construirá y publicará el sitio automáticamente.
+
+La URL esperada será:
+
+```text
+https://herrerawilliamh.github.io/NOMBRE-DEL-REPOSITORIO/
+```
+
+Ejemplo:
+
+```text
+https://herrerawilliamh.github.io/openclass-iot/
+```
+
+---
+
+## 8. Flujo semanal sugerido
+
+Semana 1:
+
+```bash
+npm run semana -- 1 --title "Introducción al curso"
+git add -A
+git commit -m "Agregar semana 1"
+git push
+```
+
+Semana 2:
+
+```bash
+npm run semana -- 2 --title "Tema de la semana 2"
+git add -A
+git commit -m "Agregar semana 2"
+git push
+```
+
+Repite el proceso hasta la semana 8.
+
+---
+
+## 9. Comandos útiles
+
+| Comando | Uso |
+|---|---|
+| `npm run nuevo` | Configura un curso desde consola |
+| `npm run semana -- 1` | Genera o activa la semana 1 |
+| `npm run dev` | Abre el portal principal |
+| `npm run dev:s1` | Abre la semana 1 |
+| `npm run pages:check` | Revisa configuración para GitHub Pages |
+| `npm run pages:build` | Construye el sitio estático y exporta descargas |
+| `npm run pages:preview` | Previsualiza la versión publicada |
+| `npm run publicar` | Ejecuta exportaciones y construcción local |
+
+---
+
+## 10. Archivos clave
+
+```text
+openclass.config.json       configuración general del curso
+slides.md                   portal principal
+semanas/                    contenido académico real
+scripts/decks.mjs           listado de presentaciones activas
+.github/workflows/deploy.yml despliegue automático en GitHub Pages
+```

package/template/config/openclass.config.iot-desde-openclass-iot.json

@@ -0,0 +1,77 @@
+{
+  "course": {
+    "shortName": "iot",
+    "fullName": "Internet de las cosas",
+    "year": "2026",
+    "description": "El curso Internet de las cosas introduce al estudiante en el diseño, comprensión y aplicación de sistemas conectados capaces de capturar datos del entorno físico, procesarlos y generar decisiones útiles. A lo largo del curso se estudian sensores, actuadores, microcontroladores, conectividad, procesamiento en la nube, edge computing, seguridad, interoperabilidad, eficiencia energética y aplicaciones en contextos industriales, empresariales, educativos, agrícolas, domésticos y urbanos.",
+    "openClassLabel": "Open Class"
+  },
+  "generation": {
+    "weeksTotal": 8,
+    "activeWeeks": [1, 2, 3, 4, 5, 6],
+    "exportPortal": true,
+    "overwriteLaunchers": true,
+    "overwritePortal": true,
+    "overwriteDecks": true,
+    "overwritePackageScripts": true,
+    "overwriteWeekContent": false
+  },
+  "weeks": [
+    {
+      "number": 1,
+      "title": "Generalidades de IoT",
+      "date": "Mayo 04 de 2026",
+      "centralTheme": "Introducción al Internet de las cosas, componentes, ecosistema conectado y recorrido del dato desde el mundo físico hasta una decisión digital.",
+      "activity": "Actividad de reconocimiento conceptual y práctica guiada con ESP32 y MicroPython en Wokwi."
+    },
+    {
+      "number": 2,
+      "title": "Estructuras Tecnológicas que soportan IoT",
+      "date": "Mayo 11 de 2026",
+      "centralTheme": "Arquitectura IoT, sensores, actuadores, conectividad, edge, fog, cloud, estándares, seguridad y resiliencia.",
+      "activity": "Mapa rápido de una solución IoT y análisis de sus componentes principales."
+    },
+    {
+      "number": 3,
+      "title": "Seguridad y riesgos para sistemas IoT",
+      "date": "Mayo 18 de 2026",
+      "centralTheme": "Riesgos, vulnerabilidades, controles, monitoreo, privacidad y buenas prácticas para dispositivos y plataformas IoT.",
+      "activity": "Simulación de alertas, clasificación de riesgos y propuesta de controles básicos."
+    },
+    {
+      "number": 4,
+      "title": "Programación de sistemas IoT",
+      "date": "Mayo 25 de 2026",
+      "centralTheme": "Desarrollo y programación de soluciones IoT mediante microcontroladores, lenguajes, protocolos, servicios y prácticas de seguridad.",
+      "activity": "Diseño breve de una idea IoT y práctica guiada con ESP32, sensor, lógica de decisión y simulación."
+    },
+    {
+      "number": 5,
+      "title": "Diseño de Hardware para IoT",
+      "date": "Junio 01 de 2026",
+      "centralTheme": "Selección de sensores, microcontroladores, comunicación, energía, protección física, mantenimiento y restricciones reales del hardware IoT.",
+      "activity": "Análisis de decisiones de hardware para un dispositivo IoT de monitoreo ambiental."
+    },
+    {
+      "number": 6,
+      "title": "Internet industrial de las cosas",
+      "date": "Junio 08 de 2026",
+      "centralTheme": "Aplicación del IoT en entornos industriales mediante sensores, máquinas, sistemas de control, analítica, productividad, eficiencia y sostenibilidad.",
+      "activity": "Diagnóstico rápido de datos industriales críticos y relación con decisiones operativas."
+    },
+    {
+      "number": 7,
+      "title": "Inteligencia artificial y aprendizaje automático",
+      "date": "2026",
+      "centralTheme": "Uso de analítica, inteligencia artificial y aprendizaje automático sobre datos provenientes de sistemas IoT.",
+      "activity": "Actividad de análisis de datos IoT y posibles decisiones predictivas."
+    },
+    {
+      "number": 8,
+      "title": "Impactos del entorno en IoT",
+      "date": "2026",
+      "centralTheme": "Impactos técnicos, sociales, éticos, ambientales, económicos y organizacionales del Internet de las cosas.",
+      "activity": "Reflexión aplicada sobre beneficios, riesgos y criterios de implementación responsable."
+    }
+  ]
+}

package/template/config/openclass.config.iot-ejemplo.json

@@ -0,0 +1,81 @@
+{
+  "course": {
+    "shortName": "iot",
+    "fullName": "Internet de las cosas",
+    "year": "2026",
+    "description": "El curso Internet de las cosas introduce al estudiante en el diseño, comprensión y aplicación de sistemas conectados capaces de capturar datos del entorno físico, procesarlos y generar decisiones útiles.",
+    "openClassLabel": "Open Class"
+  },
+  "generation": {
+    "weeksTotal": 8,
+    "activeWeeks": [
+      1,
+      2,
+      3
+    ],
+    "exportPortal": false,
+    "overwriteLaunchers": true,
+    "overwritePortal": true,
+    "overwriteDecks": true,
+    "overwritePackageScripts": true,
+    "overwriteWeekContent": false
+  },
+  "weeks": [
+    {
+      "number": 1,
+      "title": "Generalidades de IoT",
+      "date": "Mayo 04 de 2026",
+      "centralTheme": "Introducción al Internet de las cosas, componentes y aplicaciones",
+      "activity": "Actividad de reconocimiento conceptual"
+    },
+    {
+      "number": 2,
+      "title": "Estructuras Tecnológicas que soportan IoT",
+      "date": "Mayo 11 de 2026",
+      "centralTheme": "Arquitectura, sensores, conectividad, edge, fog y cloud",
+      "activity": "Actividad práctica con simulación IoT"
+    },
+    {
+      "number": 3,
+      "title": "Seguridad en IoT",
+      "date": "Mayo 18 de 2026",
+      "centralTheme": "Riesgos, vulnerabilidades, controles, monitoreo y buenas prácticas de seguridad",
+      "activity": "Simulación de alertas y clasificación de riesgos"
+    },
+    {
+      "number": 4,
+      "title": "Título semana 4",
+      "date": "2026",
+      "centralTheme": "Tema central de la semana",
+      "activity": "Actividad relacionada"
+    },
+    {
+      "number": 5,
+      "title": "Título semana 5",
+      "date": "2026",
+      "centralTheme": "Tema central de la semana",
+      "activity": "Actividad relacionada"
+    },
+    {
+      "number": 6,
+      "title": "Título semana 6",
+      "date": "2026",
+      "centralTheme": "Tema central de la semana",
+      "activity": "Actividad relacionada"
+    },
+    {
+      "number": 7,
+      "title": "Título semana 7",
+      "date": "2026",
+      "centralTheme": "Tema central de la semana",
+      "activity": "Actividad relacionada"
+    },
+    {
+      "number": 8,
+      "title": "Título semana 8",
+      "date": "2026",
+      "centralTheme": "Tema central de la semana",
+      "activity": "Actividad relacionada"
+    }
+  ]
+}

package/template/demo_semana1.md

@@ -0,0 +1,11 @@
+---
+theme: ./theme/uniminuto
+title: Curso Open Class de ejemplo — Semana 1 — Semana de ejemplo
+favicon: /favicon.png
+codeCopy: true
+transition: fade
+routerMode: hash
+drawings:
+  persist: false
+src: ./semanas/demo_semana1.md
+---

package/template/demo_semana2.md

@@ -0,0 +1,11 @@
+---
+theme: ./theme/uniminuto
+title: Curso Open Class de ejemplo — Semana 2 — Título semana 2
+favicon: /favicon.png
+codeCopy: true
+transition: fade
+routerMode: hash
+drawings:
+  persist: false
+src: ./semanas/demo_semana2.md
+---

package/template/demo_semana3.md

@@ -0,0 +1,11 @@
+---
+theme: ./theme/uniminuto
+title: Curso Open Class de ejemplo — Semana 3 — Título semana 3
+favicon: /favicon.png
+codeCopy: true
+transition: fade
+routerMode: hash
+drawings:
+  persist: false
+src: ./semanas/demo_semana3.md
+---

package/template/demo_semana4.md

@@ -0,0 +1,11 @@
+---
+theme: ./theme/uniminuto
+title: Curso Open Class de ejemplo — Semana 4 — Título semana 4
+favicon: /favicon.png
+codeCopy: true
+transition: fade
+routerMode: hash
+drawings:
+  persist: false
+src: ./semanas/demo_semana4.md
+---

package/template/demo_semana5.md

@@ -0,0 +1,11 @@
+---
+theme: ./theme/uniminuto
+title: Curso Open Class de ejemplo — Semana 5 — Título semana 5
+favicon: /favicon.png
+codeCopy: true
+transition: fade
+routerMode: hash
+drawings:
+  persist: false
+src: ./semanas/demo_semana5.md
+---

package/template/demo_semana6.md

@@ -0,0 +1,11 @@
+---
+theme: ./theme/uniminuto
+title: Curso Open Class de ejemplo — Semana 6 — Título semana 6
+favicon: /favicon.png
+codeCopy: true
+transition: fade
+routerMode: hash
+drawings:
+  persist: false
+src: ./semanas/demo_semana6.md
+---

package/template/demo_semana7.md

@@ -0,0 +1,11 @@
+---
+theme: ./theme/uniminuto
+title: Curso Open Class de ejemplo — Semana 7 — Título semana 7
+favicon: /favicon.png
+codeCopy: true
+transition: fade
+routerMode: hash
+drawings:
+  persist: false
+src: ./semanas/demo_semana7.md
+---

package/template/demo_semana8.md

@@ -0,0 +1,11 @@
+---
+theme: ./theme/uniminuto
+title: Curso Open Class de ejemplo — Semana 8 — Título semana 8
+favicon: /favicon.png
+codeCopy: true
+transition: fade
+routerMode: hash
+drawings:
+  persist: false
+src: ./semanas/demo_semana8.md
+---

package/template/ejemplos/iot-semanas-1-a-3/raiz/iot_semana1.md

@@ -0,0 +1,12 @@
+---
+theme: ./theme/uniminuto
+title: Internet de las cosas — Semana 1
+favicon: /favicon.png
+codeCopy: true
+transition: fade
+routerMode: hash
+drawings:
+  persist: false
+src: ./semanas/iot_semana1.md
+---
+

package/template/ejemplos/iot-semanas-1-a-3/raiz/iot_semana2.md

@@ -0,0 +1,12 @@
+---
+theme: ./theme/uniminuto
+title: Internet de las cosas — Semana 2
+favicon: /favicon.png
+codeCopy: true
+transition: fade
+routerMode: hash
+drawings:
+  persist: false
+src: ./semanas/iot_semana2.md
+---
+

package/template/ejemplos/iot-semanas-1-a-3/raiz/iot_semana3.md

@@ -0,0 +1,12 @@
+---
+theme: ./theme/uniminuto
+title: Internet de las cosas — Semana 3
+favicon: /favicon.png
+codeCopy: true
+transition: fade
+routerMode: hash
+drawings:
+  persist: false
+src: ./semanas/iot_semana3.md
+---
+

package/template/ejemplos/iot-semanas-1-a-3/raiz/iot_semana4.md

@@ -0,0 +1,12 @@
+---
+theme: ./theme/uniminuto
+title: Internet de las cosas — Semana 4
+favicon: /favicon.png
+codeCopy: true
+transition: fade
+routerMode: hash
+drawings:
+  persist: false
+src: ./semanas/iot_semana4.md
+---
+