create-openclass-uniminuto 1.6.1 → 1.6.4

package/template/package.json

@@ -1,63 +1,63 @@
-{
-  "name": "openclass-demo",
-  "version": "1.6.0",
-  "description": "Presentaciones Open Class del curso Curso Open Class de ejemplo.",
-  "type": "module",
-  "private": true,
-  "scripts": {
-    "dev": "slidev slides.md --open --port 3000",
-    "config": "node scripts/generar-desde-config.mjs",
-    "dev:s1": "slidev demo_semana1.md --open --port 3001",
-    "dev:s2": "slidev demo_semana2.md --open --port 3002",
-    "dev:s3": "slidev demo_semana3.md --open --port 3003",
-    "dev:s4": "slidev demo_semana4.md --open --port 3004",
-    "dev:s5": "slidev demo_semana5.md --open --port 3005",
-    "dev:s6": "slidev demo_semana6.md --open --port 3006",
-    "dev:s7": "slidev demo_semana7.md --open --port 3007",
-    "dev:s8": "slidev demo_semana8.md --open --port 3008",
-    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
-    "clean:downloads": "node -e \"require('fs').rmSync('public/descargas',{recursive:true,force:true}); require('fs').mkdirSync('public/descargas',{recursive:true})\"",
-    "clean:cache": "node -e \"require('fs').rmSync('.slidev',{recursive:true,force:true}); require('fs').rmSync('node_modules/.vite',{recursive:true,force:true})\"",
-    "build:index": "slidev build slides.md --out dist --base / --without-notes",
-    "build:s1": "slidev build demo_semana1.md --out dist/semanas/demo_semana1 --base /semanas/demo_semana1/ --without-notes",
-    "build:s2": "slidev build demo_semana2.md --out dist/semanas/demo_semana2 --base /semanas/demo_semana2/ --without-notes",
-    "build:s3": "slidev build demo_semana3.md --out dist/semanas/demo_semana3 --base /semanas/demo_semana3/ --without-notes",
-    "build:s4": "slidev build demo_semana4.md --out dist/semanas/demo_semana4 --base /semanas/demo_semana4/ --without-notes",
-    "build:s5": "slidev build demo_semana5.md --out dist/semanas/demo_semana5 --base /semanas/demo_semana5/ --without-notes",
-    "build:s6": "slidev build demo_semana6.md --out dist/semanas/demo_semana6 --base /semanas/demo_semana6/ --without-notes",
-    "build:s7": "slidev build demo_semana7.md --out dist/semanas/demo_semana7 --base /semanas/demo_semana7/ --without-notes",
-    "build:s8": "slidev build demo_semana8.md --out dist/semanas/demo_semana8 --base /semanas/demo_semana8/ --without-notes",
-    "build:all": "node scripts/build-site.mjs",
-    "build:incremental": "node scripts/build-incremental.mjs",
-    "export:downloads": "node scripts/export-downloads.mjs",
-    "export:incremental": "node scripts/export-incremental.mjs",
-    "vista": "npm run clean && npm run export:downloads && npm run build:all && http-server dist -p 4173 -c-1 -o",
-    "publicar": "node scripts/publicar.mjs",
-    "dev:todo": "node scripts/dev-all.mjs",
-    "nuevo": "node scripts/nuevo-curso.mjs",
-    "zip:template": "node scripts/zip-template.mjs",
-    "preview:static": "npm run build:all && http-server dist -p 4173 -c-1",
-    "preview:pages": "npm run export:downloads && npm run build:all && http-server dist -p 4173 -c-1",
-    "semana": "node scripts/semana.mjs",
-    "pages:check": "node scripts/preparar-github-pages.mjs",
-    "pages:build": "npm run export:downloads && npm run build:all",
-    "pages:preview": "npm run preview:pages",
-    "actualizar:tema": "npm create openclass-uniminuto@latest . -- --update-theme",
-    "actualizar:tema:preview": "npm run actualizar:tema && npm run dev"
-  },
-  "dependencies": {
-    "@fontsource/atkinson-hyperlegible": "^5.2.8",
-    "@fontsource/merriweather-sans": "^5.2.7",
-    "@fontsource/opendyslexic": "^5.2.5",
-    "@slidev/theme-seriph": "latest",
-    "vue": "^3.5.33"
-  },
-  "devDependencies": {
-    "@slidev/cli": "^52.15.0",
-    "@slidev/theme-default": "^0.25.0",
-    "concurrently": "^9.2.1",
-    "http-server": "^14.1.1",
-    "playwright-chromium": "^1.59.1",
-    "vite": "^7.1.12"
-  }
-}
+{
+  "name": "openclass-demo",
+  "version": "1.6.2",
+  "description": "Presentaciones Open Class del curso Curso Open Class de ejemplo.",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "dev": "slidev slides.md --open --port 3000",
+    "config": "node scripts/generar-desde-config.mjs",
+    "semana": "node scripts/semana.mjs",
+    "pages:check": "node scripts/preparar-github-pages.mjs",
+    "actualizar:tema": "npm create openclass-uniminuto@latest . -- --update-theme",
+    "actualizar:tema:preview": "npm run actualizar:tema && npm run config && npm run dev",
+    "dev:s1": "slidev demo_semana1.md --open --port 3001",
+    "dev:s2": "slidev demo_semana2.md --open --port 3002",
+    "dev:s3": "slidev demo_semana3.md --open --port 3003",
+    "dev:s4": "slidev demo_semana4.md --open --port 3004",
+    "dev:s5": "slidev demo_semana5.md --open --port 3005",
+    "dev:s6": "slidev demo_semana6.md --open --port 3006",
+    "dev:s7": "slidev demo_semana7.md --open --port 3007",
+    "dev:s8": "slidev demo_semana8.md --open --port 3008",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "clean:downloads": "node -e \"require('fs').rmSync('public/descargas',{recursive:true,force:true}); require('fs').mkdirSync('public/descargas',{recursive:true})\"",
+    "clean:cache": "node -e \"require('fs').rmSync('.slidev',{recursive:true,force:true}); require('fs').rmSync('node_modules/.vite',{recursive:true,force:true})\"",
+    "build:index": "slidev build slides.md --out dist --base / --without-notes",
+    "build:s1": "slidev build demo_semana1.md --out dist/semanas/demo_semana1 --base /semanas/demo_semana1/ --without-notes",
+    "build:s2": "slidev build demo_semana2.md --out dist/semanas/demo_semana2 --base /semanas/demo_semana2/ --without-notes",
+    "build:s3": "slidev build demo_semana3.md --out dist/semanas/demo_semana3 --base /semanas/demo_semana3/ --without-notes",
+    "build:s4": "slidev build demo_semana4.md --out dist/semanas/demo_semana4 --base /semanas/demo_semana4/ --without-notes",
+    "build:s5": "slidev build demo_semana5.md --out dist/semanas/demo_semana5 --base /semanas/demo_semana5/ --without-notes",
+    "build:s6": "slidev build demo_semana6.md --out dist/semanas/demo_semana6 --base /semanas/demo_semana6/ --without-notes",
+    "build:s7": "slidev build demo_semana7.md --out dist/semanas/demo_semana7 --base /semanas/demo_semana7/ --without-notes",
+    "build:s8": "slidev build demo_semana8.md --out dist/semanas/demo_semana8 --base /semanas/demo_semana8/ --without-notes",
+    "build:all": "node scripts/build-site.mjs",
+    "build:incremental": "node scripts/build-incremental.mjs",
+    "export:downloads": "node scripts/export-downloads.mjs",
+    "export:incremental": "node scripts/export-incremental.mjs",
+    "vista": "npm run config && npm run clean && npm run export:downloads && npm run build:all && http-server dist -p 4173 -c-1 -o",
+    "publicar": "node scripts/publicar.mjs",
+    "dev:todo": "node scripts/dev-all.mjs",
+    "nuevo": "node scripts/nuevo-curso.mjs",
+    "zip:template": "node scripts/zip-template.mjs",
+    "preview:static": "npm run config && npm run build:all && http-server dist -p 4173 -c-1",
+    "preview:pages": "npm run config && npm run export:downloads && npm run build:all && http-server dist -p 4173 -c-1",
+    "pages:build": "npm run config && npm run export:downloads && npm run build:all",
+    "pages:preview": "npm run preview:pages"
+  },
+  "dependencies": {
+    "@fontsource/atkinson-hyperlegible": "^5.2.8",
+    "@fontsource/merriweather-sans": "^5.2.7",
+    "@fontsource/opendyslexic": "^5.2.5",
+    "@slidev/theme-seriph": "latest",
+    "vue": "^3.5.33"
+  },
+  "devDependencies": {
+    "@slidev/cli": "^52.15.0",
+    "@slidev/theme-default": "^0.25.0",
+    "concurrently": "^9.2.1",
+    "http-server": "^14.1.1",
+    "playwright-chromium": "^1.59.1",
+    "vite": "^7.1.12"
+  }
+}

