Widgets: fichas de referencia

Las 23 páginas del espacio Widget: guardan el código de cada widget. Lo que se ve de ellas, la documentación, está escrito con pasos, tablas y avisos mezclados, y casi todas se presentan como «Tutorial» aunque no lo son. Esta propuesta ordena qué queda en cada página Widget: y dónde va el resto.

1. La regla

Una página Widget: es una referencia y nada más. Dice qué hace el widget, cómo se escribe y qué parámetros acepta, con un ejemplo que funciona. Los pasos para lograr algo (obtener el ID, publicar el archivo, insertar el widget) viven en la guía de su tarea. Lo que se aprende haciendo vive en un tutorial.

Necesidad de la persona	Dónde se resuelve	Modo
«¿Cómo muestro un video en mi página?»	Guía por tarea: 13, 42, 12 o F18	Resolver
«¿Qué parámetros acepta YouTube?»	Ficha `Widget:YouTube`	Consultar
«Quiero aprender a programar un sketch en la wiki»	Tutorial F19	Aprender
«¿Qué se puede incrustar en Casiopea?»	Catálogo en 23 Plantillas de interfaz	Consultar

Así cada página responde una sola pregunta y la misma información no se repite en dos lugares.

2. La ficha de cada widget

Todas las páginas Widget: usan la misma estructura, dentro de <noinclude>, para que el texto nunca afecte al código. La estructura la pone una plantilla: quien documenta solo llena los campos.

Sección	Qué contiene	Obligatoria
Qué hace	Una o dos frases: qué muestra y de qué servicio viene	Sí
Sintaxis	La forma mínima y la forma con todos los parámetros	Sí
Parámetros	Tabla: parámetro, obligatorio, valores aceptados, valor por omisión	Sí
Ejemplo	Un solo ejemplo que funcione en la página, distinto de la sintaxis	Sí
Requisitos y privacidad	Lo que hay que hacer en el servicio (publicar, compartir) y qué se vuelve visible	Si aplica
Cómo usarlo	Enlace a la guía de su tarea y, si existe, al tutorial	Sí
Relacionados	Otros widgets que resuelven algo parecido	No

Ficha en la cabecera: Tipo Referencia, Para quién, Nivel, Estado (vigente, por verificar u obsoleto) y fecha de verificación.

Categorías: Widgets y una sola categoría de tarea, de una lista cerrada que se crea una vez: Video y audio, Código y visualización, 3D, Documentos y presentaciones, Datos y formularios, Galerías, Mapas, Componentes internos.

Wikitexto propuesto (ejemplo con YouTube)

