create-openclass-uniminuto 1.4.0 → 1.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-openclass-uniminuto",
3
- "version": "1.4.0",
3
+ "version": "1.4.1",
4
4
  "description": "Creador de proyectos Open Class UNIMINUTO basados en Slidev, con generación incremental por semanas y GitHub Pages.",
5
5
  "type": "module",
6
6
  "bin": {
@@ -1,326 +1,329 @@
1
- # Open Class UNIMINUTO · Slidev
2
-
3
- Proyecto generado con `create-openclass-uniminuto` o creado desde la plantilla `openclass-uniminuto-template`.
4
-
5
- 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**.
6
-
7
- ---
8
-
9
-
10
- ## Crear el curso dentro de un repositorio ya creado en GitHub
11
-
12
- Si primero creaste el repositorio en GitHub, clónalo y aplica la plantilla desde npm dentro de la carpeta del repositorio:
13
-
14
- ```bash
15
- git clone https://github.com/herrerawilliamh/openclass-iot.git
16
- cd openclass-iot
17
- npm create openclass-uniminuto@latest . -- --iot
18
- npm install
19
- npm run semana -- 1
20
- npm run dev
21
- ```
22
-
23
- Si el repositorio ya tenía archivos iniciales y deseas reemplazarlos por los de la plantilla:
24
-
25
- ```bash
26
- npm create openclass-uniminuto@latest . -- --iot --force
27
- ```
28
-
29
- La sincronización con GitHub se hace después con Git:
30
-
31
- ```bash
32
- git add -A
33
- git commit -m "Configura Open Class"
34
- git push
35
- ```
36
-
37
-
38
- ## 1. Primer uso
39
-
40
- Instala dependencias:
41
-
42
- ```bash
43
- npm install
44
- ```
45
-
46
- Configura el curso desde consola:
47
-
48
- ```bash
49
- npm run nuevo
50
- ```
51
-
52
- Genera la primera semana:
53
-
54
- ```bash
55
- npm run semana -- 1
56
- ```
57
-
58
- Ejecuta el portal principal:
59
-
60
- ```bash
61
- npm run dev
62
- ```
63
-
64
- Una semana específica se abre con:
65
-
66
- ```bash
67
- npm run dev:s1
68
- npm run dev:s2
69
- npm run dev:s3
70
- ```
71
-
72
- ---
73
-
74
- ## 2. Tres formas de crear este curso
75
-
76
- ### Opción A · Desde npm
77
-
78
- ```bash
79
- npm create openclass-uniminuto@latest openclass-iot -- --iot
80
- cd openclass-iot
81
- npm install
82
- npm run semana -- 1
83
- npm run dev
84
- ```
85
-
86
- ### Opción B · Desde GitHub Template
87
-
88
- 1. Entra al repositorio `openclass-uniminuto-template`.
89
- 2. Clic en **Use this template**.
90
- 3. Crea un repositorio nuevo, por ejemplo `openclass-iot`.
91
- 4. Clónalo.
92
- 5. Ejecuta los comandos del curso.
93
-
94
- ```bash
95
- git clone https://github.com/herrerawilliamh/openclass-iot.git
96
- cd openclass-iot
97
- npm install
98
- npm run nuevo
99
- npm run semana -- 1
100
- npm run dev
101
- ```
102
-
103
- ### Opción C · Repo creado en GitHub y curso generado en local
104
-
105
- Esta opción combina GitHub y npm.
106
-
107
- #### Si el repositorio fue creado desde plantilla
108
-
109
- ```bash
110
- git clone https://github.com/herrerawilliamh/openclass-iot.git
111
- cd openclass-iot
112
- npm install
113
- npm run nuevo
114
- npm run semana -- 1
115
- npm run dev
116
- ```
117
-
118
- Luego:
119
-
120
- ```bash
121
- git add -A
122
- git commit -m "Generar semana 1"
123
- git push
124
- ```
125
-
126
- #### Si el repositorio está vacío
127
-
128
- ```bash
129
- npm create openclass-uniminuto@latest openclass-iot -- --iot
130
- cd openclass-iot
131
- npm install
132
- npm run semana -- 1
133
- npm run dev
134
- ```
135
-
136
- Después conecta el remoto:
137
-
138
- ```bash
139
- git init
140
- git branch -M main
141
- git add -A
142
- git commit -m "Publicación inicial Open Class"
143
- git remote add origin https://github.com/herrerawilliamh/openclass-iot.git
144
- git push -u origin main
145
- ```
146
-
147
- ---
148
-
149
- ## 3. Generar semanas una a una
150
-
151
- El curso siempre se organiza en **8 semanas**. Puedes generarlas progresivamente.
152
-
153
- ```bash
154
- npm run semana -- 1
155
- npm run semana -- 2 --title "Título de la semana 2" --date "Junio 15 de 2026"
156
- npm run semana -- 3 --title "Título de la semana 3" --theme "Tema central"
157
- ```
158
-
159
- El comando `semana` actualiza automáticamente:
160
-
161
- ```text
162
- openclass.config.json
163
- slides.md
164
- scripts/decks.mjs
165
- package.json
166
- curso_semanaN.md
167
- semanas/curso_semanaN.md
168
- ```
169
-
170
- El contenido ya editado dentro de `semanas/*.md` se conserva. Solo se sobrescribe si usas:
171
-
172
- ```bash
173
- npm run semana -- 4 --force-content
174
- ```
175
-
176
- Para activar únicamente una semana:
177
-
178
- ```bash
179
- npm run semana -- 4 --only
180
- ```
181
-
182
- ---
183
-
184
- ## 4. Editar contenido académico
185
-
186
- El contenido real de cada presentación está en:
187
-
188
- ```text
189
- semanas/
190
- ```
191
-
192
- Ejemplo:
193
-
194
- ```text
195
- semanas/iot_semana1.md
196
- semanas/iot_semana2.md
197
- semanas/iot_semana3.md
198
- ```
199
-
200
- Los archivos de la raíz como `iot_semana1.md` funcionan como lanzadores. Normalmente no debes editarlos manualmente.
201
-
202
- ---
203
-
204
- ## 5. Recursos del curso
205
-
206
- Usa estas carpetas:
207
-
208
- ```text
209
- public/imagenes/ imágenes del curso
210
- public/videos/ videos y recursos audiovisuales
211
- public/descargas/ PDF, PPTX u otros descargables
212
- public/fondos/ fondos institucionales
213
- ```
214
-
215
- ---
216
-
217
- ## 6. Construcción local
218
-
219
- Construir el portal y las semanas activas:
220
-
221
- ```bash
222
- npm run pages:build
223
- ```
224
-
225
- Previsualizar la versión estática:
226
-
227
- ```bash
228
- npm run pages:preview
229
- ```
230
-
231
- Revisar configuración para GitHub Pages:
232
-
233
- ```bash
234
- npm run pages:check
235
- ```
236
-
237
- ---
238
-
239
- ## 7. Publicar en GitHub Pages
240
-
241
- Este proyecto ya incluye:
242
-
243
- ```text
244
- .github/workflows/deploy.yml
245
- ```
246
-
247
- El workflow construye el sitio y publica la carpeta `dist` en GitHub Pages.
248
-
249
- En GitHub configura:
250
-
251
- ```text
252
- Settings → Pages → Build and deployment → Source → GitHub Actions
253
- ```
254
-
255
- Luego sube cambios:
256
-
257
- ```bash
258
- git add -A
259
- git commit -m "Actualizar Open Class"
260
- git push
261
- ```
262
-
263
- Cada `push` a `main` construirá y publicará el sitio automáticamente.
264
-
265
- La URL esperada será:
266
-
267
- ```text
268
- https://herrerawilliamh.github.io/NOMBRE-DEL-REPOSITORIO/
269
- ```
270
-
271
- Ejemplo:
272
-
273
- ```text
274
- https://herrerawilliamh.github.io/openclass-iot/
275
- ```
276
-
277
- ---
278
-
279
- ## 8. Flujo semanal sugerido
280
-
281
- Semana 1:
282
-
283
- ```bash
284
- npm run semana -- 1 --title "Introducción al curso"
285
- git add -A
286
- git commit -m "Agregar semana 1"
287
- git push
288
- ```
289
-
290
- Semana 2:
291
-
292
- ```bash
293
- npm run semana -- 2 --title "Tema de la semana 2"
294
- git add -A
295
- git commit -m "Agregar semana 2"
296
- git push
297
- ```
298
-
299
- Repite el proceso hasta la semana 8.
300
-
301
- ---
302
-
303
- ## 9. Comandos útiles
304
-
305
- | Comando | Uso |
306
- |---|---|
307
- | `npm run nuevo` | Configura un curso desde consola |
308
- | `npm run semana -- 1` | Genera o activa la semana 1 |
309
- | `npm run dev` | Abre el portal principal |
310
- | `npm run dev:s1` | Abre la semana 1 |
311
- | `npm run pages:check` | Revisa configuración para GitHub Pages |
312
- | `npm run pages:build` | Construye el sitio estático y exporta descargas |
313
- | `npm run pages:preview` | Previsualiza la versión publicada |
314
- | `npm run publicar` | Ejecuta exportaciones y construcción local |
315
-
316
- ---
317
-
318
- ## 10. Archivos clave
319
-
320
- ```text
321
- openclass.config.json configuración general del curso
322
- slides.md portal principal
323
- semanas/ contenido académico real
324
- scripts/decks.mjs listado de presentaciones activas
325
- .github/workflows/deploy.yml despliegue automático en GitHub Pages
326
- ```
1
+ # Open Class UNIMINUTO · Slidev
2
+
3
+ Proyecto generado con `create-openclass-uniminuto` o creado desde la plantilla `openclass-uniminuto-template`.
4
+
5
+ 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**.
6
+
7
+ ---
8
+
9
+ <<<<<<< HEAD
10
+
11
+ ## Crear el curso dentro de un repositorio ya creado en GitHub
12
+
13
+ Si primero creaste el repositorio en GitHub, clónalo y aplica la plantilla desde npm dentro de la carpeta del repositorio:
14
+
15
+ ```bash
16
+ git clone https://github.com/herrerawilliamh/openclass-iot.git
17
+ cd openclass-iot
18
+ npm create openclass-uniminuto@latest . -- --iot
19
+ npm install
20
+ npm run semana -- 1
21
+ npm run dev
22
+ ```
23
+
24
+ Si el repositorio ya tenía archivos iniciales y deseas reemplazarlos por los de la plantilla:
25
+
26
+ ```bash
27
+ npm create openclass-uniminuto@latest . -- --iot --force
28
+ ```
29
+
30
+ La sincronización con GitHub se hace después con Git:
31
+
32
+ ```bash
33
+ git add -A
34
+ git commit -m "Configura Open Class"
35
+ git push
36
+ ```
37
+
38
+
39
+ =======
40
+ >>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
41
+ ## 1. Primer uso
42
+
43
+ Instala dependencias:
44
+
45
+ ```bash
46
+ npm install
47
+ ```
48
+
49
+ Configura el curso desde consola:
50
+
51
+ ```bash
52
+ npm run nuevo
53
+ ```
54
+
55
+ Genera la primera semana:
56
+
57
+ ```bash
58
+ npm run semana -- 1
59
+ ```
60
+
61
+ Ejecuta el portal principal:
62
+
63
+ ```bash
64
+ npm run dev
65
+ ```
66
+
67
+ Una semana específica se abre con:
68
+
69
+ ```bash
70
+ npm run dev:s1
71
+ npm run dev:s2
72
+ npm run dev:s3
73
+ ```
74
+
75
+ ---
76
+
77
+ ## 2. Tres formas de crear este curso
78
+
79
+ ### Opción A · Desde npm
80
+
81
+ ```bash
82
+ npm create openclass-uniminuto@latest openclass-iot -- --iot
83
+ cd openclass-iot
84
+ npm install
85
+ npm run semana -- 1
86
+ npm run dev
87
+ ```
88
+
89
+ ### Opción B · Desde GitHub Template
90
+
91
+ 1. Entra al repositorio `openclass-uniminuto-template`.
92
+ 2. Clic en **Use this template**.
93
+ 3. Crea un repositorio nuevo, por ejemplo `openclass-iot`.
94
+ 4. Clónalo.
95
+ 5. Ejecuta los comandos del curso.
96
+
97
+ ```bash
98
+ git clone https://github.com/herrerawilliamh/openclass-iot.git
99
+ cd openclass-iot
100
+ npm install
101
+ npm run nuevo
102
+ npm run semana -- 1
103
+ npm run dev
104
+ ```
105
+
106
+ ### Opción C · Repo creado en GitHub y curso generado en local
107
+
108
+ Esta opción combina GitHub y npm.
109
+
110
+ #### Si el repositorio fue creado desde plantilla
111
+
112
+ ```bash
113
+ git clone https://github.com/herrerawilliamh/openclass-iot.git
114
+ cd openclass-iot
115
+ npm install
116
+ npm run nuevo
117
+ npm run semana -- 1
118
+ npm run dev
119
+ ```
120
+
121
+ Luego:
122
+
123
+ ```bash
124
+ git add -A
125
+ git commit -m "Generar semana 1"
126
+ git push
127
+ ```
128
+
129
+ #### Si el repositorio está vacío
130
+
131
+ ```bash
132
+ npm create openclass-uniminuto@latest openclass-iot -- --iot
133
+ cd openclass-iot
134
+ npm install
135
+ npm run semana -- 1
136
+ npm run dev
137
+ ```
138
+
139
+ Después conecta el remoto:
140
+
141
+ ```bash
142
+ git init
143
+ git branch -M main
144
+ git add -A
145
+ git commit -m "Publicación inicial Open Class"
146
+ git remote add origin https://github.com/herrerawilliamh/openclass-iot.git
147
+ git push -u origin main
148
+ ```
149
+
150
+ ---
151
+
152
+ ## 3. Generar semanas una a una
153
+
154
+ El curso siempre se organiza en **8 semanas**. Puedes generarlas progresivamente.
155
+
156
+ ```bash
157
+ npm run semana -- 1
158
+ npm run semana -- 2 --title "Título de la semana 2" --date "Junio 15 de 2026"
159
+ npm run semana -- 3 --title "Título de la semana 3" --theme "Tema central"
160
+ ```
161
+
162
+ El comando `semana` actualiza automáticamente:
163
+
164
+ ```text
165
+ openclass.config.json
166
+ slides.md
167
+ scripts/decks.mjs
168
+ package.json
169
+ curso_semanaN.md
170
+ semanas/curso_semanaN.md
171
+ ```
172
+
173
+ El contenido ya editado dentro de `semanas/*.md` se conserva. Solo se sobrescribe si usas:
174
+
175
+ ```bash
176
+ npm run semana -- 4 --force-content
177
+ ```
178
+
179
+ Para activar únicamente una semana:
180
+
181
+ ```bash
182
+ npm run semana -- 4 --only
183
+ ```
184
+
185
+ ---
186
+
187
+ ## 4. Editar contenido académico
188
+
189
+ El contenido real de cada presentación está en:
190
+
191
+ ```text
192
+ semanas/
193
+ ```
194
+
195
+ Ejemplo:
196
+
197
+ ```text
198
+ semanas/iot_semana1.md
199
+ semanas/iot_semana2.md
200
+ semanas/iot_semana3.md
201
+ ```
202
+
203
+ Los archivos de la raíz como `iot_semana1.md` funcionan como lanzadores. Normalmente no debes editarlos manualmente.
204
+
205
+ ---
206
+
207
+ ## 5. Recursos del curso
208
+
209
+ Usa estas carpetas:
210
+
211
+ ```text
212
+ public/imagenes/ imágenes del curso
213
+ public/videos/ videos y recursos audiovisuales
214
+ public/descargas/ PDF, PPTX u otros descargables
215
+ public/fondos/ fondos institucionales
216
+ ```
217
+
218
+ ---
219
+
220
+ ## 6. Construcción local
221
+
222
+ Construir el portal y las semanas activas:
223
+
224
+ ```bash
225
+ npm run pages:build
226
+ ```
227
+
228
+ Previsualizar la versión estática:
229
+
230
+ ```bash
231
+ npm run pages:preview
232
+ ```
233
+
234
+ Revisar configuración para GitHub Pages:
235
+
236
+ ```bash
237
+ npm run pages:check
238
+ ```
239
+
240
+ ---
241
+
242
+ ## 7. Publicar en GitHub Pages
243
+
244
+ Este proyecto ya incluye:
245
+
246
+ ```text
247
+ .github/workflows/deploy.yml
248
+ ```
249
+
250
+ El workflow construye el sitio y publica la carpeta `dist` en GitHub Pages.
251
+
252
+ En GitHub configura:
253
+
254
+ ```text
255
+ Settings Pages → Build and deployment → Source → GitHub Actions
256
+ ```
257
+
258
+ Luego sube cambios:
259
+
260
+ ```bash
261
+ git add -A
262
+ git commit -m "Actualizar Open Class"
263
+ git push
264
+ ```
265
+
266
+ Cada `push` a `main` construirá y publicará el sitio automáticamente.
267
+
268
+ La URL esperada será:
269
+
270
+ ```text
271
+ https://herrerawilliamh.github.io/NOMBRE-DEL-REPOSITORIO/
272
+ ```
273
+
274
+ Ejemplo:
275
+
276
+ ```text
277
+ https://herrerawilliamh.github.io/openclass-iot/
278
+ ```
279
+
280
+ ---
281
+
282
+ ## 8. Flujo semanal sugerido
283
+
284
+ Semana 1:
285
+
286
+ ```bash
287
+ npm run semana -- 1 --title "Introducción al curso"
288
+ git add -A
289
+ git commit -m "Agregar semana 1"
290
+ git push
291
+ ```
292
+
293
+ Semana 2:
294
+
295
+ ```bash
296
+ npm run semana -- 2 --title "Tema de la semana 2"
297
+ git add -A
298
+ git commit -m "Agregar semana 2"
299
+ git push
300
+ ```
301
+
302
+ Repite el proceso hasta la semana 8.
303
+
304
+ ---
305
+
306
+ ## 9. Comandos útiles
307
+
308
+ | Comando | Uso |
309
+ |---|---|
310
+ | `npm run nuevo` | Configura un curso desde consola |
311
+ | `npm run semana -- 1` | Genera o activa la semana 1 |
312
+ | `npm run dev` | Abre el portal principal |
313
+ | `npm run dev:s1` | Abre la semana 1 |
314
+ | `npm run pages:check` | Revisa configuración para GitHub Pages |
315
+ | `npm run pages:build` | Construye el sitio estático y exporta descargas |
316
+ | `npm run pages:preview` | Previsualiza la versión publicada |
317
+ | `npm run publicar` | Ejecuta exportaciones y construcción local |
318
+
319
+ ---
320
+
321
+ ## 10. Archivos clave
322
+
323
+ ```text
324
+ openclass.config.json configuración general del curso
325
+ slides.md portal principal
326
+ semanas/ contenido académico real
327
+ scripts/decks.mjs listado de presentaciones activas
328
+ .github/workflows/deploy.yml despliegue automático en GitHub Pages
329
+ ```