Inclure Discourse-math cuit dans la vue d'impression et les e-mails

Fonctionnalité
, ,
1

Problème
Discourse-math s’affiche magnifiquement dans le navigateur, mais dans les contextes où JavaScript ne peut pas s’exécuter, les mathématiques reviennent à la source LaTeX brute. Deux cas à fort impact :

  • Vue d’impression (/print ou impression du navigateur en PDF) : les mathématiques s’affichent comme $...$ au lieu de symboles rendus.
  • E-mails (résumés, notifications, abonnements) : les mathématiques sont livrées brutes, illisibles pour les destinataires, à moins qu’ils ne les copient-collent dans un éditeur LaTeX.

Cela perturbe des flux de travail importants pour les communautés qui s’appuient sur Discourse pour le contenu technique.

Pourquoi c’est important

  • Les éducateurs et chercheurs en STEM ont souvent besoin d’imprimer des sujets ou de transférer des e-mails. Si les mathématiques ne sont pas lisibles, ces exportations sont inutilisables.
  • D’autres lacunes dans l’impression/les e-mails (spoilers, oneboxes, images) ont été corrigées — les mathématiques sont une omission flagrante.
  • La prise en charge des mathématiques cuites dans les contextes sans JS ferait de Discourse une plateforme de premier plan pour les communautés techniques.

Solution proposée

  • Étape légère (impression) :
    • Assurez-vous que la vue /print inclut le HTML des mathématiques cuites.
    • Déclenchez la composition MathJax avant l’impression.
  • Étape plus lourde (e-mails) :
    • Explorez le rendu MathJax côté serveur, comme suggéré par Sam.
    • Rendez les mathématiques en SVG ou en HTML pré-cuit afin que les destinataires voient des équations lisibles directement dans les clients de messagerie.
  • Paramètre de site optionnel :
    • « Utiliser les mathématiques cuites dans la vue d’impression/les e-mails » → permet aux administrateurs de choisir entre la source brute et les mathématiques rendues.

Problèmes connexes / travaux antérieurs

  • :white_check_mark: Les mathématiques à l’intérieur des volets [details] ont été corrigées (PR #111, juin 2025).
  • :memo: La vue d’impression avait déjà des corrections pour les spoilers/oneboxes → précédent pour inclure des éléments cuits.
  • :e_mail: E-mails : le commentaire de Sam (#214) a identifié le rendu côté serveur comme la solution à long terme.

Résumé / TL;DR
Actuellement, les mathématiques dans la vue d’impression et les e-mails reviennent à LaTeX brut. L’ajout du rendu des mathématiques cuites rendrait les PDF et les résumés lisibles, professionnels et cohérents avec ce que les utilisateurs voient dans le navigateur.

Reproduire sur Discourse avec Safari sur iOS

Même lorsque Demander le site de bureau est activé dans Safari, Discourse ajoute toujours
?mobile_view=1 lors de l’ouverture de /print, ce qui force la vue d’impression mobile simplifiée.

Solution de contournement : changer manuellement en ?mobile_view=0 pour la mise en page d’impression de bureau complète.

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

3 « J'aime »