Extension:SimpleMathJax/fr

From testwiki
Jump to navigation Jump to search

<languages /> Template:Extension 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

Template:ExtensionInstall

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 Template:Tag
(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 Template:Removed-inline
(remplacé par $wgSmjEnableMenu)
0.6.1 $wgSmjSize 110 Template:Removed-inline
(remplacé par $wgSmjScale)
0.6.1 $wgSmjInlineMath [] Template:Removed-inline
(remplacé par $wgSmjExtraInlineMath)
0.6.1 $wgSmjDisableChem false Template:Removed-inline
(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']
Template:Removed-inline
(remplacé par $wgSmjUseCDN)
peut utiliser des scripts locaux ou distants
(par défaut pour utiliser cloudflare CDN)
0.6 $wgSimpleMathJaxSize 125 Template:Removed-inline
(remplacé par $wgSmjSize)
0.6 $wgSimpleMathJaxUseCDN true Template:Removed-inline
(remplacé par $wgSmjScripts)
0.6 $wgSimpleMathInlineMath [] Template:Removed-inline
(remplacé par $wgSmjInlineMath)

Si vous souhaitez modifier la taille de la police, définissez Template:Phpi comme ci-dessous.

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

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

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

Si vous souhaitez utiliser le module local, définissez Template:Phpi 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
Autres exemples

Voir aussi

Liens externes

Template:Used by

[[Category:TeX{{#translation:}}]] [[Category:Math display extensions{{#translation:}}]]