Extension:SimpleMathJax

Manuel des extensions MediaWiki

SimpleMathJax État de la version : stable
Implémentation	Balise
Description	Permet de visualiser via MathJax des formules mathématiques écrites dans le style math de MediaWiki
Auteur(s)	jmnote, vedmaka, jamesmontalvo3, badshah400
Dernière version	0.8.4 (2023-11-04)
MediaWiki	1.29+
Modifie la base de données	Non
Licence	Licence MIT
Téléchargement	GitHub: page du projet URL du dépôt git [aide ] historique des validations Note : Aucune mise à jour de localisation n'est fournie par translatewiki.net . README
Exemple	zetawiki.com
Paramètres $wgSmjUseCdn $wgSmjUseChem $wgSmjDisplayMath $wgSmjExtraInlineMath $wgSmjScale $wgSmjEnableMenu $wgSmjDisplayAlign $wgSmjWrapDisplaystyle
Accroches utilisées ParserFirstCallInit
Utilisé par les wikis publics	909 (Ranked 270th)

L'extension SimpleMathJax active MathJax, une librairie JavaScript, pour visualiser les formules mathématiques TeX dans l'environnement MediaWiki math. Cette extension chargera les ressources à partir de cdn.jsdelivr.net sur toutes les pages wiki qui ont des balises mathématiques ou chimiques.

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

Avantages

• Simple
• Légère
• Compatible UTF-8
• Utilisable sur un mobile
• Taille de police définissable
• Prise en charge de la balise chem pour la chimie
• Prise en charge de l'ajout de paires de symboles inlineMath
• Style MediaWiki ! Voir les exemples.

Installation

• Téléchargement et placez le(s) fichier(s) dans un répertoire appelé SimpleMathJax dans votre dossier extensions/.
• Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :

  wfLoadExtension( 'SimpleMathJax' );
  

• Configurer à votre convenance si nécessaire.
•  Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Ou bien vous pouvez cloner à partir de Git.

$ git clone --depth 1 https://github.com/jmnote/SimpleMathJax.git

Si vous voulez utiliser les scripts locaux MathJax (et non pas un CDN), vous pouvez utiliser le clonage récursif de Git. Dans la plupart des cas, CDN est plus rapide que votre serveur. Néanmoins un CDN peut ne pas être disponible si vous avez une installation PHP renforcée, à cause des restrictions disabled_functions.

$ git clone --depth 1 --recursive --shallow-submodules https://github.com/jmnote/SimpleMathJax.git

SimpleMathJax se propose d'être une alternative à l'extension Math. Si l'installation MathJax est installée, elle peut être prioritaire et rendre SimpleMathJax non opérationnelle. Le chargement de l'extension SimpleMathJax est la seule opération nécessaire pour visualiser des équations.

Paramètres de configuration

Les variables suivantes peuvent être définies dans LocalSettings.php après avoir appelé wfLoadExtension( 'SimpleMathJax' );. Notez que pour un simple site, il suffit d'ajouter $wgSmjScale = 1.1; pour qu'il fonctionne™.

Version	Nom du paramètre	Valeur par défaut	Description
0.7.0+	$wgSmjUseCdn	true	Utiliser un CDN (ressources chargées depuis un autre site) ou une ressource locale
0.7.0+	$wgSmjUseChem	true	activer les balises ‎<chem> (par défaut pour utiliser les balises chem)
0.8.0+	$wgSmjEnableMenu	true	Rendre le menu contextuel MathJax disponible Ce paramètre est manquant depuis la 0.8.0; ce serait une erreur
0.8.0+	$wgSmjExtraInlineMath	[]	permet d'ajouter des paires de symboles inlineMath supplémentaires
0.8.1+	$wgSmjScale	1	La taille de la police par défaut pour SimpleMathJax.
0.7.4	$wgSmjShowMathMenu	false	(supprimé) (remplacé par $wgSmjEnableMenu)
0.6.1	$wgSmjSize	110	(supprimé) (remplacé par $wgSmjScale)
0.6.1	$wgSmjInlineMath	[]	(supprimé) (remplacé par $wgSmjExtraInlineMath)
0.6.1	$wgSmjDisableChem	false	(supprimé) (remplacé par $wgSmjUseChem)
0.6.1	$wgSmjScripts	['//cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-AMS-MML_HTMLorMML', '//cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/extensions/TeX/mhchem.js']	(supprimé) (remplacé par $wgSmjUseCDN) peut utiliser des scripts locaux ou distants (par défaut pour utiliser cloudflare CDN)
0.6	$wgSimpleMathJaxSize	125	(supprimé) (remplacé par $wgSmjSize)
0.6	$wgSimpleMathJaxUseCDN	true	(supprimé) (remplacé par $wgSmjScripts)
0.6	$wgSimpleMathInlineMath	[]	(supprimé) (remplacé par $wgSmjInlineMath)

Si vous souhaitez modifier la taille de la police, définissez $wgSmjScale comme ci-dessous.

wfLoadExtension( 'SimpleMathJax' );
$wgSmjScale = 1.5;

Si vous souhaitez activer des paires de symboles inlineMath supplémentaires, définissez $wgSmjExtraInlineMath comme ci-dessous.

wfLoadExtension( 'SimpleMathJax' );
$wgSmjExtraInlineMath = [ [ "$", "$" ], [ "\\(", "\\)" ] ];

Si vous souhaitez utiliser le module local, définissez $wgSmjUseCdn comme ci-dessous.

wfLoadExtension( 'SimpleMathJax' );
$wgSmjUseCdn = false;

SimpleMathJax et Live Preview (versions < 0.8.0)

Avant la version 0.8.0, les éléments suivants devaient être ajoutés dans MediaWiki:Common.js afin que l'aperçu en direct dans l'éditeur affiche la sortie mathématique rendue au lieu du code source brut LaTeX :

function waitForMathJax($content) {
  if (typeof MathJax === 'undefined') {
    setTimeout(function () { waitForMathJax($content); }, 1000);
  } else {
    MathJax.Hub.Queue(["Typeset", MathJax.Hub, $content[0]]).execute();
  }
}

mw.hook('wikipage.content').add(waitForMathJax);

Exemples

Comparaison

• en:user:Jmkim dot com/TeX Samples (rendu des moteurs mathématiques de Wikipedia, anglais)
• ko:user:Jmkim dot com/TeX 샘플 (rendu des moteurs mathématiques de Wikipedia, coréen)
• http://zetawiki.com/wiki/TeX_샘플 (rendu de SimpleMathJax)

Autres exemples

• http://zetawiki.com/wiki/TeX_문법 (Grammaire)
• http://zetawiki.com/wiki/TeX_행렬 (Matrice)
• http://zetawiki.com/wiki/TeX_특수문자 (Caractères spéciaux)
• http://zetawiki.com/wiki/Mhchem_테스트 (balises chem)

Voir aussi

• Extension:Math

Liens externes

• Utiliser MathJax version 3