Extension:Math/advancedSettings

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:Math/advancedSettings and the translation is 97% complete.

L’extension Math fournit un support pour le rendu des formules mathématiques sur-wiki via Mathoid et d’autres moteurs. Un aperçu de ce qui peut actuellement être fait avec cette extension se trouve à the English Wikipedia’s documentation.

Avertissement Avertissement : Information about configurating the extension in older MediaWiki versions is removed from this page. It may be found in the page history.


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 trouver des instructions pour exécuter 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é ici: Install 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 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";:

Sur les pages individuelles pour ces paramètres, il est dit obsolète dans 1.18, puisque cette extension a été séparée du noyau mediawiki dans cette version. Si vous avez installé l’extension, ces paramètres s’appliquent indépendamment
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 Le chemin URL du répertoire mathématique. Par défaut à "{$wgUploadPath }/math".
$wgMathDirectory false Le 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 mathoid server.
$wgMathMathMLTimeout 20 Le délai d’attente pour la requête HTTP envoyée au MathML pour rendre 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 le $wgMathLaTeXMLUrl: [1]

Si vous prévoyez une charge importante, 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: $wgMathLaTeXMLUrl = [ 'http://latexml.example.com/convert', 'http://latexml2.example.com/convert' ];

$wgMathLaTeXMLTimeout 240 Délai d’exécution de la requête HTTP envoyée au LaTeXML pour rendre 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 LaTeXML renderer 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 Help:Displaying a formula pour plus de détails.
$wgMathEnableExperimentalInputFormats false Prend en charge les 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 MediaWiki stylesheets:

.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 ex. pour définir la police mathː

.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 tel quel. N’oubliez pas de supprimer la virgule, ainsi!

CSS pour fond sombre

L’extension rend toujours les formules en texte noir par défaut, ce qui peut jeter les utilisateurs et les wikis exécutant une couleur de fond sombre. Un auteur de peau peut ajouter le code suivant pour inverser la légèreté des images de formule à l’aide de filtres CSS:

.mwe-math-fallback-image-inline,
.mwe-math-fallback-image-display {
    filter: hue-rotate(180deg) invert(1);
}
La teinte-rotation maintient les teintes à peu près constantes, de sorte que les couleurs restent un peu utiles. This solution is nowhere near being final. See the linked task and other tickets linked to it for more information.