Extension:Math
![]() État de la version : stable |
|
---|---|
![]() |
|
Implémentation | Balise |
Description | Permet d'afficher des formules mathématiques |
Auteur(s) |
|
Dernière version | continuous updates |
Politique de compatibilité | Versions ponctuelles alignées avec MediaWiki. Le master n'est pas compatible arrière. |
MediaWiki | >= 1.39.0 |
Modifie la base de données |
Oui |
Tables | math mathoid mathlatexml |
Licence | Licence publique générale GNU v2.0 ou supérieur |
Téléchargement | |
|
|
<math> |
|
Traduire l’extension Math sur translatewiki.net si elle y est disponible | |
Problèmes | Tâches ouvertes · Signaler un bogue |
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 à Extension:Math/advancedSettings .
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
- Si vous utilisez Vagrant , installez avec
vagrant roles enable math --provision
- Installation manuelle
- Téléchargez et placez le(s) fichiers (s) dans un répertoire appelé
Math
dans votre dossierextensions/
. - Ajoutez le code suivant à la fin de votre fichier LocalSettings.php :
wfLoadExtension( 'Math' );
- Exécutez le script de mise à jour qui va créer automatiquement les tables de base de données dont cette extension a besoin.
- Pour voir les mathématiques au-delà d'une sortie de texte brut, suivez les instructions ci-dessous pour activer divers modes d'affichage mathématique.
- Si vous avez des problèmes pour représenter certaines formules en utilisant la restbase de Wikipedia, essayez le correctif suivant
- Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.
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 Mathoid et RESTBase pour fonctionner avec l'extension Math, mais il y a au moins un projet de travail. Extension:Math/Restbase auquel vous pouvez contribuer.
De plus, il existe un guideː 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:
$wgDefaultUserOptions['math'] = 'mathml';
Mathoid
Mode: 'mathml'
Pour MW 1.23 et supérieur, 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 est sur Wikipedia. This is the most recommended option; Mathoid is the Math rendering mode used on Wikipedia.
Mathoid en tant que service
Pour utiliser Mathoid as a service, entraînant des gains de performances, les paramètres suivants sont recommandés:
// Pour utiliser '''Mathoid en tant que service''', entraînant des gains de performances, les paramètres suivants sont recommandés: Définir MathML comme option de rendu par défaut
$wgDefaultUserOptions['math'] = 'mathml';
$wgMathFullRestbaseURL = 'https://wikimedia.org/api/rest_';
$wgMathMathMLUrl = 'https://mathoid-beta.wmflabs.org';
Voir Mathoid pour des instructions sur la façon d'exécuter votre propre serveur Mathoid.
Interface CLI de Mathoid
Vous pouvez exécuter Mathoid à la place comme un utilitaire en ligne de commande sur le serveur local. Cette option est peut-être plus facile à configurer et entraînera une consommation de mémoire permanente moindre. Cependant, les performances seront probablement inférieures. Pour utiliser cette approche, les paramètres suivants sont recommandés : To use this approach, the following settings are recommended:
// 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 de mémoire de MediaWiki à 1.2G pour mathoid.
$wgMaxShellMemory = 1228800;
Si vous exécutez MediaWiki sur un système contenant SELinux et que vous obtenez le message d'erreur Mathoid cli '/path/to/mathoid/cli.js' is not executable
dans les traces, vous pouvez exécuter ceci pour vous assurer que le serveur Apache autorise la modification des limites du système :
setsebool -P httpd_execmem 1 setsebool -P httpd_setrlimit 1
LaTeX
Mode: 'png'
Depuis MediaWiki 1.32, ce mode nécessite également un serveur Mathoid pour fonctionner. Dans les anciennes versions, il nécessite installing texvc and texvccheck, ce qui peut nécessiter le plus de 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 une valeur par défaut).
Pas de rendu
Mode: 'source'
Ce mode va transférer l’entrée Latex sans rendu, la présentant dans un élément <span>
, 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 des représentations PNG.
Liste de paramètres de configuration significatifs
Nom de paramètre | Valeur par défaut | Description |
---|---|---|
$wgMathValidModes | array( 'png', 'source', 'mathml' )
|
Définit le mode autorisé sur le serveur. |
$wgMathDisableTexFilter | 'never'
|
Option pour désactiver le filtre tex. Si défini à true toute expression LaTeX est analysée, cela peut être un risque de sécurité potentiel. Si défini à false, seul un sous-ensemble des commandes TeX est autorisé. Voir la page wikipedia Help:Math pour plus de détails. Utilisez "always" pour désactiver cette fonctionnalité. |
$wgMathFullRestbaseURL | false | L’extension math obtient la configuration par défaut de l’éditeur visuel, si disponible. Détails. |
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.
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 de rendu causant l’échec du rendu. Ceux-ci se corrigent normalement eux-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 $ % \and \or \part \ang \C \H \bold \Bbb\ \pagecolor , devant être respectivement remplacée par la forme LaTex plus standard \$ \% \land \lor \partial \angle \Complex \mathbb{H} \mathbf \mathbb (removed) . Voir 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 Extension:Math/Roadmap#Step 1 Part C : Manual fixing of mhchem syntax. |
Trucs et astuces
- Vous pouvez utiliser Firefox MathML copy addon pour copier des formules vers d’autres applications telles que Microsoft Word (video), ou Google docs avec le plugin g(Math) (video)
- Vous pouvez remplacer le mode de rendu préféré et par défaut de l'utilisateur en ajoutant l'attribut
forcemathmode
à l'élément<math>
. par exemple. pour forcer le rendu d'une image<math forcemathmode="png">...</math>
. - 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
?action=purge&mathpurge=true
. 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: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 Extension:Math/advancedSettings pour les anciennes versions et plus d'informations.
Sous-pages
- Math/Announcement
- Math/CoverageTest
- Math/CustomizationHook
- Math/Displaystyle
- Math/Help:Formula
- Math/Hooks/MathAfterTexvc
- Math/Hooks/MathFormulaPostRender
- Math/Hooks/MathFormulaRendered
- Math/Hooks/MathRenderingResultRetrieved
- Math/Inputtypes
- Math/MathJaxMenu
- Math/MathJax testing
- Math/Restbase
- Math/Roadmap
- Math/T140217
- Math/T167569
- Math/T1835557
- Math/T183559
- Math/T218295
- Math/T247697
- Math/T305613
- Math/T32215
- Math/T86450
- Math/T87007
- Math/TeX-header
- Math/Unique Ids
- Math/Url2Image
- Math/Wikibooks-20160516
- Math/additionalAnnotationTypes
- Math/advancedSettings
- Math/advancedSettings/en
- Math/advancedSettings/es
- Math/advancedSettings/fr
- Math/advancedSettings/ja
- Math/advancedSettings/pl
- Math/advancedSettings/pt-br
- Math/advancedSettings/tr
- Math/annotation.js
- Math/bug/35189
- Math/bug/38641
- Math/bug/48032
- Math/bug/49210
- Math/bug/54818
- Math/bug/69554
- Math/bug/75285
- Math/da
- Math/de
- Math/en
- Math/es
- Math/fr
- Math/hu
- Math/id
- Math/ja
- Math/ko
- Math/math table
- Math/mathlatexml table
- Math/mathoid table
- Math/modifyMenu.js
- Math/new-version
- Math/new-version/de
- Math/new-version/en
- Math/new-version/es
- Math/new-version/ja
- Math/new-version/pl
- Math/new-version/ru
- Math/new-version/tr
- Math/new-version/zh
- Math/newFeatures
- Math/pl
- Math/pt-br
- Math/ru
- Math/tr
- Math/uk
- Math/vi
- Math/yue
- Math/zh
Voir aussi
- Extension:Math/Roadmap
- Mathoid
- Extension:SimpleMathJax - un moyen alternatif de fournir un support pour le rendu de formules mathématiques sur wiki, sans texvc ou LaTeX
- Texvc - description de texvc
- Alternative De Texvc PHP
- LaTeX on a shared host
- Une autre possibilité est d'utiliser : LaTeX with google chart
- Manual:Enable TeX/problems
- Manuel:Math
Cette extension est utilisée par au moins un des projets Wikimédia. Cela signifie probablement que l’extension est assez stable et fonctionnelle pour être utilisée sur des sites à fort trafic. Recherchez le nom de cette extension dans le CommonSettings.php de Wikimédia et dans le fichier de configuration InitialiseSettings.php pour situer les endroits où elle est installée. Une liste complète des extensions installées sur un Wiki donné peut être visualisée sur la page Special:Version de ce wiki. |
This extension is included in the following packages and/or wiki farms: |