The SimpleMathJax extension enables MathJax, a Javascript library, for typesetting TeX formula in MediaWiki inside math environments. It requires MediaWiki 1.43 or later.
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, then set
$wgSmjCdnEnabled = false(see$wgSmjCdnEnabled).
$ git clone --recursive https://github.com/jmnote/SimpleMathJax.git
- LocalSettings.php
wfLoadExtension( 'SimpleMathJax' );
| Setting name | Default value | Description | Custom value example |
|---|---|---|---|
$wgSmjCdnEnabled |
true |
Whether to load MathJax from a CDN | false |
$wgSmjCdnVersion |
'4' |
MathJax version to load from the CDN | '4.1.3' |
$wgSmjScale |
1 |
MathJax.chtml.scale |
1.5 |
$wgSmjEnableMenu |
true |
MathJax.options.enableMenu |
false |
$wgSmjExplorerEnabled |
false |
Whether to enable MathJax's accessibility explorer (click/keyboard exploration, speech, Braille) | true |
$wgSmjDelimitersEnabled |
false |
Whether to also scan for bare delimiters (e.g. $...$) outside <math>/<chem> |
true |
$wgSmjDelimitersInlineMath |
[] |
Inline math delimiter pairs | [['$','$']] |
$wgSmjDelimitersDisplayMath |
[] |
Display math delimiter pairs | [['$$','$$']] |
$wgSmjAllowedAttributes |
[] |
List of generic HTML attributes to carry over to the output <span> |
['class', 'title'] |
$wgSmjIgnoreHtmlClass |
'mathjax_ignore|comment|diff-(context|addedline|deletedline)' |
MathJax.options.ignoreHtmlClass |
'mathjax_ignore|comment|diff-(context|addedline|deletedline)|my_custom_class' |
$wgSmjRevisionOverrides |
[] |
Switch the configuration according to the article's revision | [['max'=>1048576,'wgSmjScale'=>1.5]] |
See docs/configuration.md for a detailed walkthrough of each
setting, with usage examples. Upgrading from before 1.0.0? See the
migration guide for what to change in your
LocalSettings.php.
See docs/displaystyle.md for the <math display>
rendering modes and examples.
Need to keep another extension (e.g. Lingo) from interfering with MathJax's
rendering? See Hooks in the configuration
guide for the SimpleMathJaxAttributes hook.