Incluir Discourse-math cozido na visualização de impressão e e-mails

Funcionalidade
, ,
1

Problema
O Discourse-math é renderizado de forma excelente no navegador, mas em contextos onde o JavaScript não pode ser executado, a matemática volta à fonte LaTeX bruta. Dois casos de alto impacto:
\n

  • Visualização de impressão (/print ou navegador imprimir para PDF): a matemática aparece como $...$ em vez de símbolos renderizados.
  • E-mails (resumos, notificações, assinaturas): a matemática é entregue bruta, ilegível para os destinatários, a menos que eles copiem e colem em um editor LaTeX.
    \n
    Isso quebra fluxos de trabalho importantes para comunidades que dependem do Discourse para conteúdo técnico.
    \n
    —\n
    \nPor que importa
  • Educadores e pesquisadores de STEM frequentemente precisam imprimir tópicos ou encaminhar e-mails. Se a matemática não for legível, essas exportações são inutilizáveis.
  • Outras lacunas em impressão/e-mails (spoilers, oneboxes, imagens) foram corrigidas — a matemática é uma omissão gritante.
  • Suportar matemática “cozida” em contextos sem JS tornaria o Discourse uma plataforma de primeira classe para comunidades técnicas.
    \n
    —\n
    \nSolução proposta
  • Etapa leve (impressão):
    • Garantir que a visualização /print inclua o HTML da matemática “cozida”.
    • Acionar a composição do MathJax antes da impressão.
  • Etapa mais pesada (e-mails):
    • Explorar a renderização do MathJax no lado do servidor, como sugerido por Sam.
    • Renderizar a matemática para SVG ou HTML pré-cozido para que os destinatários vejam equações legíveis diretamente nos clientes de e-mail.
  • Configuração de site opcional:
    • “Usar matemática cozida em visualização de impressão/e-mails” → permite que os administradores escolham entre fonte bruta vs. matemática renderizada.
      \n
      —\n
      \nProblemas relacionados / trabalho anterior
  • :white_check_mark: Matemática dentro de painéis [details] corrigida (PR #111, junho de 2025).
  • :memo: A visualização de impressão já tinha correções para spoilers/oneboxes → precedente para incluir elementos cozidos.
  • :e_mail: E-mails: O comentário de Sam (#214) identificou a renderização no lado do servidor como a solução de longo prazo.
    \n
    —\n
    \nResumo / TL;DR
    No momento, a matemática na visualização de impressão e nos e-mails volta à fonte LaTeX bruta. Adicionar a renderização de matemática cozida tornaria os PDFs e resumos legíveis, profissionais e consistentes com o que os usuários veem no navegador.
    \n
Reproduzir no Discourse com Safari no iOS

Mesmo quando Solicitar Site para Computador está ativado no Safari, o Discourse ainda anexa
?mobile_view=1 ao abrir /print, o que força a visualização de impressão móvel simplificada.
\n
Solução alternativa: altere manualmente para ?mobile_view=0 para o layout completo de impressão para desktop.
\n
Exemplo
/t/fw-the-email-subject/12345/print?mobile_view=0

3 curtidas