Incluir Discourse-math cocinado en la vista de impresión y correos electrónicos

Característica
, ,
1

Problema
Discourse-math se renderiza perfectamente en el navegador, pero en contextos donde JavaScript no puede ejecutarse, las matemáticas se degradan a código LaTeX sin procesar. Dos casos de alto impacto:

  • Vista de impresión (/print o navegador imprimir a PDF): las matemáticas se muestran como $...$ en lugar de símbolos renderizados.
  • Correos electrónicos (resúmenes, notificaciones, suscripciones): las matemáticas se entregan sin procesar, ilegibles para los destinatarios a menos que copien y peguen en un editor de LaTeX.

Esto interrumpe flujos de trabajo importantes para las comunidades que dependen de Discourse para contenido técnico.

Por qué importa

  • Los educadores e investigadores de STEM a menudo necesitan imprimir temas o reenviar correos electrónicos. Si las matemáticas no son legibles, esas exportaciones no se pueden utilizar.
  • Otras lagunas en la impresión/correos electrónicos (spoilers, oneboxes, imágenes) se han solucionado; las matemáticas son una omisión flagrante.
  • El soporte para matemáticas cocinadas en contextos sin JS haría de Discourse una plataforma de primera clase para comunidades técnicas.

Solución propuesta

  • Paso ligero (impresión):
    • Asegurar que la vista /print incluya HTML de matemáticas cocinadas.
    • Activar la composición de MathJax antes de imprimir.
  • Paso más pesado (correos electrónicos):
    • Explorar la renderización de MathJax en el lado del servidor, como sugirió Sam.
    • Renderizar las matemáticas a SVG o HTML pre-cocinado para que los destinatarios vean ecuaciones legibles directamente en los clientes de correo electrónico.
  • Configuración opcional del sitio:
    • “Usar matemáticas cocinadas en vista de impresión/correos electrónicos” → permite a los administradores elegir entre código fuente sin procesar o matemáticas renderizadas.

Problemas relacionados / trabajo previo

  • :white_check_mark: Se solucionaron las matemáticas dentro de los paneles [details] (PR #111, junio de 2025).
  • :memo: La vista de impresión ya tenía correcciones para spoilers/oneboxes → precedente para incluir elementos cocinados.
  • :e_mail: Correos electrónicos: El comentario de Sam (#214) identificó la renderización en el lado del servidor como la solución a largo plazo.

Resumen / TL;DR
En este momento, las matemáticas en la vista de impresión y en los correos electrónicos se degradan a LaTeX sin procesar. Agregar la renderización de matemáticas cocinadas haría que los PDF y los resúmenes fueran legibles, profesionales y consistentes con lo que los usuarios ven en el navegador.

Reproducir en Discourse con Safari en iOS

Incluso cuando Solicitar sitio de escritorio está habilitado en Safari, Discourse todavía agrega
?mobile_view=1 al abrir /print, lo que fuerza la vista de impresión móvil simplificada.

Solución: cambie manualmente a ?mobile_view=0 para obtener el diseño de impresión de escritorio completo.

Ejemplo
/t/fw-the-email-subject/12345/print?mobile_view=0

3 Me gusta