Includi Discourse-math cotto nella visualizzazione di stampa e nelle email

Funzionalità
, ,
1

Problema
Discourse-math viene visualizzato magnificamente nel browser, ma nei contesti in cui JavaScript non può essere eseguito, la matematica viene visualizzata come sorgente LaTeX grezza. Due casi ad alto impatto:

  • Vista di stampa (/print o browser stampa su PDF): la matematica viene visualizzata come $...$ invece di simboli renderizzati.
  • Email (digest, notifiche, abbonamenti): la matematica viene inviata grezza, illeggibile ai destinatari a meno che non copino e incollino in un editor LaTeX.

Ciò interrompe importanti flussi di lavoro per le community che si affidano a Discourse per contenuti tecnici.

Perché è importante

  • Educatori e ricercatori STEM spesso hanno bisogno di stampare argomenti o inoltrare email. Se la matematica non è leggibile, tali esportazioni sono inutilizzabili.
  • Altre lacune nella stampa/email (spoiler, onebox, immagini) sono state risolte: la matematica è un’omissione lampante.
  • Supportare la matematica “cucinata” (cooked) in contesti non-JS renderebbe Discourse una piattaforma di prima classe per le community tecniche.

Soluzione proposta

  • Passaggio leggero (stampa):
    • Assicurarsi che la vista /print includa l’HTML della matematica “cucinata”.
    • Attivare la composizione tipografica di MathJax prima della stampa.
  • Passaggio più pesante (email):
    • Esplorare il rendering di MathJax lato server, come suggerito da Sam.
    • Renderizzare la matematica in SVG o HTML pre-cucinato in modo che i destinatari vedano equazioni leggibili direttamente nei client di posta elettronica.
  • Impostazione del sito opzionale:
    • “Usa matematica cucinata in vista di stampa/email” → consente agli amministratori di scegliere tra sorgente grezza o matematica renderizzata.

Problemi correlati / lavori precedenti

  • :white_check_mark: La matematica all’interno dei riquadri [details] è stata corretta (PR #111, giugno 2025).
  • :memo: La vista di stampa aveva già correzioni per spoiler/onebox → precedente per l’inclusione di elementi “cucinati”.
  • :e_mail: Email: il commento di Sam (#214) ha identificato il rendering lato server come la soluzione a lungo termine.

Riepilogo / TL;DR
Al momento, la matematica nella vista di stampa e nelle email viene visualizzata come LaTeX grezza. L’aggiunta del rendering della matematica “cucinata” renderebbe i PDF e i digest leggibili, professionali e coerenti con ciò che gli utenti vedono nel browser.

Riproduci su Discourse con Safari su iOS

Anche quando Richiedi sito desktop è abilitato in Safari, Discourse aggiunge ancora
?mobile_view=1 quando si apre /print, il che forza la vista di stampa mobile semplificata.

Soluzione: cambiare manualmente in ?mobile_view=0 per il layout di stampa desktop completo.

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

3 Mi Piace