Extension:Math/advancedSettings
L’extension Math fournit un support pour le rendu des formules mathématiques sur le wiki via Mathoid et d’autres moteurs. Un aperçu de ce qui peut actuellement être fait avec cette extension se trouve dans la documentation de la Wikipedia anglophone.
 Avertissement : | Les informations concernant la configurations de l'extension dans les versions MediaWiki plus anciennes, ont été retirées de cette page. Vous pouvez les retrouver dans l'historique de la page. |
Configuration
Rendu côté serveur avec Mathoid
À partir de MW 1.23+ vous pouvez utiliser un serveur Mathoid qui utilise MathJax pour convertir l’entrée texvc côté serveur en rendu MathML+SVG. Mathoid est le mode de rendu qui va être utilisé sur la future Wikipédia. Pour cela, les paramètres suivants sont recommandés :
// ensure 'mathml'; is added to the $wgMathValidModes array;
$wgMathValidModes[] = 'mathml';
// Set Mathoid as default rendering option;
$wgDefaultUserOptions['math'] = 'mathml';
Consultez Mathoid pour voir les instructions concernant l'exécution de votre propre serveur Mathoid. Après avoir activé le mode de rendu MathML, vous devez exécuter à nouveau le script de mise à jour de la base de données pour créer la table requise.
Rendu côté serveur avec LaTeXML
Une option pratique pour rendre LaTeX est d’utiliser le service web LaTeXML. Ce service convertit LaTeX en MathML de haute qualité.
- Paramètres (MW 1.22) la plupart ou la totalité des paramètres 1.23+ fonctionnent également
// Enable LaTeXML as rendering option
$wgUseLaTeXML = true; // this became an unused setting around 1.23
- Paramètres (MW 1.23+)
$wgMathValidModes[] = 'latexml'; // adding LaTeXML as rendering option
// Set LaTeXML as default rendering option;
$wgDefaultUserOptions['math'] = 'latexml';
// Specify the path to your LaTeXML instance that converts the \TeX commands to MathML (optional)
$wgLaTeXMLUrl = 'http://example.com/';
Un petit guide pour installer LaTeXML sur votre propre serveur peut être trouvé sur : Installer LaTeXML
Après avoir activé le mode de rendu LaTeXML, vous devez exécuter à nouveau le script de mise à jour de la base de données pour créer la table requise.
Historical note
texvc used to be a rendering option before version 1.32. It is now completely replaced by Mathoid, but the subset of AMS-LaTeX it supports remains the basis of this extension.
Liste de tous les paramètres de configuration
Les variables suivantes peuvent être définies dans LocalSettings.php après avoir appelé require_once "$IP/extensions/Math/Math.php";:
| Nom du paramètre | Valeur par défaut | Description |
|---|---|---|
| $wgUseTeX | true
|
Rétrocompatibilité globale; ne fait plus rien. |
| $wgTexvc | dirname( __FILE__ ) . '/math/texvc'
|
Emplacement du binaire texvc ('Removed' en MW 1.32 en raison de la disparition de texvc.) |
| $wgTexvcBackgroundColor | 'transparent'
|
Couleur de fond Texvc; utiliser le format de couleur LaTeX comme utilisé dans la fonction spéciale. Pour un fond transparent, utilisez la valeur 'Transparent' pour la transparence alpha ou 'transparent' pour la transparence binaire. ('Removed' en MW 1.32 en raison de la disparition de texvc.) |
| $wgMathCheckFiles | true
|
Normalement, lors de la génération d’images mathématiques, nous vérifions que les répertoires pour lesquels nous voulons écrire existent, et que les fichiers qui ont été générés existent toujours lorsque nous devons les remonter.
Cela nous permet de donner des messages d’erreur utiles en cas de problèmes d’autorisation, et de reconstruire automatiquement les images qui ont été perdues. Sur un grand site avec un trafic NFS important, cela peut être lent et floconneux, donc parfois nous voulons le court-circuiter en mettant cela à faux. |
| $wgMathPath | false
|
URL du chemin du répertoire mathématique. Par défaut à "{$wgUploadPath}/math". |
| $wgMathDirectory | false
|
Chemin du système de fichiers du répertoire math. Par défaut à "{$wgUploadDirectory}/math". |
| $wgUseMathJax | false
|
Active MathJax comme option de rendu. |
| $wgMathJaxUrl | '$IP/extensions/MathJax/MathJax.js?config=TeX-AMS-MML_HTMLorMML'
|
L’url vers MathJax si elle n’utilise pas l’analyseur par défaut à http://cdn.mathjax.org/. |
| $wgMathValidModes | [ 'png', 'source', 'mathml' ]
|
Définit le mode autorisé sur le serveur. |
| $wgMathMathMLUrl | 'https://mathoid-beta.wmflabs.org'
|
L’url du serveur mathoid. |
| $wgMathMathMLTimeout | 20
|
Délai d’attente pour la requête HTTP envoyée à MathML pour faire le rendu d'une équation, en secondes. |
| $wgMathLaTeXMLUrl | 'https://latexml.formulasearchengine.com/convert'
|
Utilisation de LaTeXML.
Si vous voulez ou devez exécuter votre propre serveur, suivez ces instructions d’installation et surchargez Si vous prévoyez un traffic important, vous pouvez spécifier plusieurs serveurs. Dans ce cas, un serveur est choisi aléatoirement pour chaque processus de rendu. Spécifiez la liste des serveurs dans un tableau, par exemple :
|
| $wgMathLaTeXMLTimeout | 240
|
Délai d’exécution de la requête HTTP envoyée à LaTeXML pour faire le rendu d'une équation, en secondes. |
| $wgMathDefaultLaTeXMLSetting | [
'format' => 'xhtml',
'whatsin' => 'math',
'whatsout' => 'math',
'pmml',
'cmml',
'mathtex',
'nodefaultresources',
'preload' => [
'LaTeX.pool',
'article.cls',
'amsmath.sty',
'amsthm.sty',
'amstext.sty',
'amssymb.sty',
'eucal.sty',
'[dvipsnames]xcolor.sty',
'url.sty',
'hyperref.sty',
'[ids]latexml.sty',
'texvc'
],
'linelength': 90
}
|
Réglage pour le rendu LaTeXML pour plus de détails. |
| $wgMathDisableTexFilter | 'new'
|
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 Afficher une formule pour plus de détails. |
| $wgMathEnableExperimentalInputFormats | false
|
Active la prise en charge des formats d’entrée expérimentaux MathML et AsciiMath |
CSS pour le MathML avec le mode de repli SVG
Par défaut, MathML est uniquement exposé aux outils d’accessibilité. Cependant, vous pouvez forcer le rendu visuel avec les Feuilles de style MediaWiki :
.mwe-math-mathml-a11y {
clip: auto !important;
overflow: visible !important;
position: static !important;
width: auto !important;
height: auto !important;
opacity: 1 !important;
}
.mwe-math-fallback-image-inline,
.mwe-math-fallback-image-display {
display: none !important;
}
Vous pouvez alors facilement changer le style des formules MathML par exemple pour définir la police mathématique ː
.mw-body, mtext {
font-family: Latin Modern Roman;
}
math {
font-family: Latin Modern Math;
}
.mw-body, est ajouté pour obtenir la même apparence de police pour tout le texte de l’article. Si vous ne voulez pas changer votre police principale, laissez ceci tel quel. N’oubliez pas de supprimer la virgule, aussi !
CSS pour fond sombre
L’extension rend toujours les formules en texte noir par défaut, ce qui peut rebuter les utilisateurs et les wikis s'exécutant avec une couleur de fond sombre. Un auteur d'habillage peut ajouter le code suivant pour inverser la brillance des images des formules à l’aide des filtres CSS :
.mwe-math-fallback-image-inline,
.mwe-math-fallback-image-display {
filter: hue-rotate(180deg) invert(1);
}