Jump to content

Extension:MathJax

From mediawiki.org
Not to be confused with Extension:Math.
MediaWiki extensions manual
MathJax
Release status: unmaintained
Implementation Extended syntax
Description Allows math rendering for TeX/LaTeX with the JavaScript library MathJax, including LaTeX style formula references.
Author(s)
Latest version 1.1 (2019-05-01)
MediaWiki 1.26+
License GNU General Public License 3.0
Download

The MathJax extension enables MathJax, a JavaScript library, for typesetting TeX and LaTeX formulae in MediaWiki inside math environments. The following math environments are defined for inline style math:

  • $$...$$
  • \(...\)
  • ‎<math>...‎</math>

And the following math environments are defined for display style math:

  • \[...\]
  • \begin{...}...\end{...}
  • ‎<math>...‎</math>

MathJax produces nice and scalable mathematics, see their website (http://www.mathjax.org/) for a demonstration. This extension also enables the usage of \label{} and \eqref{} tags with automatic formula numbering. If needed you can still hand label by using \tag{}.

Installation

[edit]
  • Download and place the file(s) in a directory called MathJax in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'MathJax' );
    # Change default font size (default: 100)
    // $wgMjSize = 100;
    # Use local MathJax installation (default: false, use CDN)
    // $wgMjUseCDN = true;
    # If you want to use local CDN (put parameter above false), then you need to download the MathJax-folder in this repo: https://github.com/mathjax/MathJax/tree/2965eab516910550491f895322bc181f1d24ca5a and place it with the name "MathJax" into the "modules" folder of the "MathJax" extension folder. (This note can be removed by the maintainer of this extension, once this MathJax-folder is added to the download repo.)
    
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Comparison with previous versions

[edit]

It seems that almost all functionality of previous version, especially auto numbering and equation referencing, can be directly implemented by MathJax. This extension simply keeps math expressions in an article from being parsed by MediaWiki so that MathJax could do the last minute rendering.

Following the previous versions by Dirk Nuyens, I kept <nomathjax></nomathjax> tag that actually is nothing but <span class="tex2jax_ignore"></span> from MathJax with the code inside being parsed as usual.

The dollar($) symbol in non-mathematical context can be escaped as \$.

Usage

[edit]

This extension allows for typical LaTeX math integration, with the exception that single dollar $ must be replaced with double dollars $$. For example:

<!-- some LaTeX macros we want to use: -->
$$\newcommand{\Re}{\mathrm{Re}\,}
\newcommand{\pFq}[5]{{}_{#1}\mathrm{F}_{#2} \left( \genfrac{}{}{0pt}{}{#3}{#4} \bigg| {#5} \right)}$$

We consider, for various values of $$s$$, the $$n$$-dimensional integral
\begin{align}
  \label{def:Wns}
  W_n (s)
  &:= 
  \int_{[0, 1]^n} 
    \left| \sum_{k = 1}^n \mathrm{e}^{2 \pi \mathrm{i} \, x_k} \right|^s \mathrm{d}\boldsymbol{x}
\end{align}
which occurs in the theory of uniform random walk integrals in the plane, 
where at each step a unit-step is taken in a random direction.  As such, 
the integral \eqref{def:Wns} expresses the $$s$$-th moment of the distance 
to the origin after $$n$$ steps.

By experimentation and some sketchy arguments we quickly conjectured and 
strongly believed that, for $$k$$ a nonnegative integer
\begin{align}
  \label{eq:W3k}
  W_3(k) &= \Re \, \pFq32{\frac12, -\frac k2, -\frac k2}{1, 1}{4}.
\end{align}
Appropriately defined, \eqref{eq:W3k} also holds for negative odd integers. 
The reason for \eqref{eq:W3k} was  long a mystery, but it will be explained 
at the end of the paper.

(Which comes from a preprint of Jon M. Borwein, et. al. Some arithmetic properties of short random walk integrals.)

This renders as http://www.cs.kuleuven.be/~dirkn/Extension_MathJax/MathJaxExample.png.

Change log

[edit]
0.5 (20101116)
Initial public release.
0.5.1 (20101201)
Modifications to allow integration with Extension:Semantic_MediaWiki.
Compatability code for Parser::MARKER_SUFFIX added.
0.5.2 (20110203)
Kind of revert move away from the markers used by MW as it does no really matter which ones we use (so no need for the SMW fix from 0.5.1 anymore).
Allowed \label and \tag at the same time as one would expect.
Added clickable links for the formula references, this currently assumes the used label or tag is a valid XHTML id.
0.5.2b (20110215)
Removed redundant comma's in the MathJax configuration hub file to please IE...
0.6 (20120418)
Updates for MediaWiki 1.18 (tested with 1.18.2) and MathJax 2.0, amonst others incorporating a patch from EvanChou (thanks!) and the CDN modification of Evan. This is mainly a maintenance update to get the extension back on track for 1.18.2.
0.7 (20120422)
Complete rewrite, $ and $$ can now be turned on and off, much better protection and detection, numbering is consistent among different environments, no global variables anymore (everything is now in one class), new tag <nomathjax>, magic words to turn on and off features: __MATHJAX__ and __NOMATHJAX__, __MATHJAX_NUMBER__ and __MATHJAX_NONUMBER__, __MATHJAX_DOLLAR__ and __MATHJAX_NODOLLAR__, and __MATHJAX_DOLLARDOLLAR__ and __MATHJAX_NODOLLARDOLLAR__.
1.0 (2015)
Version before archival in 2017.
1.1 (20190501)
Restored. Update for MediaWiki 1.27, using script loading method done in extension Extension:SimpleMathJax. Disable support for $...$. Use Cloudflare CDN by default. Configuration parameter for font size.

See also

[edit]