Discours Math

:discourse2: Résumé Discourse Math utilise MathJax (par défaut) ou KaTeX pour afficher les formules mathématiques dans votre forum Discourse.
:open_book: Guide d’installation Ce plugin est intégré au cœur de Discourse. Il n’est pas nécessaire d’installer le plugin séparément.

Activation des mathématiques

Le plugin Math peut être activé depuis ses paramètres, accessibles depuis votre page admin/plugins :

Paramètres des mathématiques

Fonctionnalités

Une fois activé, vous pouvez afficher des formules en ligne en les entourant d’un seul $ comme ceci : $E=mc^2$.

Vous pouvez afficher des blocs de formules en les entourant de $$

$$
\sqrt{(-1)} \; 2^3 \; \sum \; \pi
$$

Discourse Math utilise une heuristique pour s’assurer que des phrases telles que : “J’ai dépensé 20$ et un autre 100$” ne soient pas converties.

Délimiteurs LaTeX

Lorsqu’ils sont activés via les paramètres du site, vous pouvez également utiliser les délimiteurs LaTeX standard :

  • En ligne : \(...\) - Exemple : \(E=mc^2\)
  • Bloc : \[...\] - Exemple :
    \[
    \frac{1}{2}
    \]
    

AsciiMath (MathJax uniquement)

Lors de l’utilisation de MathJax, vous pouvez activer le traitement asciimath qui utilise % comme délimiteur : %E=mc^2%

Intégration au rédacteur

Le rédacteur inclut un bouton Insérer des mathématiques dans la barre d’outils avec le raccourci clavier Shift+M. Cela ouvre une fenêtre modale où vous pouvez :

  • Basculer entre le mode en ligne et le mode bloc
  • Écrire votre expression LaTeX
  • Prévisualiser et insérer dans votre message

Dans l’éditeur de texte enrichi, les expressions mathématiques apparaissent sous forme de nœuds éditables avec un bouton modifier pour changer l’expression.

Support dans le Chat

Les expressions mathématiques sont également affichées dans les messages du Chat Discourse en utilisant les mêmes paramètres et moteur de rendu.

Moteurs de rendu

MathJax (Par défaut)

  • Version : 4.1
  • Formats de sortie : HTML (par défaut) ou SVG
  • Fonctionnalités :
    • Menu contextuel (clic droit sur une formule)
    • Enrichissement d’accessibilité pour les lecteurs d’écran
    • Zoom au clic avec la touche Alt (zoom à 175 %)
    • Support AsciiMath

KaTeX (Alternative)

  • Fonctionnalités :
    • Rendu rapide
    • Extension Mhchem pour les équations chimiques
    • Extension CopyTex - cliquez sur une formule pour copier la source LaTeX dans le presse-papiers
    • Support des références croisées avec les macros \label, \ref et \eqref

Paramètres du site

Consultez tous les paramètres du site pertinents en recherchant “math” dans vos paramètres d’administration.

Nom Description
discourse math enabled Activer le plugin Discourse Math (ajoute un traitement spécial aux blocs $ et $$)
discourse math provider Fournisseur de rendu mathématique : mathjax (par défaut) ou katex
discourse math enable latex delimiters Activer les délimiteurs de style LaTeX : \(...\) pour le math en ligne et \[...\] pour le math en bloc
discourse math mathjax output Format de sortie MathJax : html (par défaut) ou svg (MathJax uniquement)
discourse math enable menu Activer le menu contextuel pour les expressions mathématiques (MathJax uniquement)
discourse math enable accessibility Activer les fonctionnalités d’accessibilité comme l’enrichissement de texte (MathJax avec menu uniquement)
discourse math zoom on click Zoom 175 % lors de l’interaction clic avec Alt (MathJax avec menu uniquement)
discourse math enable asciimath Activer le traitement asciimath avec le délimiteur % (MathJax uniquement)

:discourse2: Hébergé par nous ? Ce plugin est disponible sur tous nos plans d’hébergement Math | Discourse - Civilized Discussion

70 « J'aime »

2 messages ont été déplacés vers un nouveau sujet : Ajouter la prise en charge du formatage d’e-mail de MathJax