<noinclude>{{Ficha de widget
|qué hace=Muestra un video o una lista de reproducción de YouTube, al ancho de la página.
|sintaxis={{#widget:YouTube|id=ID_DEL_VIDEO}}
|sintaxis completa={{#widget:YouTube|id=ID_DEL_VIDEO|start=30}}
|parámetros=
{{Ficha de widget/Parámetro|nombre=id|obligatorio=sí, si no hay playlist|valores=ID del video|omisión=}}
{{Ficha de widget/Parámetro|nombre=playlist|obligatorio=sí, si no hay id|valores=ID de la lista|omisión=}}
{{Ficha de widget/Parámetro|nombre=start|obligatorio=no|valores=segundos|omisión=0}}
|ejemplo={{#widget:YouTube|id=ID_DE_EJEMPLO}}
|guía=Ayuda:Incrustar video, audio, código y 3D
|relacionados=Widget:Vimeo
|para quién=Alumno, Profesor
|estado=vigente
|verificado=2026-10
|categoría=Video y audio
}}</noinclude><includeonly>…código del widget, sin cambios…</includeonly>

3. Cómo se comportan de ahora en adelante

El código no se toca para documentar. Toda la documentación va en <noinclude> con la plantilla. Si una página está protegida, la ficha se propone en su página de discusión y la aplica la administración.
Sin pasos en la ficha. Si hace falta explicar cómo obtener un ID, se escribe en la guía de la tarea y la ficha enlaza ahí.
Un widget nuevo entra con su ficha. No aparece en una guía ni en el catálogo hasta tener ficha completa y un ejemplo que funcione.
Los widgets de prueba no van a Categoría:Widgets. Se prueban fuera de la categoría y con un nombre que lo diga.
Un widget que deja de funcionar se marca obsoleto. La ficha queda con estado obsoleto, sale de las guías y del catálogo, y se informa para retirarlo.
Cada ficha se verifica una vez al semestre. Se prueba el ejemplo y se actualiza la fecha de verificación.

4. Las 23 páginas y su destino

Widget	Hoy	Ficha	Su guía	Qué se corrige
YouTube	Guía + tabla	Reescribir	13	Ejemplo con un ID distinto al de la sintaxis; decir si playlist es obligatorio
Vimeo	Guía + tabla	Reescribir	13	`&` en las URL; parámetros de la URL sin explicar
SoundCloud	Guía + tabla	Reescribir	13	Cinco parámetros de la URL sin documentar
P5	Referencia + avisos	Reescribir	13 · tutorial F19	La solución 2 usa el mismo `\|\|` que dice que no funciona; ejemplo vacío; se rotula Tutorial
P5js	Guía + tabla	Reescribir	13 · tutorial F19	Solo categorías inexistentes
P5m	Referencia + avisos	Reescribir	13 · tutorial F19	`use_sound` no está en la sintaxis; ejemplos sin contenido visible
Matter	Explicación breve	Reescribir	13	Dice «modelos 3D» y es física 2D; categoría 3D (ya en R-13)
PiX	Guía + tabla	Reescribir	13	El ejemplo de `data` está cortado y no se puede copiar
Sketchfab	Guía + tabla	Reescribir	13	Los dos ejemplos son iguales
F3D	Referencia + guía	Reescribir	13	Ejemplo 2 vacío; sin categorías; comentarios dentro de la sintaxis
Google Document	Guía + nota técnica	Reescribir	42	Sin obligatorios ni valores por omisión; la nota técnica va a administración; falta aviso de privacidad
Google Presentation	Guía + tabla	Reescribir	42	La tabla dice `delay` y el ejemplo `delayms`; verificar si start, loop y delay funcionan
Google Spreadsheet	Guía + tabla	Reescribir	42	Los dos ejemplos son la misma hoja; falta aviso de privacidad
Google Form	Guía + tabla	Reescribir	42	Enlace roto en el paso 1; valores por omisión distintos de los del ejemplo
SlideShare	Guía + tabla	Reescribir	42	Ejemplos sin explicar; la tabla pone «Obligatorio» como valor por omisión
Figma	Guía + tabla	Reescribir	42	`page-id` sin explicar; `&` en las URL
FlickrSetShow	Referencia extensa	Ajustar	12 · tutorial F20	Falta el valor por omisión de `set_id` y `height`
JsonLD	Referencia	Ajustar	Ninguna (lo usan las plantillas)	Completar la firma con todos sus parámetros
Google Calendar	Heredada, en inglés	Verificar	42 si funciona	Parámetros sin explicar (ya en R-14)
Scribd	Heredada, en inglés	Verificar	42 si funciona	Sin documentación ni categorías (ya en R-14)
Google Maps	Heredada, en inglés	Verificar	F18 si funciona	Sin sintaxis; la API de Google exige clave (ya en R-14)
Google Street View	Heredada, en inglés	Verificar	F18 si funciona	Igual que Google Maps (ya en R-14)
FlickrSetShowTest	Prueba	Sacar de la categoría	Ninguna	Aparece junto a los widgets en uso (D-17)

Problemas que comparten todas las fichas nuevas y se resuelven con la plantilla: el rótulo «Tipo: Tutorial», trece categorías que no existen, la falta de una columna «Obligatorio» y el aviso de Stella Nova de julio, que ya quedó desactualizado.

5. Tutoriales que salen de los widgets

Tutorial	Widgets	Por qué
F19 Ayuda:Tu primer sketch en Casiopea	P5, P5m, P5js	La documentación de P5m ya avanza por ejemplos (círculos, estrellas, flores, partículas). Un tutorial lleva de un sketch mínimo a uno animado, con un resultado visible en la página
F20 Ayuda:Arma una galería con tus fotos de Flickr	FlickrSetShow	La ficha ya va de lo simple a lo complejo: grilla, carrusel, presentación. Un tutorial lo convierte en un recorrido con una galería real al final

6. Borradores

Las 23 fichas están escritas en borrador con esta estructura (9 de octubre de 2026). En el prototipo son las páginas Widget:, enlazadas desde el catálogo de cada guía; no aparecen en las listas de Ayuda:Portada porque son referencia, no puertas de entrada. Cada una trae su lista de puntos por verificar en la wiki antes de reemplazar el <noinclude> actual.

7. El árbol

La rama de widgets está en el árbol completo, bajo «Fichas de widget». Cada ficha cuelga de la guía de su tarea.