Proyecto / Colofón
Colofón
Este sitio es, al mismo tiempo, la documentación del proyecto de rediseño de las ayudas de Casiopea y el prototipo de cómo se verían en la wiki. Diseño y desarrollo: Fauve Bellenger.
Cómo está hecho
- Sin framework. Un generador estático propio (
build.mjs, Node 24) arma todas las páginas con dos bibliotecas:markedpara el Markdown yjs-yamlpara los datos. En el navegador, todo el JavaScript es propio y sin dependencias. - Los datos son la fuente. El catálogo de ayudas (82 con estructura y 17 pendientes), las decisiones y recomendaciones, la carta Gantt, el glosario y el catálogo de contenido incrustable viven en archivos
.yml. Cambiar un dato cambia todas las páginas que lo usan. - La documentación se escribe en Obsidian. Cada nota de la carpeta
docs/marcada para publicar se convierte en una página de «Documentos», con su índice de secciones. - Dos superficies, un sitio. El prototipo reproduce la wiki con una captura de su interfaz en producción; el sitio del proyecto usa la estructura del espécimen de la skin.
- Publicación. El código está en GitHub y cada cambio en la rama principal se publica solo en Vercel. Los comentarios del prototipo son públicos: una función de Vercel guarda cada uno como un archivo en Vercel Blob.
- Funciona sin servidor. Las rutas son relativas: el sitio también se abre desde la carpeta generada, con doble clic.
Sistema de diseño
- Skin: Stella Nova v0.9.0, la skin de Casiopea, usada sin modificar. Todo lo nuevo consume sus tokens semánticos (
--sn-*); las ayudas no definen tokens propios. - Tipografía: IBM Plex Sans, IBM Plex Mono y Roboto Serif, las mismas de la skin, con licencia SIL Open Font License.
- Contenido: ordenado según Diátaxis (Aprender, Resolver, Consultar, Entender) y basado en la documentación oficial de MediaWiki 1.43, Semantic MediaWiki 6.0.1, Page Forms 6.0.5 y las extensiones instaladas en Casiopea.
Accesibilidad
- Criterios de W3C (accesibilidad, usabilidad e inclusión), NN/g y la Interaction Design Foundation, traducidos a reglas verificables (ver el espécimen).
- Objetivo WCAG 2.2 nivel AA, revisado con axe en claro y en oscuro. Se puede usar con teclado y en pantallas desde 320 px de ancho.
- Las mismas preferencias de lectura que la wiki: tema claro, oscuro o automático, tamaño de letra y familia tipográfica. Respeta movimiento reducido, más contraste y colores forzados del sistema.
- Qué funciones soporta tu navegador: ver la tabla «Este navegador» en el Resumen.