Extension:SimpleMathJax

This page is a translated version of the page Extension:SimpleMathJax and the translation is 93% complete.
Manuel des extensions MediaWiki
OOjs UI icon advanced-invert.svg
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.2 (2021-01-01)
MediaWiki 1.29+[1]
Modifications de
la base de données
Non
Licence Licence MIT
Téléchargement
README
Exemple zetawiki.com

  • $wgSmjUseCdn
  • $wgSmjUseChem
  • $wgSmjDisplayMath
  • $wgSmjExtraInlineMath
  • $wgSmjScale
  • $wgSmjEnableMenu
  • $wgSmjDisplayAlign
  • $wgSmjWrapDisplaystyle

Vérifier la matrice des utilisations et des versions.

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

Pour les utilisateurs de MediaWiki 1.24 ou précédents :

Les instructions ci-dessus décrivent la nouvelle procédure pour installer cette extension en utilisant wfLoadExtension(). Si vous avez besoin d'installer cette extension sur les précédentes versions de MediaWiki (1.24 ou antérieur), à la place de wfLoadExtension( 'SimpleMathJax' );, vous devez utiliser :

require_once "$IP/extensions/SimpleMathJax/SimpleMathJax.php";

Or you can git clone.

$ git clone https://github.com/jmnote/SimpleMathJax.git

If you want to use local MathJax scripts (and not a CDN), then you can use git clone recursive. In most cases, CDN is much faster than your server. However, a CDN may not be available if you have a hardened PHP installation due to disabled_functions restrictions.

$ git clone --recursive 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

Notez

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 à 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