Saltar al contenido
Ayudas Casiopea proyecto · Stella Nova v0.9.0
Tema
Tamaño de letra
Familia
Ver prototipo

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: marked para el Markdown y js-yaml para 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.