package/template/plantillas/launcher.md

@@ -8,4 +8,4 @@ routerMode: hash
 drawings:
   persist: false
 src: ./semanas/{{COURSE_SHORT}}_semana{{WEEK_NUMBER}}.md
----
+---

package/template/plantillas/semana.md

@@ -11,167 +11,293 @@ Semana {{WEEK_NUMBER}} — {{WEEK_TITLE}}
 ::date::
 {{WEEK_DATE}}
 
+---
+layout: slide-02-titulo
+---
+
+::title::
+Ruta de la Open Class
+
+---
+layout: slide-08-titulo-texto
+---
+
+::title::
+Contexto de la semana
+
+::content::
+Esta sesión aborda el tema **{{WEEK_THEME}}** desde una perspectiva aplicada, académica y profesional.
+
+La intención es que el estudiante relacione los conceptos centrales de la semana con situaciones reales del campo disciplinar, identifique problemas, analice alternativas y proponga decisiones fundamentadas.
+
 ---
 layout: slide-09-objetivos
 ---
 
 ::title::
-Objetivos de la sesión
+Objetivos de aprendizaje
+
+::content::
+Al finalizar esta Open Class, el estudiante estará en capacidad de:
+
+1. Reconocer los conceptos principales asociados con **{{WEEK_THEME}}**.
+2. Analizar una situación aplicada del curso a partir de criterios técnicos y académicos.
+3. Relacionar la teoría con una actividad práctica o evaluativa.
+4. Formular conclusiones que evidencien comprensión, argumentación y transferencia.
+
+---
+layout: slide-03-imagen-izquierda
+---
+
+::title::
+Lectura inicial del problema
+
+::image:: 
+<img src="/imagenes/favicon.png" alt="Imagen institucional de apoyo" />
 
 ::content::
