Extension:SimpleMathJax

From mediawiki.org
This page is a translated version of the page Extension:SimpleMathJax and the translation is 100% complete.
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+[1]
Modifie la base
de données
Non
Licence Licence MIT
Téléchargement
README
Exemple zetawiki.com

  • $wgSmjUseCdn
  • $wgSmjUseChem
  • $wgSmjDisplayMath
  • $wgSmjExtraInlineMath
  • $wgSmjScale
  • $wgSmjEnableMenu
  • $wgSmjDisplayAlign
  • $wgSmjWrapDisplaystyle
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

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
Autres exemples

Voir aussi

Liens externes

  1. SimpleMathJax 0.8.0+ uses manifest_version 2. Manuel:Extension.json/Schéma