2 publications ont été divisées dans un nouveau sujet : Mathjax peut-il être mis à jour vers la version 3 ?

6 messages ont été déplacés vers un nouveau sujet : Ajouter la prise en charge des blocs et des lignes de style Latex pour les maths

Un message a été divisé dans un nouveau sujet : Les équations ne s’affichent pas correctement dans les blocs

Un message a été divisé dans un nouveau sujet : Les maths ne s’affichent pas dans l’aperçu

15 messages ont été déplacés vers un nouveau sujet : Math and AI workarounds

26 messages ont été déplacés vers un nouveau sujet : Mise à niveau de MathJax vers la version 4

Juste une note rapide (positive) tirée de l’expérience réelle après être passé à l’intégration plus récente de MathJax (v4.1) dans Discourse Math.

Une amélioration de la qualité de vie que j’ai remarquée est que MathJax fournit désormais un retour d’information très spécifique et localisé lorsque l’entrée est invalide ou qu’une macro n’est pas définie :

  • Il continue de rendre correctement la structure valide environnante (par exemple, \\frac{...}{...}, les parenthèses, etc.)
  • Mais il laisse la commande non reconnue visible littéralement (par exemple, affichant \\sinc comme texte) au lieu d’échouer sur toute l’expression ou de produire une erreur partielle déroutante.

En pratique, cela rend immédiatement évident ce qui doit être corrigé, sans masquer ce qui est déjà correct — ce qui est particulièrement utile dans les contextes d’enseignement et lors de l’itération sur des publications riches en mathématiques.

Par exemple, au lieu de s’appuyer sur la définition de \\sinc, l’approche robuste consiste à l’écrire explicitement comme un opérateur :

\n\\frac{\\Delta}{T}\\operatorname{sinc}\\!\\left(\\frac{\\omega_r\\Delta}{2}\\right)\n

avec :

\n\\operatorname{sinc}(x)=\\frac{\\sin x}{x}\n

Dans l’ensemble, ce comportement de « rendre ce qui peut l’être, afficher le reste clairement » semble être un grand progrès en termes d’utilisabilité par rapport aux modes d’échec plus anciens ou moins transparents. Merci à toutes les personnes impliquées dans le travail de mise à niveau de MathJax.

3 « J'aime »

Je tiens simplement à avertir tous ceux qui sont arrivés ici via Google que ce plugin n’est pas disponible pour l’offre gratuite de plan d’hébergement. :expressionless_face:

Bonjour, je comprends votre frustration. Je suis désolé que vous vous sentiez ainsi. Pour les cas futurs, vous pouvez consulter le répertoire des plugins par plan ici.

Le plugin Math est répertorié sur cette page comme un plugin pro/entreprise. On pourrait donc supposer qu’il est disponible pour le plan gratuit. Je ne suggère pas que vous deviez le rendre gratuit. Je pense simplement qu’il faudrait clarifier un peu la situation.

1 « J'aime »

C’est exact. La page Discourse pricing | Discourse - Civilized Discussion répertorie tous les plans et leurs limites, y compris les plugins, ce qui vous permet de voir rapidement quels plugins sont autorisés.

1 « J'aime »

Je vois un nouvel outil, RaTeX,
écrit en Rust, 100 % compatible avec Katex.

GitHub - erweixin/RaTeX: >99.5% KaTeX syntax coverage. LaTeX math renderer in pure Rust. No JavaScript, no WebView, no DOM. One Rust core → iOS, Android, Flutter, Web, PNG. C ABI · WASM · Server-side PNG/SVG. · GitHub

Il pourrait être une bonne alternative.

J’ai trouvé un problème intéressant.

Je calcule des problèmes de physique, j’ai remarqué que \dot et \ddot fonctionnent bien, mais il n’y a pas de \dddot, et dès qu’une fonction contient \dddot, toutes les formules suivantes cessent de fonctionner.

1 « J'aime »

@xiasummer Essayons avec \dddot{r} et

\dddot{r}.

Ils semblent fonctionner ici. Je les ai testés sur mon site en utilisant à la fois MathJax et KaTeX.

1 « J'aime »