Extension:SimpleMathJax

From MediaWiki.org
Jump to: navigation, search
Translate this page; This page contains changes which are not marked for translation.

Other languages:
català • ‎Deutsch • ‎English • ‎español • ‎suomi • ‎français • ‎italiano • ‎日本語 • ‎한국어 • ‎Nederlands • ‎polski • ‎português • ‎português do Brasil • ‎sicilianu • ‎Tiếng Việt • ‎中文
MediaWiki extensions manualManual:Extensions
Crystal Clear action run.png
SimpleMathJax

Release status:Extension status stable

ImplementationTemplate:Extension#type Tag
DescriptionTemplate:Extension#description Allows to render mathematical formulas using MathJax with MediaWiki math style
Author(s)Template:Extension#username jmnote, vedmaka, jamesmontalvo3, badshah400
Latest versionTemplate:Extension#version 0.7.1 (2018-02-01)
MediaWikiTemplate:Extension#mediawiki 1.25+
Database changesTemplate:Extension#needs-updatephp No
LicenseTemplate:Extension#license GNU General Public License 3.0
Download
README
ExampleTemplate:Extension#example zetawiki.com
ParametersTemplate:Extension#parameters
  • $wgSmjSize
  • $wgSmjUseCDN
  • $wgSmjUseChem
  • $wgSmjInlineMath
Hooks usedTemplate:Extension#hook
ParserFirstCallInitManual:Hooks/ParserFirstCallInit

Translate the SimpleMathJax extension if it is available at translatewiki.net

Check usage and version matrix.

The SimpleMathJax extension enables MathJax, a Javascript library, for typesetting TeX formula in MediaWiki inside math environments. This extension will load resources from cdnjs.cloudflare.com on all wiki pages that have math or chem tags.

<math>E=mc^2</math>
Advantages
  • Simple
  • Lightweight
  • UTF-8 Support
  • Mobile View OK
  • Setting Font Size
  • chem tag support for chemistry
  • additional inlineMath symbols pairs support
  • MediaWiki Style! Look at the samples.

Installation[edit]

  • Download and place the file(s) in a directory called SimpleMathJax in your extensions/ folder.

To users running MediaWiki 1.24 or earlier:

The instructions above describe the new way of installing this extension using wfLoadExtension() If you need to install this extension on these earlier versions (MediaWiki 1.24 and earlier), instead of wfLoadExtension( 'SimpleMathJax' );, you need to use:

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 not CDN but local mathjax scripts, you can use git clone recursive. ( In most cases, CDN is much faster than your server. )

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

SimpleMathJax is meant to be used as an alternative to the Math extension. If the Math extension is installed it may take precedence and cause SimpleMathJax to not work. The SimpleMathJax extension is the only thing you need to start rendering equations.

Configuration settings[edit]

The following variables can be defined in LocalSettings.php after calling wfLoadExtension( 'SimpleMathJax' );. Note that for a simple site adding $wgSmjSize = 110; might be all you need to make it Just Work™.

Version Setting name Default value Description
0.6.1+ $wgSmjSize 110 The default font size for SimpleMathJax
0.7.0+ $wgSmjUseCDN true Using CDN or Local resource
0.7.0+ $wgSmjUseChem true enable <chem> tags
( defaults to use chem tags )
0.6.1+ $wgSmjInlineMath [] can add some additional inlineMath symbols pairs
0.6.1 $wgSmjDisableChem false removed
(replaced by $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']
removed
(replaced by $wgSmjUseCDN)
can use local or another remote scripts
( defaults to use cloudflare CDN )
0.6 $wgSimpleMathJaxSize 125 removed
(replaced by $wgSmjSize)
0.6 $wgSimpleMathJaxUseCDN true removed
(replaced by $wgSmjScripts)
0.6 $wgSimpleMathInlineMath [] removed
(replaced by $wgSmjInlineMath)

If you want to change font size, set $wgSmjSize like below.

wfLoadExtension( 'SimpleMathJax' );
$wgSmjSize = 150;

If you want to enable some additional inlineMath symbol pairs, set $wgSimpleMathJaxInlineMath like below.

wfLoadExtension( 'SimpleMathJax' );
$wgSmjInlineMath = [["$","$"],["\\(","\\)"]];

If you want to use local module, set $wgSmjUseCDN like below.

wfLoadExtension( 'SimpleMathJax' );
$wgSmjUseCDN = false;

Samples[edit]

Comparison
More examples

See also[edit]

External links[edit]