-Al terminar esta sesión, el estudiante estará en capacidad de:
+En esta sección se presenta una situación inicial que permite introducir el tema de la semana.
+
+La imagen puede reemplazarse por una ilustración del curso ubicada en:
 
-- Reconocer los conceptos centrales asociados con **{{WEEK_TITLE}}**.
-- Relacionar la temática de la semana con situaciones académicas, profesionales o institucionales.
-- Desarrollar una actividad breve que evidencie comprensión, análisis y aplicación.
+`public/imagenes/`
 
-<!--
-Notas del presentador:
-Presentar los objetivos como una ruta de trabajo. Conectar cada objetivo con la actividad o evaluación de la semana para que el estudiante comprenda el sentido formativo de la sesión.
--->
+Ejemplo:
+
+`/imagenes/nombre_de_la_imagen.png`
 
 ---
-layout: slide-08-titulo-texto
+layout: slide-04-imagen-derecha
 ---
 
 ::title::
-Agenda de la Open Class
+Análisis del contexto
 
 ::content::
-La sesión se desarrollará en **90 minutos**:
+Este layout funciona bien cuando se desea ubicar la explicación conceptual en la parte izquierda y una imagen de apoyo en la parte derecha.
+
+Puedes usarlo para:
 
-- Bienvenida y encuadre inicial.
-- Contextualización de la temática de la semana.
-- Desarrollo conceptual con ejemplos.
-- Actividad didáctica breve.
-- Socialización de hallazgos.
-- Resolución de dudas.
-- Cierre académico y recordatorio de la Encuesta de Percepción Estudiantil.
+* Presentar un caso.
+* Mostrar un diagrama.
+* Explicar un flujo.
+* Relacionar conceptos con una situación profesional.
 
