The SimpleMathJax extension enables MathJax, a Javascript library, for typesetting TeX formula in MediaWiki inside math environments.
https://www.mediawiki.org/wiki/Extension:SimpleMathJax
- git clone in extensions directory
- Using CDN is recommended. Because it's much faster than using local resources in most cases. ("the benefits of using a CDN")
$ git clone https://github.com/jmnote/SimpleMathJax.git- (Optional) If you want to use not CDN but local mathjax scripts, you can use git clone recursive.
$ git clone --recursive https://github.com/jmnote/SimpleMathJax.git- LocalSettings.php
wfLoadExtension( 'SimpleMathJax' );| Setting name | Description | default value | custom value example |
|---|---|---|---|
$wgSmjUseCdn |
use CDN or local scripts | true | false |
$wgSmjUseChem |
enable chem tag | true | false |
$wgSmjEnableMenu |
MathJax.options.enableMenu | true | false |
$wgSmjDisplayMath |
MathJax.tex.displayMath | [] | [['$$','$$'],['\[','\]']] |
$wgSmjExtraInlineMath |
MathJax.tex.inlineMath | [] | [['\(', '\)']] |
$wgSmjIgnoreHtmlClass |
MathJax.options.ignoreHtmlClass | "mathjax_ignore|comm..." | "mathjax_ignore" |
$wgSmjScale |
MathJax.chtml.scale | 1 | 1.5 |
$wgSmjDisplayAlign |
MathJax.chtml.displayAlign | center | left |
$wgSmjWrapDisplaystyle |
wrap with displaystyle | true | false |
If you want to change font size, set $wgSmjScale.
wfLoadExtension( 'SimpleMathJax' );
$wgSmjScale = 1.5;If you want to use local module, set $wgSmjUseCdn.
wfLoadExtension( 'SimpleMathJax' );
$wgSmjUseCdn = false;If you want to enable some extra inlineMath symbol pairs, set $wgSmjExtraInlineMath. Pairs of [math][/math] are always in-line math delimiters.
wfLoadExtension( 'SimpleMathJax' );
$wgSmjExtraInlineMath = [["$","$"],["\\(","\\)"]];Since version 0.8.7, inlineMath and blockMath and environments are ignored in edit summaries and diffs. To restore the previous behavior (especially if you are using maths in edit summaries), set $wgSmjIgnoreHtmlClass.
wfLoadExtension( 'SimpleMathJax' );
$wgSmjIgnoreHtmlClass = "mathjax_ignore";If you want to disable MathJax context menu, set $wgSmjEnableMenu.
wfLoadExtension( 'SimpleMathJax' );
$wgSmjEnableMenu = false;The hook SimpleMathJaxAttributes is available to add attributes to the span around the math. (Note that this process is performed only for <math> elements, and other delimiters are handled directly by MathJax.) This hook provides you with the opportunity to ensure that your own code does not interfere with MathJax's rendering of math.
For instance, if Lingo's JS functions are called before MathJax is invoked, then it is possible that Lingo will change the text so that MathJax could no longer render the math.
Lingo understands that it should not touch anything inside an element with the class noglossary so the following code can be used to keep Lingo from ruining math:
$wfHook['SimpleMathJaxAttributes']
= function ( array &attributes, string $tex ) {
$attributes['class'] = 'noglossary';
}
