create-openclass-uniminuto 1.6.1 → 1.6.2

package/bin/create-openclass-uniminuto.mjs

@@ -15,8 +15,21 @@ const positional = args.filter((arg) => !arg.startsWith("--"));
 const targetArg = positional[0] || "openclass-uniminuto";
 const targetDir = path.resolve(process.cwd(), targetArg);
 const isCurrentDirectoryTarget = targetArg === "." || targetArg === "./";
-const forceOverwrite = flags.has("--force");
-const updateTheme = flags.has("--update-theme") || flags.has("--sync-theme");
+function envFlag(name) {
+  const value = process.env[name];
+  if (value === undefined) return false;
+  return ["1", "true", "yes", "on"].includes(String(value).toLowerCase());
+}
+
+const forceOverwrite =
+  flags.has("--force") ||
+  envFlag("npm_config_force");
+
+const updateTheme =
+  flags.has("--update-theme") ||
+  flags.has("--sync-theme") ||
+  envFlag("npm_config_update_theme") ||
+  envFlag("npm_config_sync_theme");
 
 function log(message = "") {
   console.log(message);
@@ -100,13 +113,23 @@ function updateThemeOnly() {
   log("Modo: solo theme/components/styles/layouts y recursos base seguros\n");
 
   const pathsToUpdate = [
-    "theme/uniminuto/components",
+    "README.md",
+"theme/uniminuto/components",
     "theme/uniminuto/layouts",
     "theme/uniminuto/styles",
     "theme/uniminuto/package.json",
     "theme/uniminuto/README-AutoFit.md",
     "setup",
-    "snippets"
+    "snippets",
+    "scripts/build-site.mjs",
+    "scripts/build-incremental.mjs",
+    "scripts/decks.mjs",
+    "scripts/dev-all.mjs",
+    "scripts/export-downloads.mjs",
+    "scripts/export-incremental.mjs",
+    "scripts/preparar-github-pages.mjs",
+    "scripts/semana.mjs",
+    ".github/workflows/deploy.yml"
   ];
 
   for (const relativePath of pathsToUpdate) {
@@ -117,6 +140,37 @@ function updateThemeOnly() {
   ensureFileFromTemplate("public/imagenes/favicon.png", { onlyIfMissing: true });
   ensureFileFromTemplate("public/imagenes/avion.png", { onlyIfMissing: false });
 
+  patchJson(path.join(targetDir, "package.json"), (pkg) => {
+    pkg.scripts = pkg.scripts || {};
+    pkg.scripts["dev"] = pkg.scripts["dev"] || "slidev slides.md --open --port 3000";
+    pkg.scripts["dev:all"] = "node scripts/dev-all.mjs";
+    pkg.scripts["dev:todo"] = "node scripts/dev-all.mjs";
+    pkg.scripts["build:all"] = "node scripts/build-site.mjs";
+    pkg.scripts["build:incremental"] = "node scripts/build-incremental.mjs";
+    pkg.scripts["export:downloads"] = "node scripts/export-downloads.mjs";
+    pkg.scripts["export:incremental"] = "node scripts/export-incremental.mjs";
+    pkg.scripts["pages:check"] = "node scripts/preparar-github-pages.mjs";
+    pkg.scripts["pages:build"] = "npm run export:downloads && npm run build:all";
+    pkg.scripts["pages:preview"] = "npm run preview:pages";
+    pkg.scripts["semana"] = "node scripts/semana.mjs";
+    pkg.scripts["actualizar:tema"] = "npm create openclass-uniminuto@latest . -- --update-theme";
+  });
+
+  patchJson(path.join(targetDir, "package.json"), (pkg) => {
+    pkg.scripts = pkg.scripts || {};
+    pkg.scripts["dev"] = pkg.scripts["dev"] || "slidev slides.md --open --port 3000";
+    pkg.scripts["dev:all"] = "node scripts/dev-all.mjs";
+    pkg.scripts["dev:todo"] = "node scripts/dev-all.mjs";
+    pkg.scripts["build:all"] = "node scripts/build-site.mjs";
+    pkg.scripts["build:incremental"] = "node scripts/build-incremental.mjs";
+    pkg.scripts["export:downloads"] = "node scripts/export-downloads.mjs";
+    pkg.scripts["export:incremental"] = "node scripts/export-incremental.mjs";
+    pkg.scripts["pages:check"] = "node scripts/preparar-github-pages.mjs";
+    pkg.scripts["pages:build"] = "npm run export:downloads && npm run build:all";
+    pkg.scripts["pages:preview"] = "npm run preview:pages";
+    pkg.scripts["semana"] = "node scripts/semana.mjs";
+    pkg.scripts["actualizar:tema"] = "npm create openclass-uniminuto@latest . -- --update-theme";
+  });
   log("\n✅ Tema actualizado sin tocar semanas, slides.md ni openclass.config.json.");
   log("   Recomendado ahora:");
   log("     npm run dev");
@@ -220,3 +274,5 @@ log("  npm create openclass-uniminuto@latest . -- --update-theme");
 log("\nPara revisar la publicación en GitHub Pages:");
 log("  npm run pages:check");
 log("");
+
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-openclass-uniminuto",
-  "version": "1.6.1",
+  "version": "1.6.2",
   "description": "Creador de proyectos Open Class UNIMINUTO basados en Slidev, con generación incremental por semanas, actualización de tema y GitHub Pages.",
   "type": "module",
   "bin": {

package/template/README.md

@@ -6,7 +6,6 @@ Este curso está diseñado para organizar una Open Class de **8 semanas**, con g
 
 ---
 
-
 ## 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:
@@ -34,6 +33,7 @@ git commit -m "Configura Open Class"
 git push
 ```
 
+---
 
 ## 1. Primer uso
 
@@ -69,6 +69,12 @@ npm run dev:s2
 npm run dev:s3
 ```
 
+También puedes abrir todas las semanas activas en varios puertos:
+
+```bash
+npm run dev:all
+```
+
 ---
 
 ## 2. Tres formas de crear este curso
@@ -173,7 +179,7 @@ El contenido ya editado dentro de `semanas/*.md` se conserva. Solo se sobrescrib
 npm run semana -- 4 --force-content
 ```
 
-Para activar únicamente una semana:
+Para activar únicamente una semana ya existente:
 
 ```bash
 npm run semana -- 4 --only
@@ -199,6 +205,22 @@ semanas/iot_semana3.md
 
 Los archivos de la raíz como `iot_semana1.md` funcionan como lanzadores. Normalmente no debes editarlos manualmente.
 
+Un lanzador raíz tiene una estructura como esta:
+
+```md
+---
+theme: ./theme/uniminuto
+title: Curso — Semana 1
+favicon: /favicon.png
+codeCopy: true
+transition: fade
+routerMode: hash
+drawings:
+  persist: false
+src: ./semanas/curso_semana1.md
+---
+```
+
 ---
 
 ## 5. Recursos del curso
@@ -212,9 +234,65 @@ public/descargas/   PDF, PPTX u otros descargables
 public/fondos/      fondos institucionales
 ```
 
+Recomendaciones:
+
+* Guarda imágenes propias del curso en `public/imagenes/`.
+* Usa nombres cortos, claros y sin espacios.
+* En las diapositivas, referencia imágenes con rutas absolutas desde `public`.
+
+Ejemplo:
+
+```html
+<img src="/imagenes/iot-semana1-arquitectura.png" alt="Arquitectura IoT" />
+```
+
+Evita rutas demasiado largas o generadas a partir de prompts completos.
+
+---
+
+## 6. Detección automática de semanas
+
+El proyecto detecta automáticamente las presentaciones semanales disponibles a partir de los lanzadores ubicados en la raíz.
+
+Ejemplo:
+
+```text
+iot_semana1.md
+iot_semana2.md
+gestionseguridad_semana7.md
+bigdata_semana4.md
+```
+
+Cada archivo raíz debe apuntar al contenido real ubicado en `semanas/`.
+
+El archivo `scripts/decks.mjs` detecta estos lanzadores y construye automáticamente el portal principal y todas las semanas activas.
+
+Ya no es necesario editar manualmente `scripts/decks.mjs` para activar cada semana, siempre que el lanzador raíz exista y tenga un nombre con este patrón:
+
+```text
+curso_semanaN.md
+```
+
+Ejemplos válidos:
+
+```text
+bigdata_semana1.md
+iot_semana5.md
+gestionseguridad_semana7.md
+percepcioncomputacional_semana8.md
+```
+
+Ejemplos que no se incluyen automáticamente:
+
+```text
+demo_semana1.md
+semana1.md
+presentacion.md
+```
+
 ---
 
-## 6. Construcción local
+## 7. Construcción local
 
 Construir el portal y las semanas activas:
 
@@ -222,6 +300,23 @@ Construir el portal y las semanas activas:
 npm run pages:build
 ```
 
+Este comando ejecuta:
+
+```text
+npm run export:downloads
+npm run build:all
+```
+
+Por tanto, genera:
+
+```text
+dist/                         sitio estático final
+dist/semanas/                 semanas publicadas
+public/descargas/*.pdf        descargas PDF
+public/descargas/*.pptx       descargas PPTX
+dist/.nojekyll                archivo requerido para GitHub Pages
+```
+
 Previsualizar la versión estática:
 
 ```bash
@@ -234,9 +329,15 @@ Revisar configuración para GitHub Pages:
 npm run pages:check
 ```
 
+También puedes probar directamente la carpeta `dist` con:
+
+```bash
+npx serve dist
+```
+
 ---
 
-## 7. Publicar en GitHub Pages
+## 8. Publicar en GitHub Pages
 
 Este proyecto ya incluye:
 
@@ -274,9 +375,67 @@ Ejemplo:
 https://herrerawilliamh.github.io/openclass-iot/
 ```
 
+Las semanas quedarán disponibles en rutas como:
+
+```text
+https://herrerawilliamh.github.io/openclass-iot/semanas/iot_semana1/
+https://herrerawilliamh.github.io/openclass-iot/semanas/iot_semana2/
+```
+
+---
+
+## 9. Actualizar tema, layouts y scripts en un curso existente
+
+Si el curso ya existe y solo quieres actualizar tema, layouts, scripts de build, workflow y documentación base sin tocar el contenido académico de `semanas/`, usa:
+
+```bash
+npm create openclass-uniminuto@latest . -- --update-theme
+```
+
+Este comando actualiza recursos seguros como:
+
+```text
+README.md
+theme/uniminuto/
+scripts/decks.mjs
+scripts/dev-all.mjs
+scripts/build-site.mjs
+scripts/build-incremental.mjs
+scripts/export-downloads.mjs
+scripts/export-incremental.mjs
+scripts/preparar-github-pages.mjs
+scripts/semana.mjs
+.github/workflows/deploy.yml
+public/imagenes/avion.png
+```
+
+No debería sobrescribir:
+
+```text
+slides.md
+openclass.config.json
+semanas/*.md
+public/imagenes propias del curso
+```
+
+Después de actualizar, revisa:
+
+```bash
+git status
+npm run pages:build
+```
+
+Si todo funciona:
+
+```bash
+git add -A
+git commit -m "Actualizar tema institucional Open Class"
+git push
+```
+
 ---
 
-## 8. Flujo semanal sugerido
+## 10. Flujo semanal sugerido
 
 Semana 1:
 
@@ -300,27 +459,154 @@ Repite el proceso hasta la semana 8.
 
 ---
 
-## 9. Comandos útiles
+## 11. 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 dev:all`         | Abre portal y semanas activas en varios puertos |
+| `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      |
+| `npm run actualizar:tema` | Actualiza tema/layouts/scripts desde npm        |
 
-| 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 |
+---
+
+## 12. Archivos clave
+
+```text
+openclass.config.json          configuración general del curso
+slides.md                      portal principal
+semanas/                       contenido académico real
+curso_semanaN.md               lanzadores raíz de cada semana
+scripts/decks.mjs              detección automática de semanas activas
+scripts/build-site.mjs         construcción de portal y semanas
+scripts/export-downloads.mjs   exportación de PDF/PPTX
+.github/workflows/deploy.yml   despliegue automático en GitHub Pages
+theme/uniminuto/               tema institucional UNIMINUTO
+public/imagenes/               imágenes del curso
+public/descargas/              archivos PDF/PPTX exportados
+```
 
 ---
 
-## 10. Archivos clave
+## 13. Recomendaciones antes de publicar
+
+Antes de hacer `git push`, revisa:
+
+```bash
+git status
+npm run pages:build
+```
+
+Confirma que existan las semanas generadas:
+
+```bash
+ls dist/semanas
+```
+
+En Windows PowerShell:
+
+```powershell
+Get-ChildItem .\dist\semanas | Select-Object Name
+```
+
+Confirma que una semana específica exista:
+
+```powershell
+Test-Path .\dist\semanas\curso_semana1\index.html
+```
+
+Si responde `True`, esa semana fue generada correctamente.
+
+---
+
+## 14. Problemas comunes
+
+### La semana abre localmente, pero no aparece en GitHub Pages
+
+Verifica que exista el lanzador raíz:
+
+```text
+curso_semanaN.md
+```
+
+y que apunte al archivo real:
+
+```text
+semanas/curso_semanaN.md
+```
+
+Luego ejecuta:
+
+```bash
+npm run pages:build
+```
+
+### Error con imágenes
+
+Si aparece un error como:
+
+```text
+Failed to resolve import "/imagenes/..."
+```
+
+revisa que el archivo exista en:
 
 ```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
+public/imagenes/
 ```
+
+y que la ruta usada en la diapositiva tenga extensión correcta.
+
+Ejemplo válido:
+
+```html
+<img src="/imagenes/semana701.png" alt="Imagen de apoyo" />
+```
+
+### GitHub Pages no publica
+
+Revisa:
+
+```text
+Settings → Pages → Source → GitHub Actions
+Actions → Deploy Open Class to GitHub Pages
+```
+
+También puedes ejecutar:
+
+```bash
+npm run pages:check
+```
+
+### Warnings de build
+
+Algunos mensajes informativos no bloquean la publicación si el build termina con:
+
+```text
+✓ built
+✓ dist/.nojekyll creado para GitHub Pages.
+```
+
+---
+
+## 15. Actualizar este proyecto desde el generador local
+
+Durante desarrollo del generador, también puedes aplicar la actualización de tema desde una copia local:
+
+```bash
+node ../create-openclass-uniminuto/bin/create-openclass-uniminuto.mjs . --update-theme
+```
+
+En Windows, desde una carpeta de curso ubicada dentro de `D:\OpenClass`:
+
+```powershell
+node ..\create-openclass-uniminuto\bin\create-openclass-uniminuto.mjs . --update-theme
+```
+
+Esto es útil para probar cambios antes de publicar una nueva versión npm.

package/template/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclass-demo",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "description": "Presentaciones Open Class del curso Curso Open Class de ejemplo.",
   "type": "module",
   "private": true,
@@ -43,7 +43,8 @@
     "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"
+    "actualizar:tema:preview": "npm run actualizar:tema && npm run dev",
+    "dev:all": "node scripts/dev-all.mjs"
   },
   "dependencies": {
     "@fontsource/atkinson-hyperlegible": "^5.2.8",

package/template/scripts/decks.mjs

@@ -1,7 +1,16 @@
+import { readdirSync } from "node:fs";
+
 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;
 }
 
@@ -11,19 +20,48 @@ function withBase(path = "") {
   return `${SITE_BASE}${path.replace(/^\/+/, "")}`;
 }
 
+function getWeekNumber(filename) {
+  const match = filename.match(/_semana(\d+)\.md$/i);
+  return match ? Number(match[1]) : 999;
+}
+
+function getDeckName(filename) {
+  return filename.replace(/\.md$/i, "");
+}
+
+const rootFiles = readdirSync(process.cwd(), { withFileTypes: true })
+  .filter((item) => item.isFile())
+  .map((item) => item.name);
+
+const weeklyEntries = rootFiles
+  .filter((name) => /^[a-z0-9_-]+_semana\d+\.md$/i.test(name))
+  .filter((name) => !name.startsWith("demo_"))
+  .sort((a, b) => {
+    const weekDiff = getWeekNumber(a) - getWeekNumber(b);
+    return weekDiff !== 0 ? weekDiff : a.localeCompare(b);
+  });
+
+const weeklyDecks = weeklyEntries.map((entry) => {
+  const name = getDeckName(entry);
+
+  return {
+    name,
+    entry,
+    out: `dist/semanas/${name}`,
+    base: withBase(`semanas/${name}/`),
+    exportable: true,
+  };
+});
+
 export const decks = [
   {
-    name: "openclass-demo",
+    name: "openclass-main",
     entry: "slides.md",
     out: "dist",
     base: SITE_BASE,
     exportable: false,
   },
-  {
-    name: "demo_semana1",
-    entry: "demo_semana1.md",
-    out: "dist/semanas/demo_semana1",
-    base: withBase("semanas/demo_semana1/"),
-    exportable: true,
-  },
+  ...weeklyDecks,
 ];
+
+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);
+});

package/template/theme/uniminuto/styles/base.css

@@ -92,9 +92,9 @@
   overflow: hidden;
 }
 
-.uni-stack-slot :deep(p),
-.uni-image-slot :deep(p),
-.uni-media-slot :deep(p) {
+.uni-stack-slot p,
+.uni-image-slot p,
+.uni-media-slot p {
   margin: 0;
   width: 100%;
   max-width: 100%;
@@ -105,8 +105,8 @@
   gap: 0.55rem;
 }
 
-.uni-stack-slot :deep(img),
-.uni-image-slot :deep(img) {
+.uni-stack-slot img,
+.uni-image-slot img {
   display: block;
   width: auto;
   height: auto;
@@ -116,9 +116,9 @@
   object-position: center;
 }
 
-.uni-media-slot :deep(img),
-.uni-media-slot :deep(video),
-.uni-media-slot :deep(iframe) {
+.uni-media-slot img,
+.uni-media-slot video,
+.uni-media-slot iframe {
   display: block;
   width: 100%;
   height: 100%;
@@ -212,3 +212,4 @@
   background: rgba(242, 181, 27, 0.8);
   border-radius: 999px;
 }
+