-<!--
-Notas del presentador:
-Recordar la tolerancia máxima de cinco minutos para iniciar. Mantener la actividad didáctica en un tiempo máximo aproximado de veinte minutos y reservar un bloque final para preguntas.
--->
+::image:: 
+<img src="/imagenes/favicon.png" alt="Imagen de apoyo para análisis del contexto" />
+
+---
+layout: slide-05-titulo-superior-texto-derecha
+---
+
+::title::
+Concepto clave de la semana
+
+::image:: 
+<img src="/imagenes/favicon.png" alt="Imagen conceptual de apoyo" />
+
+::content::
+Este layout permite destacar una imagen amplia en la parte izquierda y ubicar la explicación en la parte derecha.
+
+Úsalo cuando la imagen sea el punto de partida del análisis y el texto funcione como interpretación, guía o síntesis.
+
+Ejemplo de uso:
+
+* Arquitectura de un sistema.
+* Mapa conceptual.
+* Flujo de proceso.
+* Escenario problemático.
+* Representación visual de un caso.
+
+---
+layout: slide-06-titulo-superior-texto-izquierda
+---
+
+::title::
+Relación entre teoría y práctica
+
+::content::
+Este layout invierte la organización anterior: el texto queda a la izquierda y la imagen a la derecha.
+
+Es útil cuando primero quieres orientar la lectura conceptual y luego apoyar la explicación con una imagen.
+
+Se recomienda usarlo para:
+
+1. Explicar criterios.
+2. Presentar una secuencia de análisis.
+3. Introducir una práctica guiada.
+4. Preparar al estudiante para una actividad.
+
+::image:: 
+<img src="/imagenes/favicon.png" alt="Imagen de apoyo para teoría y práctica" />
+
+---
+layout: slide-07-multimedia-con-titulo
+---
+
+::title::
+Recurso multimedia de apoyo
+
+::media::
+
+<iframe
+  width="100%"
+  height="100%"
+  src="https://www.youtube.com/embed/dQw4w9WgXcQ"
+  title="Recurso multimedia de apoyo"
+  frameborder="0"
+  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
+  allowfullscreen>
+</iframe>
 
 ---
 layout: slide-08-titulo-texto
 ---
 
 ::title::
-Contextualización de la semana
+Síntesis conceptual
 
 ::content::
-Esta semana se aborda **{{WEEK_TITLE}}** como eje para comprender problemas, decisiones y aplicaciones propias del curso.
+Utiliza este layout para desarrollar una explicación central sin imágenes.
 
-**Tema central:** {{WEEK_THEME}}
+Ejemplo de estructura sugerida:
 
-La intención es conectar el contenido con casos reales, experiencias profesionales y criterios de análisis que permitan pasar de la comprensión conceptual a la aplicación práctica.
+* **Idea principal:** presentar el concepto fundamental.
+* **Aplicación:** explicar cómo se observa en un contexto real.
+* **Criterio de análisis:** indicar qué debe observar el estudiante.
+* **Conclusión parcial:** cerrar con una frase que conecte con la actividad.
 
-<!--
-Notas del presentador:
-Iniciar con una pregunta detonante o un ejemplo cercano al contexto del grupo. Evitar una exposición únicamente teórica: llevar el tema hacia decisiones, consecuencias, riesgos, oportunidades o productos concretos.
--->
+También puedes usar párrafos breves cuando necesites explicar una idea con mayor profundidad académica.
 
 ---
 layout: slide-10-titulo-dos-columnas
 ---
 
 ::title::
-Desarrollo conceptual
+Comparación de enfoques
 
 ::left::
-**Ideas clave**
 
-- Concepto principal de la semana.
-- Elementos, componentes o criterios asociados.
-- Relación con el propósito del curso.
-- Aplicaciones en contextos reales.
+### Enfoque 1
+
+Este espacio puede usarse para presentar una primera postura, alternativa, componente o criterio de análisis.
+
+* Característica principal.
+* Ventaja.
+* Riesgo o limitación.
+* Ejemplo aplicado.
 
 ::right::
-**Preguntas orientadoras**
 
