 |
Résumé | Discourse Math utilise MathJax (par défaut) ou KaTeX pour afficher les formules mathématiques dans votre forum Discourse. |
 |
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 :
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,\refet\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) |
Hébergé par nous ? Ce plugin est disponible sur tous nos plans d’hébergement Math | Discourse - Civilized Discussion