Skip to content

Metadata: migrar contenido HTML inline de Glosario y Definiciones a archivos .md/.qmd #42

Description

@pablotis

Contexto

Hoy el contenido de Glosario y Definiciones vive como HTML inline dentro de `R/panels_metadata.R` (~180 líneas, mayormente texto y `tags$p`/`tags$ul`). El comentario en el archivo ya anticipa esto:

Si crece el contenido, evaluar moverlo a archivos .qmd/.md y cargarlos con `includeMarkdown()`.

El contenido ya es extenso (especialmente la sección "Intervención INDEC 2007-2015" y "Limitaciones del panel") y va a seguir creciendo a medida que sumemos análisis (pobreza, filtros sociodemográficos, etc.).

Objetivo

Extraer el contenido a archivos separados, mantenibles sin tocar R:

  • `R/contenido_metadata/glosario_intro.md`
  • `R/contenido_metadata/definiciones.md` (o quizás varios: `definiciones_panel.md`, `definiciones_intervencion_indec.md`, `definiciones_limitaciones.md`)
  • `R/panels_metadata.R` se reduce a la lógica de carga (`shiny::includeMarkdown()` o `htmltools::HTML(rmarkdown::render(...))`) + el `gt` de la tabla del Glosario.

Beneficios

  • El contenido lo puede editar cualquiera (incluso sin saber R) abriendo el .md.
  • El diff de un cambio de redacción no se mezcla con cambios de UI.
  • Permite incorporar formato Markdown más cómodo (listas anidadas, citas, code blocks) sin pelear con `tags$$`.
  • Habilita en el futuro reutilizar fragmentos en blog/Quarto.

Decisiones a tomar

  1. Formato: ¿`.md` plano o `.qmd` con eventuales chunks de R? Para texto puro, `.md` con `shiny::includeMarkdown()` alcanza.
  2. Granularidad: ¿un solo archivo por nav_panel, o partir en subsecciones (más fácil de editar)?
  3. Renderizado: `includeMarkdown()` lee del filesystem en cada sesión (overhead chico). Alternativa: pre-renderizar a HTML en build time si hay performance issue (no creo).
  4. Glosario: la tabla sigue como `tibble` + `gt` en R porque es estructurada. Solo la intro y la nota se mueven a md.

Criterios de aceptación

  • Glosario y Definiciones sirven el mismo contenido visible que hoy.
  • El contenido de texto vive en archivos .md fuera de R/panels_metadata.R.
  • La tabla del Glosario sigue siendo un `gt` desde R.
  • Los links externos siguen abriendo en nueva pestaña.

Prioridad

Baja. Funcionalidad cero, mejora de mantenibilidad. Hacer cuando se planee sumar bastante contenido más (por ejemplo al cerrar #29 o #30).

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions