Discourse Math

||||\n-|-|-|\n:discourse2: | Résumé | Discourse Math utilise MathJax (par défaut) ou KaTeX pour afficher les formules mathématiques sur votre forum Discourse.\n:open_book: | Guide d’installation | Ce plugin est inclus dans le cœur de Discourse. Il n’est pas nécessaire d’installer le plugin séparément.\n\n\n[quote]\n\n:discourse2: Comme il s’agit d’un plugin #officiel maintenu par l’équipe Discourse, les demandes de Support, les rapports de Bug, les discussions UX et les demandes de Feature peuvent être faites dans les catégories respectives ici sur Meta, et étiquetées avec le tag de plugin approprié. Cliquez sur un lien ci-dessous pour en démarrer un. :+1:\n\n\u003ckbd\u003e [:question:\u0026nbsp;Support](Discourse Meta "Demander de l’aide pour la configuration et l’utilisation de Discourse Math") \u003c/kbd\u003e \u003ckbd\u003e [:bug:\u0026nbsp;Bug](Discourse Meta "Un rapport de bug signifie que quelque chose est cassé, empêchant l’utilisation normale/typique du plugin") \u003c/kbd\u003e \u003ckbd\u003e [:eyes:\u0026nbsp;UX](Discourse Meta "Discussion sur l’interface utilisateur de Discourse Math, et la manière dont les fonctionnalités sont présentées (y compris la langue et les éléments de l’interface utilisateur)") \u003c/kbd\u003e \u003ckbd\u003e [:bulb:\u0026nbsp;Fonctionnalité](Discourse Meta "Discussion sur la manière dont les fonctionnalités existantes de Discourse Math peuvent être améliorées ou enrichies, et sur le fonctionnement des nouvelles fonctionnalités proposées")\u003c/kbd\u003e\n\n[/quote]\n\n### Activation des formules mathématiques\n\nLe plugin Math peut être activé à partir de ses paramètres, accessibles depuis votre page admin/plugins :\n\nMath settings\n\n\n### Fonctionnalités\n\nUne fois activé, vous pouvez afficher des formules mathématiques en ligne en les encadrant avec un seul $ comme ceci : $E=mc^2$.\n\nVous pouvez afficher des blocs de formules en les encadrant avec $$\n\n\n$$\n\\sqrt{(-1)} \\; 2^3 \\; \\sum \\; \\pi\n$$\n\n\n

\n\nDiscourse Math utilise une heuristique pour s’assurer que des phrases telles que : « J’ai dépensé 20$ et encore 100$ » ne sont pas converties.\n\n#### Délimiteurs LaTeX\n\nLorsqu’ils sont activés via les paramètres du site, vous pouvez également utiliser les délimiteurs LaTeX standard :\n\n- En ligne : \\(...\\) - Exemple : \\(E=mc^2\\)\n- Bloc : \\[...\\] - Exemple :\n \n \\[\n \\frac{1}{2}\n \\]\n \n\n#### AsciiMath (MathJax uniquement)\n\nLorsque vous utilisez MathJax, vous pouvez activer le traitement asciimath qui utilise % comme délimiteur : %E=mc^2%\n\n### Intégration dans l’éditeur (Composer)\n\nL’éditeur (composer) comprend un bouton Insérer une formule mathématique dans la barre d’outils avec le raccourci clavier \u003ckbd\u003eShift\u003c/kbd\u003e+\u003ckbd\u003eM\u003c/kbd\u003e. Cela ouvre une fenêtre modale où vous pouvez :\n\n- Basculer entre le mode en ligne et le mode bloc\n- Écrire votre expression LaTeX\n- Prévisualiser et insérer dans votre message\n\nDans l’éditeur de texte enrichi, les expressions mathématiques apparaissent comme des nœuds modifiables avec un bouton d’édition pour modifier l’expression.\n\n### Prise en charge dans le Chat\n\nLes expressions mathématiques sont également affichées dans les messages du Chat Discourse en utilisant les mêmes paramètres et le même moteur de rendu.\n\n### Moteurs de rendu\n\n#### MathJax (Par défaut)\n\n- Version : 4.1\n- Formats de sortie : HTML (par défaut) ou SVG\n- Fonctionnalités :\n - Menu contextuel (clic droit sur la formule mathématique)\n - Enrichissement de l’accessibilité pour les lecteurs d’écran\n - Zoom sur alt-clic (zoom 175%)\n - Prise en charge d’AsciiMath\n\n#### KaTeX (Alternative)\n\n- Fonctionnalités :\n - Rendu rapide\n - Extension Mhchem pour les équations chimiques\n - Extension CopyTex - cliquez sur la formule mathématique pour copier la source LaTeX dans le presse-papiers\n - Prise en charge des références croisées avec les macros \\label, \\ref et \\eqref\n\n### Paramètres du site\n\nConsultez tous les paramètres de site pertinents en recherchant « math » dans vos paramètres d’administration.\n\n| Nom | Description |\n|-|-|\n| discourse math enabled | Activer le plugin Discourse Math (ajoute un traitement spécial aux blocs $ et $$) |\n| discourse math provider | Fournisseur de rendu mathématique : mathjax (par défaut) ou katex |\n| discourse math enable latex delimiters | Activer les délimiteurs de style LaTeX : \\(...\\) pour les formules en ligne et \\[...\\] pour les formules en bloc |\n| discourse math mathjax output | Format de sortie MathJax : html (par défaut) ou svg (MathJax uniquement) |\n| discourse math enable menu | Activer le menu contextuel pour les expressions mathématiques (MathJax uniquement) |\n| discourse math enable accessibility | Activer les fonctionnalités d’accessibilité comme l’enrichissement textuel (MathJax avec menu uniquement) |\n| discourse math zoom on click | Zoom à 175% sur l’interaction alt-clic (MathJax avec menu uniquement) |\n| discourse math enable asciimath | Activer le traitement asciimath avec le délimiteur % (MathJax uniquement) |\n\n\n\u003e :discourse2: Hébergé par nous ? Ce plugin est disponible sur tous nos niveaux 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 »