 |
Résumé | Discourse Math utilise MathJax (par défaut) ou KaTeX pour rendre les formules mathématiques dans votre forum Discourse. |
 |
Guide d’installation | Ce plugin est intégré au cœur de Discourse. Aucune installation séparée n’est nécessaire. |
Activer les 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 rendre des formules mathématiques en ligne en les entourant d’un seul $ comme ceci : $E=mc^2$.
Vous pouvez rendre des blocs de formules mathématiques 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 encore 100$ » ne sont pas converties.
Délimiteurs LaTeX
Lorsqu’ils sont activés via les paramètres du site, vous pouvez également utiliser les délimiteurs LaTeX standards :
- 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 à l’éditeur
L’éditeur inclut un bouton Insérer une formule mathématique dans la barre d’outils avec le raccourci clavier \u003ckbd\u003eMaj\u003c/kbd\u003e+\u003ckbd\u003eM\u003c/kbd\u003e. 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 publication
Dans l’éditeur de texte enrichi, les expressions mathématiques apparaissent sous forme de nœuds modifiables avec un bouton d’édition pour modifier l’expression.
Prise en charge du Chat
Les expressions mathématiques sont également rendues dans les messages du Chat Discourse en utilisant les mêmes paramètres et le même 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)
- Amélioration de l’accessibilité pour les lecteurs d’écran
- Zoom au clic Alt (zoom 175 %)
- Prise en charge d’AsciiMath
KaTeX (Alternative)
- Fonctionnalités :
- Rendu rapide
- Extension Mhchem pour les équations chimiques
- Extension CopyTex - cliquez sur une formule pour copier le code source LaTeX dans le presse-papiers
- Prise en charge 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 les formules en ligne et \[...\] pour les blocs |
| 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é telles que l’enrichissement du texte (MathJax avec menu uniquement) |
| discourse math zoom on click | Zoom 175 % lors d’un clic avec la touche 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 niveaux d’hébergement Math | Discourse - Civilized Discussion