-- ¿Qué problema permite comprender o resolver este tema?
-- ¿Qué decisiones se pueden tomar a partir de este conocimiento?
-- ¿Qué evidencias muestran que el estudiante comprendió el tema?
+### Enfoque 2
 
-<!--
-Notas del presentador:
-Usar esta diapositiva para organizar la explicación central. Reemplazar los puntos por los conceptos específicos del curso y de la semana.
--->
+Este espacio puede usarse para contrastar una segunda postura, alternativa, componente o criterio.
+
+* Característica principal.
+* Ventaja.
+* Riesgo o limitación.
+* Ejemplo aplicado.
 
 ---
-layout: slide-10-titulo-dos-columnas
+layout: slide-11-dos-titulos-dos-columnas
 ---
 
-::title::
-Actividad didáctica breve
+::leftTitle::
+Antes del análisis
+
+::rightTitle::
+Después del análisis
 
 ::left::
-**Instrucciones**
+En esta columna puedes describir la situación inicial, las ideas previas, los datos disponibles o las condiciones del problema.
 
-- Organizar el trabajo de forma individual, en parejas o en pequeños grupos.
-- Analizar el caso, pregunta o reto propuesto por el docente.
-- Construir una respuesta breve y justificable.
-- Socializar una conclusión en plenaria.
+Ejemplo:
 
-::right::
-**Producto esperado**
+* Información dispersa.
+* Criterios poco claros.
+* Necesidad de priorización.
+* Dudas frente a la toma de decisiones.
 
-{{WEEK_ACTIVITY}}
+::right::
+En esta columna puedes mostrar el resultado esperado después del análisis.
 
-La evidencia puede presentarse como una respuesta argumentada, esquema, captura, simulación, reflexión, mapa breve o producto digital, según la orientación del docente.
+Ejemplo:
 
-<!--
-Notas del presentador:
-Controlar el tiempo de la actividad. Se recomienda no superar veinte minutos para conservar espacio de socialización y dudas.
--->
+* Criterios definidos.
+* Decisiones justificadas.
+* Evidencias organizadas.
+* Conclusiones argumentadas.
 
 ---
-layout: slide-08-titulo-texto
+layout: slide-codigo
 ---
 
 ::title::
-Relación con la evaluación
+Ejemplo técnico guiado
 
 ::content::
-El trabajo de la semana se articula con la actividad o evaluación del curso mediante:
 
-- Comprensión de conceptos clave.
-- Aplicación en un caso o situación práctica.
-- Justificación de decisiones tomadas.
-- Comunicación clara de resultados.
-- Revisión de evidencias y criterios de calidad.
+```python {lines:true}
+# Ejemplo base para reemplazar según el curso
+# Este bloque puede usarse en asignaturas con práctica computacional,
+# análisis de datos, simulación, seguridad, IoT o programación.
+
+tema = "{{WEEK_THEME}}"
+actividad = "{{WEEK_ACTIVITY}}"
 
-<!--
-Notas del presentador:
-Explicar qué debe cuidar el estudiante para avanzar en la actividad evaluativa. Precisar si se requiere entrega en aula virtual, participación en foro, documento, evidencia audiovisual, práctica o cuestionario.
--->
+def presentar_contexto(tema, actividad):
+    print("Tema central:", tema)
+    print("Actividad:", actividad)
+    print("Propósito: relacionar teoría, práctica y análisis crítico.")
+
+presentar_contexto(tema, actividad)
+```
 
 ---
 layout: slide-08-titulo-texto
 ---
 
 ::title::
-Resolución de dudas
+Actividad de aplicación
 
 ::content::
-Este espacio se orienta a resolver inquietudes sobre:
+**{{WEEK_ACTIVITY}}**
+
+Orientaciones sugeridas:
 
-- Conceptos revisados durante la sesión.
-- Actividad práctica o evaluación relacionada.
-- Criterios de entrega y evidencias esperadas.
-- Uso de herramientas, recursos o materiales de apoyo.
+1. Leer la situación propuesta por el docente.
+2. Identificar los conceptos de la semana presentes en el caso.
+3. Analizar alternativas de solución o interpretación.
+4. Socializar una conclusión breve con argumentos.
+5. Relacionar la actividad con la evidencia o evaluación correspondiente.
 
