Study Site
Construye páginas de estudio HTML interactivas y autocontenidas, publicadas como artefactos (o guardadas como archivos .html cuando los artefactos no están disponibles). Cada página comienza desde assets/template.html, por lo que las características estándar nunca se olvidan.
0. Ajustes — edítalos para ti
| Ajuste | Valor |
|---|---|
| URL del índice maestro (hub que enlaza todos los cursos) | none — defínelo con la URL de tu hub, o deja none para omitir las actualizaciones del índice |
| Tema predeterminado | light (siempre se incluye un alternador de modo oscuro) |
| Navegación de capítulos | Solo enlace de vuelta al índice del curso — sin enlaces de capítulo anterior/siguiente |
| Estilo de tarjeta de índice | Mínimo: icono, código del curso, nombre del curso — sin estadísticas |
1. Preguntar primero (una ronda de preguntas)
Pregunta solo lo que no esté claro desde la solicitud:
- ¿Es para un curso? Si es así: ¿qué curso, qué capítulo o fragmento? Una página de curso obtiene modo examen y herramientas de revisión además de las funciones estándar; una página que no es de curso (tema general, explicación única) los omite.
- ¿Dónde debe listarse? Directamente en el índice maestro, dentro de un índice de estudio del curso (¿cuál?), o en ningún lado. Omite esta pregunta si el ajuste del índice maestro es
none. - Si la URL del índice de estudio del curso no se conoce, pregúntala — el enlace de vuelta de la página la necesita.
Si el usuario ha guardado notas sobre cómo quiere que se enseñe un curso (memoria, instrucciones del proyecto, mensajes anteriores), léelas y síguelas por encima de los valores predeterminados a continuación.
2. Recopilar material antes de construir
- Lee cada archivo adjunto por completo: diapositivas, apuntes, exámenes anteriores, hojas de ejercicios.
- Recopila las preguntas de años anteriores (PYQs) y preguntas de ejercicios pertenecientes a cada tema.
- Corrige silenciosamente los errores en el material fuente; no los señales a menos que te lo pidan.
- Solo entonces planifica la lista de temas: una
<section class="topic">por tema lógico, lo suficientemente pequeño para terminarlo en una sola sesión.
3. Reglas de enseñanza (todas las asignaturas)
- No asumas conocimientos previos. Construye desde lo básico, define cada término en su primer uso, elabora en lugar de comprimir.
- Orden dentro de cada tema: explicación → su diagrama inmediatamente después → explicación del diagrama → ejemplo resuelto → PYQs/preguntas de ejercicios → preguntas de opción múltiple de práctica. Nunca agrupes los diagramas al final.
- Cada diagrama recibe una explicación. Nunca publiques un diagrama sin explicación.
- Marca los puntos importantes para el examen con
.callout.impy las trampas comunes con.callout.mistake. - Preguntas: escribe cada pregunta completa antes de su solución, nunca condensada. Responde todas las preguntas; no dejes ninguna sin responder. Etiqueta las PYQs con fuente, año y puntuación (ej.
PYQ 2024 Parcial · 5M). - Al menos 3 preguntas de opción múltiple de práctica por tema, con distractores plausibles y una explicación
.why. - Los diagramas son SVG en línea, nunca ASCII. Usa un
.stepper(unfigure.fig.steppor estado) para cualquier cosa que evolucione paso a paso. - No incluyas planes de estudio o calendarios a menos que se te pida.
4. Adaptar por asignatura
| Tipo de asignatura | Énfasis |
|---|---|
| Teoría / demostraciones (teoría de la computación, matemáticas discretas, algoritmos) | Diagramas de estado para cada autómata; steppers que recorren cadenas de entrada; plantillas de demostración (pumping lemma, reducciones, inducción) como pasos para rellenar; muchos ejemplos pequeños |
| Sistemas (sistemas operativos, arquitectura de computadores, redes) | Visual primero; steppers para pipelines, diagramas de Gantt de planificación, reemplazo de páginas, búsquedas en caché; ejercicios numéricos resueltos paso a paso; ejercicios de final de capítulo del libro de texto |
| Lenguajes / notación formal (lenguajes de programación, compiladores) | BNF/EBNF, árboles de análisis sintáctico y gramáticas de atributos como árboles SVG limpios; expresiones regulares construidas pieza por pieza; preguntas de ejercicios resueltas en línea |
| Matemáticas intensivas (aprendizaje automático, estadística, señales) | Intuición primero, luego la derivación línea por línea con cada paso justificado; gráficos en SVG; ejercicios resueltos del libro de texto |
| Descriptiva (biología, administración, humanidades) | Impulsado por exámenes anteriores: agrupar PYQs por tema, respuestas modelo con la extensión del examen, diagramas de flujo y tablas comparativas para procesos |
Elige la fila más cercana para una asignatura no listada. Los propios apuntes del curso del usuario anulan esta tabla.
5. Funciones de la página (integradas en la plantilla)
| Función | Cómo funciona | Tu trabajo |
|---|---|---|
| Tema claro + alternador oscuro | Claro por defecto; 🌙 alterna; la elección se recuerda | Usa solo las variables CSS — sin colores fijos |
| Restaurar desplazamiento | La posición se guarda y restaura al reabrir | Nada |
| Seguimiento de progreso | "Marcar como hecho" por tema, barra de progreso, ✓ en el índice | id único en cada sección de tema |
| Búsqueda | Filtra temas y resalta coincidencias | Nada |
| Copiar imagen | Botón al pasar el ratón sobre cada figure.fig que copia un PNG (siempre visible en táctil) | Envuelve cada diagrama o imagen en figure.fig |
| Amigable para móviles | Responsivo; las tablas se desplazan lateralmente | Mantén los SVG basados en viewBox; sin anchos fijos |
| MCQs de práctica | Retroalimentación instantánea; las respuestas se recuerdan | data-answer = índice basado en 0 de la opción correcta |
| Mostrar respuesta | details.answer | Usa para cada solución larga |
| Enlace de vuelta | El encabezado enlaza al índice de estudio del curso | Rellena {{COURSE_INDEX_URL}} |
| Solo páginas de curso: herramientas de revisión | Chuleta (.cheatsheet) + flashcards (.flashdeck) | Resumen de una página de fórmulas, definiciones, diagramas clave; 10+ flashcards |
| Solo páginas de curso: modo examen | Difuminado hasta que se inicia; temporizador; los MCQs se califican al enviar; respuestas modelo reveladas | Mezcla MCQs (data-marks) y preguntas largas con el estilo de los exámenes anteriores del curso; establece data-minutes |
El progreso y las puntuaciones viven en el navegador del espectador, por página — una página de índice no puede mostrar el progreso del capítulo y nada se sincroniza entre dispositivos.
6. Reglas de diseño
- Mínimo y tranquilo. Cuerpo con serifa para lectura larga, interfaz sin serifa. Ancho de contenido ~820px.
- Evita el "slop" de IA: sin degradados morados, banners de héroe, diseños centrados en todo, Inter o confeti de emojis.
- El color tiene significado: azul = información, dorado = importante para el examen, rojo = error, verde = correcto/hecho.
- Diagramas SVG: etiqueta todo; usa
var(--text),var(--accent), etc. para trazos y rellenos; texto ≥12px en ancho de móvil.
7. Páginas de índice de estudio del curso
Para un índice o hub de curso: tarjetas mínimas (ver ajustes), mismo encabezado (búsqueda + alternador de tema), restaurar desplazamiento, luz por defecto.
8. Construir, publicar, verificar
- Copia
assets/template.html, rellena los{{placeholders}}, elimina los bloques solo de curso para páginas que no son de curso (o descoméntalos para páginas de curso). - Publica como artefacto (o guarda el
.html). Muéstralo primero; verifica después. - Verifica en escritorio y aproximadamente 390px de ancho, en ambos temas: cada figura tiene un botón de copia, cada MCQ tiene un
data-answercorrecto, cada pregunta tiene una respuesta, no quedan{{placeholders}}. - Agrega el enlace de la página al índice maestro o del curso según lo elegido en el paso 1. No rediseñes el índice.