Extension:Math/fr

L'extension Math fournit une gestion pour l'affichage de formules mathématiques. Un tour d'horizon de ce qui peut actuellement être fait avec cette extension est disponible dans Affichage d'une formule.

D'autres informations sur la manière d'installer et de configurer cette extension, y compris pour des versions plus anciennes, peuvent être trouvées sur.



Afficher les formules mathématiques
L'extension Math essaye de produire un affichage MathMl, avec un repli sur le format d'image SVG (en convertissant les caractères en chemins &lt;path>) voire PNG (dernière préférence). Le type de sortie est choisi en fonction des capacités de l'appareil utilisé. La prise en charge des formules mathématiques de base fonctionne avec tous les navigateurs. Néanmoins, pour un rendu optimal, des adaptations supplémentaires peuvent être nécessaires :


 * Pour les navigateurs Firefox et ceux à base de Gecko, l'installation de l'extension Native MathML et de math fonts sont nécessaires. Le support d'accessibilité est fourni par NVDA, VoiceOver ou Orca. En plus, NVDA nécessite le greffon MathPlayer pour lire les formules mathématiques.
 * Pour les navigateurs Safari ou les autres navigateurs de type WebKit, il est conseillé d'installer les polices mathématiques et d'activer le rendu MathML natif en insérant quelques règles CSS dans la feuille de style des préférences de votre navigateur. Le support d'accessibilité est fourni par le lecteur d'écran VoiceOver mais pas encore par Orca.
 * Pour Chrome vous devez insérer des règles CSS dans la feuille de style personnelle de vos préférences de navigateur pour avoir le support d'accessibilité via ChromeVox ou l'affichage visuel via l'extension MathJax.
 * Dans certaines versions d'Internet Explorer, il est possible d'utiliser MathPlayer comme technologie d'assistance.

Installation
Vous devriez également aller à la page Special:MathStatus pour voir si tous les composants de l’extension Math fonctionnent maintenant. Pour tout problème que vous voyez, le mieux est de créer une tâche sur https://phabricator.wikimedia.org

Malheureusement, il n'y a pas de guide bien testé sur l'installation de et  pour fonctionner avec l'extension Math, mais il existe au moins une préversion de travail. auquel vous pouvez contribuer.

De plus le Guide pour installer et configurer Mediawiki avec RESTBase et Mathoid en MW1.28 est disponible.



Modes de sortie de Math
Le paramètre $wgMathValidModes contient un tableau avec le nom des modes de sortie pouvant être utilisé pour le rendu. Si plusieurs modes sont activés, les utilisateurs connectés peuvent définir une préférence personnelle dans le volet d'apparence de leur page de préférences utilisateur.

Vous pouvez également utiliser le paramètre $wgDefaultUserOptions pour définir lequel de ces modes doit être la valeur par défaut, par exemple :

Mathoid
Mode : 'mathml'

Vous pouvez utiliser Mathoid, une application qui utilise MathJax côté serveur pour convertir l'entrée texvc en rendu MathML+SVG. C'est l'option la plus recommandée ; Mathoid est le mode de rendu utilisé sur Wikipedia.



Mathoid en tant que service
Mathoid en tant que service est l'approche recommandée pour l'extension Math et celle définie par défaut. Si vous n'ajoutez aucun paramètre supplémentaire dans LocalSettings.php, Math va utiliser Mathoid et les services des clusters bêta  pour générer le rendu de toutes les formules mathématiques. Les paramètres par défaut sont :

Vous pouvez modifier ces paramètres pour utiliser les différents services Mathoid et RESTBase, et éventuellement leur inclure ceux qui vous sont propres.



Interface CLI de Mathoid
Vous pouvez à la place exécuter Mathoid comme un utilitaire en ligne de commande sur le serveur local. Pour utiliser cette approche, les paramètres suivants sont recommandés :

LaTeX
Mode : 'png'

Depuis MediaWiki 1.32, ce mode nécessite également un serveur Mathoid pour fonctionner. Dans les anciennes versions, il faut installer texvc et texvccheck, ce qui peut représenter le plus gros du travail de configuration.

LaTeXML
Mode : 'latexml'

Servez-vous de l'utilitaire LaTeXML. Le rendu se fait via un service en ligne (défini avec $wgLaTeXMLUrl, qui a la valeur par défaut https://latexml.formulasearchengine.com/convert).



Pas de rendu
Mode : 'source'

Ce mode va transférer l’entrée Latex sans rendu, en la présentant dans un élément, entouré de $ :formula $.

Assurez-vous de définir $wgMathDisableTexFilter à 'always' (voir ci-dessous) si vous ne voulez que la formule de latex brut, sinon une erreur apparaîtra en raison de l’échec de la vérification pour les représentations PNG.



Liste des paramètres de configuration significatifs


Suivi des catégories
L'extension crée un nombre de catégories de suivi pour détecter les erreurs et les fonctionnalités obsolètes. Le nom exact des catégories est déterminé par les pages de l'espace de noms de MediaWiki.



Trucs et astuces

 * Vous pouvez utiliser le greffon Firefox MathML copy pour copier des formules vers d’autres applications telles que Microsoft Word (video), ou Google docs avec le greffon g(Math) (video)
 * Vous pouvez remplacer le mode de rendu préféré utilisateur et celui par défaut en ajoutant l'attribut  à l'élément  par exemple pour forcer le rendu d'une image.
 * Toutes les images de la formule rendue sont stockées dans un cache et ne sont pas systématiquement recréées quand la page est consultée ou modifiée. Pour forcer la regénération du rendu de toutes les formules d'une page, purgez-la en utilisant l'action . Par exemple, l'URL https://en.wikipedia.org/w/index.php?title=Integral&action=purge&mathpurge=true forcera le nouveau rendu de l'article Integral. Ensuite, vous devez masquer l'utilisation du cache de votre navigateur afin que les nouvelles images créées des formules soient téléchargées à nouveau.



Rapporter les erreurs
Si quelque chose ne va pas avec l'extension Math vous pouvez le signaler sur Phabricator. De plus, vous devez vérifier comment votre problème est lié aux tests unitaires automatisés générés à partir de la page CoverageTest.



Lectures complémentaires
Voir pour les anciennes versions et plus d'informations.

Sous-pages


Voir aussi

 * - un moyen alternatif de fournir un support pour le rendu de formules mathématiques sur wiki, sans texvc ou LaTeX
 * - un moyen alternatif de fournir un support pour le rendu de formules mathématiques sur wiki, sans texvc ou LaTeX
 * - un moyen alternatif de fournir un support pour le rendu de formules mathématiques sur wiki, sans texvc ou LaTeX