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 la documentation de Wikipédia anglophone.

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 à.

Afficher des maths
L'extension Math essaye de produire un affichage MathMl, avec une sortie en images SVG ou PNG. Selon les capacités de l'appareil utilisé, le type de sortie est choisie. Les mathématiques de bases peuvent être affichées sur n'importe quel navigateur. Néanmoins, pour un rendu optimal, des configurations supplémentaires peuvent être nécessaires:


 * Pour les navigateurs Firefox ou GeckO, l'installation de Native MathML extension et de math fonts est nécessaire. Le support d'accessibilité est fourni par NVDA, VoiceOver ou Orca. En plus, NVDA nécessite le plugin MathPlayer pour lire les formules mathématiques.
 * Pour les navigateurs Safari ou d'autres navigateurs de type WebKit, il est conseillé d'installer les polices mathématiques et d'active le rendu MathML natif avec inserting some CSS rules en utilisant une feuille de style dans les préférences du 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 votre 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 une technologie d'assistance.

Installation
You should additionally go to the page Special:MathStatus to see whether all of the components of the Math extension now work. 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 y a au moins un projet de travail. s'il vous plaît contribuer.

In addition, there is a Guide for Installing and Setting up Mediawiki with Restbase and Mathoid in MW1.28.

Modes de sortie de Math
Le paramètre $wgMathValidModes contient un tableau avec les noms des modes de sortie qui peuvent être utilisés 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' (pre-July 2015: MW_MATH_MATHML)

Vous pouvez également utiliser le paramètre $wgDefaultUserOptions pour définir lequel de ces modes doit être la valeur par défaut, par exemple: pour MW 1.23 et versions ultérieures, vous pouvez utiliser un serveur Mathoid qui utilise MathJax pour convertir l'entrée texvc côté serveur en rendu MathML+SVG. C'est l'option la plus recommandée ; Mathoid est le mode de rendu qui sera utilisé sur Wikipédia à l'avenir.

Mathoid en tant que service
Pour utiliser Mathoid as a service, entraînant des gains de performances, les paramètres suivants sont recommandés:

Voir Mathoid pour des instructions sur la façon d'exécuter votre propre serveur Mathoid. Notez qu'à partir de mars 2017, cela nécessitera probablement également un serveur/une installation de (voir ).

Interface CLI de Mathoid
Pour utiliser Mathoid's CLI interface, qui est peut-être plus facile à mettre en place et se traduit par une consommation mémoire permanente moindre, tout en dégradant les performances, les paramètres suivants sont recommandés:

LaTeX
Mode: 'png' (pre-July 2015: MW_MATH_PNG)

Depuis MediaWiki 1.32, ce mode nécessite également un serveur Mathoid pour fonctionner. In older versions, it requires installing texvc and texvccheck, which may require the most setup work.

LaTeXML
Mode : 'latexml' (pre-July 2015: MW_MATH_LATEXML)

Servez-vous de l'utilitaire LaTeXML. The rendering is done via an online service (set with $wgLaTeXMLUrl, which has a default value).

Pas de rendu
Mode : 'source', (pre-July 2015: MW_MATH_SOURCE)

This mode will forward the Latex input without rendering, presenting it in a element, surrounded by $ :formula $.

Make sure to set $wgMathDisableTexFilter to 'always' (see below) if you only want the raw latex formula, else an error will appear due to the failed check for PNG depictions.

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

 * You can use the Firefox MathML copy addon to copy formulae to other applications such as Microsoft Word (video), or Google docs with the g(Math) plugin (video)
 * Vous pouvez remplacer le mode de rendu préféré et par défaut de l'utilisateur 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 automatiquement recréées si la page est consultée ou modifiée. Pour forcer le re-rendu de toutes les formules d'une page, purge 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 Integer. Ensuite, vous devez bypass your browser cache afin que les nouvelles images créées des formules soient réellement téléchargées.

Rapporter les erreurs
Si quelque chose ne va pas avec l'extension mathématique, vous pouvez le signaler à 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.

Voir aussi

 * - un moyen alternatif de fournir un support pour le rendu de formules mathématiques sur wiki, sans texvc ou LaTeX
 * - description de texvc
 * Une autre possibilité est d'utiliser :
 * - description de texvc
 * Une autre possibilité est d'utiliser :
 * Une autre possibilité est d'utiliser :
 * Une autre possibilité est d'utiliser :