ADR 0004: Desacople de Capa de Estilos y Contenido en Markdown

Estado

Aceptado

Fecha

2026-09-27

Contexto

Uno de los principales problemas al mantener o forquear portales web de datos abiertos es el acoplamiento entre el código fuente de los componentes visuales (HTML/JSX/Astro) y el contenido textual o institucional.

Cuando los usuarios o administradores desean cambiar textos explicativos, descripciones o la paleta de colores institucional, se ven obligados a alterar la lógica del template o componentes de interfaz, lo que incrementa el riesgo de introducir errores de sintaxis y dificulta las actualizaciones de la plantilla base.

Decisión

1. Contenido 100% en Markdown: Los textos de las páginas principales (/, /about, /download) residen en archivos Markdown con Frontmatter YAML en la carpeta content/pages/ (home.md, about.md, download.md).

2. Tokens de Diseño en src/styles/theme.css: Toda la identidad visual (colores institucionales, fuentes, radios de curvatura, sombras) se declara como variables semánticas en un único archivo CSS.

3. Parámetros Globales en portal.config.ts: Título, URL de la organización, repositorios y DOI del Whitepaper se centralizan en una configuración declarativa tipada.

Consecuencias

• Un usuario no técnico o un nuevo mantenedor puede actualizar textos editando simplemente un archivo .md.
• Una nueva institución puede personalizar toda la apariencia del portal cambiando únicamente las variables CSS en theme.css.
• Los componentes de interfaz (.astro) se mantienen libres de textos duros y son 100% reutilizables.