View source for Extension:Math/fr

<languages />
{{Extension
|status          = stable
|image           = ExtensionMath (cropped).svg
|type1           = tag
|newhook1        = MathRenderingResultRetrieved
|newhook2        = MathFormulaPostRender
|author          = <nowiki/>
* Moritz Schubotz,
* Tomasz Wegrzanowski,
* Brooke Vibber,
* Johannes Stegmüller,
* André Greiner-Petter,
* et d'autres
|description     = Permet d'afficher des formules mathématiques
|version         = continuous updates
|update          = 
|version preview = 
|update preview  =
|schema-registry = Yes
|compatibility policy = rel
|download        = {{WikimediaDownload|Math|phab=EMAT}}
|mediawiki       = 
|tags            = {{tag|math|open}}
|bugzilla        = Math
|table1          = math
|table2          = mathoid
|table3          = mathlatexml
|needs-updatephp = Yes <!--Yes (until 1.41)<br>No (since 1.42)-->
|phabricator     = Math
}}
L'extension '''Math''' fournit une gestion pour l'affichage de formules mathématiques.

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 {{ll|Extension:Math/advancedSettings}}.

Un tour d'horizon de ce qui peut actuellement être fait avec cette extension est disponible dans [[Special:MyLanguage/Extension:Math/Syntax|Affichage d'une formule mathématique]].

<span id="Installation"></span>
== Installation ==
{{Bundled|1.38}}
{{ExtensionInstall
|vagrant=math
|repo-name=Math
|registration=required
|custom-steps=
* Si vous utilisez la version MediaWiki avant 1.42, exécutez le script {{ll|Manual:Update.php|update.php}} pour créer les tables de base de données nécessaires. Cela n'est plus nécessaire si vous installez Math dans MediaWiki 1.42+.
* Pour voir les formules mathématiques au-delà d'une sortie en texte brut, suivez les instructions ci-dessous pour activer divers [[Special:MyLanguage/Extension:Math/advancedSettings#Math output modes|modes d'affichage mathématiques]].
* Si vous avez des problèmes pour représenter les formules en utilisant RESTBase, essayez le [https://www.mediawiki.org/w/index.php?title=Topic:Uo3kkmmop1jj9vhw&topic_showPostId=v2pfwaghxx0fmu0c#flow-post-v2pfwaghxx0fmu0c correctif] suivant
}}

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
<!--TODO: Make a reasonable template (something like https://phabricator.wikimedia.org/maniphest/task/create/?template=116263 for math extension installation problems -->

Malheureusement, il n'y a pas de guide bien testé sur l'installation de {{ll|Mathoid}} et {{ll|RESTBase|RESTBase}} pour fonctionner avec l'extension Math, mais il existe au moins une préversion de travail.
{{ll|Extension:Math/RESTBase}} auquel vous pouvez contribuer.

De plus le [https://github.com/physikerwelt/mathoid-docs/blob/master/Guide%20for%20Installing%20and%20Setting%20up%20Mediawiki%20with%20Restbase%20and%20Mathoid.pdf Guide pour installer et configurer Mediawiki avec RESTBase et Mathoid en MW1.28] est disponible.

<span id="Usage"></span>
== Utilisation ==

Une fois installé, vous pouvez écrire les formules avec la [[Special:MyLanguage/Extension:Math/Syntax|syntaxe TeX]] à l'intérieur de balises {{tag|math|open}}. Par exemple :

<syntaxhighlight lang="wikitext">
<math>E=mc^2</math>
</syntaxhighlight>

donne :

<math>E=mc^2</math>


<span id="Viewing_math"></span>
== Afficher les formules mathématiques ==
Le type de sortie dépend du logiciel que vous utilisez pour lire la page.
Dans la mesure du possible, l'extension Math essaie de produire un affichage [[:fr:MathML|MathML]]. Sinon, elle génère les images au format SVG (en convertissant les caractères en éléments de chemins &lt;path>) ou en PNG.
La prise en charge des formules mathématiques de base fonctionne avec tous les navigateurs. Mais, pour de meilleurs résultats, vous devrez peut être modifier vos paramètres :

* Pour les navigateurs [[w:Firefox|Firefox]] et ceux à base de [[w:Gecko (software)|Gecko]], installer  l'[https://addons.mozilla.org/firefox/addon/native-mathml/ extension Native MathML] ainsi que les [https://developer.mozilla.org/docs/Mozilla/MathML_Project/Fonts polices mathématiques].<br>Le support pour l'accessibilité est fourni par les lecteurs d'écran [[w:fr:NonVisual Desktop Access|NVDA]], [[w:fr:VoiceOver|VoiceOver]] et [[w:fr:Orca (accessibilité)|Orca]]. NVDA nécessite le greffon [[w:MathPlayer|MathPlayer]] pour lire les formules mathématiques.
* Pour les navigateurs [[w:Safari (web browser)|Safari]] et les autres navigateurs de type [[w:WebKit|WebKit]], vous pouvez aussi installer les polices mathématiques et activer le rendu MathML natif en [[Special:MyLanguage/Extension:Math/advancedSettings#CSS for the MathML with SVG fallback mode|insérant quelques règles CSS]] dans la feuille de style personnalisée des préférences de votre navigateur.<br>Le support d'accessibilité est fourni par le lecteur d'écran [[w:fr:VoiceOver|VoiceOver]]. Quant à  [[w:fr:Orca (accessibilité)|Orca]], il ne le fait pas encore.
* Pour [[w:fr:Google Chrome|Chrome]] vous devez [[Special:MyLanguage/Extension:Math/advancedSettings#CSS for the MathML with SVG fallback mode|insérer des règles CSS]] dans la feuille de style personnelle de votre navigateur pour avoir le support d'accessibilité avec le lecteur d'écran  [http://www.chromevox.com/ ChromeVox] ou l'affichage visuel avec le [https://chrome.google.com/webstore/detail/math-anywhere/gebhifiddmaaeecbaiemfpejghjdjmhc greffon MathJax].

<span id="Configuration_settings"></span>
== Paramètres de configuration ==
{| class="wikitable"
! Nom de paramètre
! Valeur par défaut
! Description
|-
| {{ll|Manual:$wgMathValidModes|$wgMathValidModes}}
| <code>[ 'source', 'mathml' ]</code>
| Définit le mode autorisé sur le serveur.
|-
| {{ll|Manual:$wgMathDisableTexFilter|$wgMathDisableTexFilter}}
| <code>'never'</code>
| Option pour désactiver le filtre Tex. Si défini à <code>true</code> toute expression LaTeX est analysée, cela peut être un risque de sécurité potentiel. Si défini à <code>false</code>, seul un sous-ensemble des commandes TeX est autorisé. Voir la page wikipedia [[wikipedia:Help:Math|Help:Math]] pour plus de détails. Utilisez 'always' pour désactiver cette fonctionnalité.
|-
|$wgMathFullRestbaseURL
|false
| L’extension Math récupère la configuration par défaut à partir de l’éditeur visuel, si disponible. [https://gerrit.wikimedia.org/r/plugins/gitiles/mediawiki/extensions/Math/+/master/src/MathRestbaseInterface.php#182 Détails].
|-
|$wgMathPreferRestbaseURL
| true
| Indique s'il faut autoriser l'utilisation du chemin interne de RESTBase au lieu de $wgMathFullRestbaseURL et $wgVisualEditorFullRestbaseURL. Mettre à <code>false</code> si vous souhaitez toujours utiliser le RESTBase externe.
|}

<span id="Math_output_modes"></span>
=== 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 :

<syntaxhighlight lang="php">
$wgDefaultUserOptions['math'] = 'mathml';
</syntaxhighlight>

====Mathoid====
Mode : 'mathml'
{{Warning|1=Mathoid is no longer actively developed in favor of [[#Native MathML|Native MathML]] mode. Pourra éventuellement être interrompu.}}

Vous pouvez utiliser Mathoid, une application qui utilise MathJax côté serveur pour convertir l'entrée ''texvc'' en rendu MathML+SVG.
Mathoid est actuellement le mode de rendu mathématique utilisé sur Wikipedia.

<span id="Mathoid_as_a_service"></span>
===== 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 [[Special:MyLanguage/Mathoid|Mathoid]] 
et les services {{ll|RESTBase|RESTBase}} des clusters bêta  pour générer le rendu de toutes les formules mathématiques. Les paramètres par défaut sont :

<syntaxhighlight lang="php">
// Définir MathML comme option de rendu par défaut
$wgDefaultUserOptions['math'] = 'mathml';
$wgMathUseInternalRestbasePath = false;
$wgMathFullRestbaseURL = 'https://wikimedia.org/api/rest_';
$wgMathMathMLUrl = 'https://mathoid-beta.wmflabs.org';
</syntaxhighlight>

{{Warning|1=Wikimedia plans to discontinue {{ll|RESTBase}} services including the Mathoid endpoint used by Math extension by default, though there is no specific EOL date yet. For sites using newer MediaWiki versions, [[#Native MathML|Native MathML]] mode is recommended instead.}}

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

<span id="Mathoid&#039;s_CLI_interface"></span>
===== 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 :

<syntaxhighlight lang="php">
// Définir MathML comme option de rendu par défaut
$wgDefaultUserOptions['math'] = 'mathml';
// Veuillez créer préalablement un fichier ''config.yaml''. Les modèles se trouvent dans le dépôt Mathoid.
$wgMathoidCli = ['/path/to/mathoid/cli.js', '-c', '/path/to/mathoid/config.yaml'];
// Augmentez la limite mémoire de MediaWiki à 1.2G pour mathoid.
$wgMaxShellMemory = 1228800;
</syntaxhighlight>

{{Note|1=
Si vous exécutez MediaWiki sur un système contenant {{ll|SELinux}} et que vous obtenez le message d'erreur <code>Mathoid cli '/path/to/mathoid/cli.js' is not executable</code> dans les traces, vous pouvez exécuter ceci pour vous assurer que le serveur Apache autorise la modification des limites du système :
<pre>
setsebool -P httpd_execmem 1
setsebool -P httpd_setrlimit 1
</pre>
}}

====LaTeX====
{{MW 1.39|and before}}
Mode : 'png'

Depuis MediaWiki 1.32, ce mode nécessite également un serveur Mathoid pour fonctionner.
Dans les anciennes versions, il faut [[Special:MyLanguage/Extension:Math/advancedSettings#Installing texvc|installer ''texvc'' et ''texvccheck'']], ce qui peut représenter le plus gros du travail de configuration.

====LaTeXML====
Mode : 'latexml'

Servez-vous de l'utilitaire [http://math.nist.gov/~BMiller/LaTeXML/manual/intro/ LaTeXML].
Le rendu se fait via un service en ligne (défini avec $wgLaTeXMLUrl, qui a pour valeur par défaut https://latexml.formulasearchengine.com/convert).

<span id="Native_MathML"></span>
==== MathML natif ====
{{MW 1.40|and later}}
Mode : 'native'

Ce mode permet de générer du MathML depuis LaTeX via PHP ''sans'' Mathoid.
À noter que ce mode n'a pas d'images de repli, les formules ne s'afficheront donc correctement que si le navigateur prend en charge le langage MathML.
Firefox et Safari ont pris en charge MathML tôt (1006 et 2008), mais la prise en charge des navigateurs basés sur Chromium est beaucoup plus récente (Chrome 109, publié en 2023).
<span id="MathJax"></span>
==== MathJax ==== 
{{MW 1.42|and later}}
Mode : 'mathjax'

Ce mode fonctionne de la même manière que le mode MathML natif (générant MathML depuis LaTeX via PHP), mais utilisera MathJax 3 le rendu MathML.
Par conséquent, il fonctionnera aussi pour les navigateurs qui ne supportent pas MathML, avec le coût de chargement de la bibliothèque MathJax (compris dans l'extension Math) sur les pages vues.
{{Warning|1=Auparavant, un mode MathJax basé sur MathJax 2 est fourni dans MediaWiki 1.19-1.25. To use MathJax to render formulas in MediaWiki 1.26-1.41, see {{ll|Extension:SimpleMathJax}}.}}

<span id="No_rendering"></span>
==== Pas de rendu ====
Mode :
'source'

Ce mode va transférer l’entrée Latex sans rendu, en la présentant dans un élément {{tag|span|open}}, 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.

<span id="Tracking_categories"></span>
== Suivi des catégories ==
L'extension crée un nombre de {{ll|tracking category|catégories de suivi}} pour détecter les erreurs et les fonctionnalités obsolètes.
Their message keys begin with <code>math-</code>.
Les administrateurs d'un wiki peuvent modifier le nom des catégories de suivi en modifiant la valeur du message dans l'espace de noms MediaWiki de ce wiki.
[[Special:TrackingCategories]] shows each tracking category's name, message key, and description.

{| class="wikitable" 
|-
! Page MediaWiki
! Par défaut
! Description
|-
| [[MediaWiki:Math-tracking-category-error]] || [[:Category:Pages with math errors]]
| Pages où il y a une erreur de syntaxe dans la formule causant l’échec du rendu
|-
| [[MediaWiki:Math-tracking-category-render-error]] || [[:Category:Pages with math render errors]]
| Pages où il y a eu une erreur temporaire dans le pipeline causant l’échec du rendu. Celles-ci se corrigent normalement elles-mêmes
|-
| [[MediaWiki:Math-tracking-category-texvc-deprecation]] || [[:Category:Pages that use a deprecated format of the math tags]]
| Pages qui utilisent la syntaxe obsolète ''texvc'' telle que <code>$ % \and \or \part \ang \C \H \bold \Bbb\ \pagecolor</code>, devant être respectivement remplacée par la forme LaTex plus standard <code>\$ \% \land \lor \partial \angle \Complex \mathbb{H} \mathbf \mathbb (removed)</code>. Voir {{ll|Extension:Math/Roadmap}}.
|-
| [[MediaWiki:Math-tracking-category-mhchem-deprecation]] || [[:Category:Pages that use a deprecated format of the chem tags]]
|
Marquage chimique obsolète, voir [[Special:MyLanguage/Extension:Math/Roadmap#Step 1 Part C: Manual fixing of mhchem syntax|Extension:Math/Roadmap#Step 1 Part C : Manual fixing of mhchem syntax]].
|}

<span id="Tips_and_tricks"></span>
== Trucs et astuces ==
* Vous pouvez utiliser le greffon Firefox [https://addons.mozilla.org/de/firefox/addon/mathml-copy MathML copy] pour copier des formules vers d’autres applications telles que Microsoft Word ([https://www.youtube.com/watch?v=FDMfT27zE54 video]), ou Google docs avec le greffon [https://chrome.google.com/webstore/detail/gmath/hhaencnpmaacoojogjkobikbmkhikjmm?utm_source=permalink g(Math)] ([https://www.youtube.com/watch?v=KKwF6IKRkHU&hd=1 video])
* Vous pouvez remplacer le mode de rendu préféré utilisateur et celui par défaut en ajoutant l'attribut <code>forcemathmode</code> à l'élément {{tag|math|open}} par exemple pour forcer le rendu d'une image <syntaxhighlight lang=html inline><math forcemathmode="png">...</math></syntaxhighlight>.
* 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, [[Special:MyLanguage/Manual:Purge|purgez-la]] en utilisant l'action <code>?action=purge&mathpurge=true</code>. Par exemple, l'URL https://en.wikipedia.org/w/index.php?title=Integral&action=purge&mathpurge=true forcera le nouveau rendu de l'article [[w:Integral]]. Ensuite, vous devez [[w:WP:Bypass your cache|masquer l'utilisation du cache de votre navigateur]] afin que les nouvelles images créées des formules soient téléchargées à nouveau.

<span id="Error_reporting"></span>
== Rapporter les erreurs ==

Si quelque chose ne va pas avec l'extension Math vous pouvez le signaler sur  [https://phabricator.wikimedia.org/maniphest/task/create/?projects=MediaWiki-extensions-Math 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 [[Special:MyLanguage/Extension:Math/CoverageTest|CoverageTest]].

<span id="Further_reading"></span>
== Lectures complémentaires ==

Voir {{ll|Extension:Math/advancedSettings}} pour les anciennes versions et plus d'informations.

<span id="Subpages"></span>
== Sous-pages ==
{{subpages|Extension:Math}}

<span id="See_also"></span>
== Voir aussi ==
* {{ll|Extension:Math/Roadmap}}
* {{ll|Mathoid}}
* {{ll|Extension:SimpleMathJax}} - un moyen alternatif de fournir un support pour le rendu de formules mathématiques sur wiki, sans texvc ou LaTeX
* {{ll|Texvc PHP Alternative}}
* {{ll|Manual:Enable TeX/problems}}
* {{ll|Manual:Math}}

{{OnWikimedia}}
{{Used by}}

[[Category:TeX{{#translation:}}]]
[[Category:Math display extensions{{#translation:}}]]
[[Category:Extensions with VisualEditor support{{#translation:}}]]