-<!--
-Notas del presentador:
-Mantener este bloque dentro de un máximo aproximado de quince minutos. Priorizar dudas que afecten la comprensión del tema o la entrega de la actividad.
--->
+Duración estimada: **{{WEEK_DURATION}}**.
 
 ---
-layout: slide-12-cierre
+layout: slide-10-titulo-dos-columnas
 ---
 
-<!--
-Notas del presentador:
-Cerrar con una síntesis de tres ideas centrales, recordar el compromiso académico de la semana e invitar a diligenciar la Encuesta de Percepción Estudiantil cuando aplique.
--->
+::title::
+Preguntas orientadoras
+
+::left::
+
+### Para comprender
+
+* ¿Cuál es el problema central?
+* ¿Qué conceptos de la semana permiten analizarlo?
+* ¿Qué información es necesaria para tomar una decisión?
+* ¿Qué criterios deben priorizarse?
+
+::right::
+
+### Para aplicar
+
+* ¿Qué alternativa parece más adecuada?
+* ¿Qué riesgos o limitaciones existen?
+* ¿Cómo se justificaría la decisión?
+* ¿Qué aprendizaje se transfiere a un contexto profesional?
+
+---
+layout: slide-12-cierre
+---

package/template/scripts/decks.mjs

@@ -1,14 +1,21 @@
 function normalizeBase(value) {
   let base = value || "/";
-  if (!base.startsWith("/")) base = `/${base}`;
-  if (!base.endsWith("/")) base = `${base}/`;
+
+  if (!base.startsWith("/")) {
+    base = `/${base}`;
+  }
+
+  if (!base.endsWith("/")) {
+    base = `${base}/`;
+  }
+
   return base;
 }
 
 const SITE_BASE = normalizeBase(process.env.SITE_BASE || "/");
 
-function withBase(path = "") {
-  return `${SITE_BASE}${path.replace(/^\/+/, "")}`;
+function withBase(value = "") {
+  return `${SITE_BASE}${value.replace(/^[/]+/, "")}`;
 }
 
 export const decks = [
@@ -27,3 +34,5 @@ export const decks = [
     exportable: true,
   },
 ];
+
+export default decks;

package/template/scripts/dev-all.mjs

@@ -1,5 +1,5 @@
-import { decks } from "./decks.mjs";
 import { spawn } from "node:child_process";
+import { decks } from "./decks.mjs";
 
 const COLORS = [
   "bgBlue.bold",
@@ -11,27 +11,40 @@ const COLORS = [
   "blue.bold",
   "green.bold",
   "yellow.bold",
+  "magenta.bold",
+  "cyan.bold",
+  "red.bold",
 ];
 
-const semanas = decks.filter((deck) => deck.entry !== "slides.md");
 const BASE_PORT = 3000;
 
+const weeklyDecks = decks.filter((deck) => deck.entry !== "slides.md");
+
 const commands = [
   `slidev slides.md --open --port ${BASE_PORT}`,
-  ...semanas.map((deck, index) => `slidev ${deck.entry} --port ${BASE_PORT + index + 1}`),
+  ...weeklyDecks.map((deck, index) => {
+    return `slidev ${deck.entry} --port ${BASE_PORT + index + 1}`;
+  }),
 ];
 
-const names = ["portal", ...semanas.map((deck) => deck.name)].join(",");
+const names = ["portal", ...weeklyDecks.map((deck) => deck.name)].join(",");
 const colors = COLORS.slice(0, commands.length).join(",");
 
-console.log("\n🚀 Iniciando servidores de desarrollo...");
+console.log("");
+console.log("🚀 Iniciando servidores de desarrollo...");
 console.log(`   portal → http://localhost:${BASE_PORT}`);
-semanas.forEach((deck, index) => {
+
+weeklyDecks.forEach((deck, index) => {
   console.log(`   ${deck.name} → http://localhost:${BASE_PORT + index + 1}`);
 });
+
 console.log("");
 
-spawn("concurrently", ["-n", names, "-c", colors, ...commands], {
+const child = spawn("concurrently", ["-n", names, "-c", colors, ...commands], {
   stdio: "inherit",
   shell: true,
 });
+
+child.on("exit", (code) => {
+  process.exit(code ?? 0);
+});