Extension:SimpleMathJax/cs

Category:MIT licensed extensions/cs
Příručka k rozšířením MediaWiki
SimpleMathJax
Stav rozšíření: stabilníCategory:Stable extensions/cs
Implementace Značka Category:Tag extensions/cs
Popis Umožňuje vykreslovat matematické vzorce pomocí MathJax s matematickým stylem MediaWiki
Autoři jmnote, vedmaka, jamesmontalvo3, badshah400
Nejnovější verze 0.8.4 (2023-11-04)
MediaWiki 1.29+[1]Category:Extensions with manual MediaWiki version
Změny v databázi Ne
Licence Licence MIT
Stáhnout Category:Extensions in GitHub version control/cs
README
Příklad zetawiki.com
  • $wgSmjUseCdn
  • $wgSmjUseChem
  • $wgSmjDisplayMath
  • $wgSmjExtraInlineMath
  • $wgSmjScale
  • $wgSmjEnableMenu
  • $wgSmjDisplayAlign
  • $wgSmjWrapDisplaystyle
Veřejné wiki používající rozšíření 909 (Ranked 270th)
Category:All extensions/cs

The SimpleMathJax extension enables MathJax, a JavaScript library, for typesetting TeX formula in MediaWiki inside math environments. This extension will load resources from cdn.jsdelivr.net 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

Or you can git clone.

$ git clone --depth 1 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 --depth 1 --recursive --shallow-submodules 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

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

Version Setting name Default value Description
0.7.0+ $wgSmjUseCdn true Using CDN or Local resource
0.7.0+ $wgSmjUseChem true enable <chem> tags
( defaults to use chem tags )
0.8.0+ $wgSmjEnableMenu true Make MathJax context menu available
This setting is missed since 0.8.0; it would be a mistake
0.8.0+ $wgSmjExtraInlineMath [] can add some additional inlineMath symbols pairs
0.8.1+ $wgSmjScale 1 The default font size for SimpleMathJax
0.7.4 $wgSmjShowMathMenu false (odstraněno)
(replaced by $wgSmjEnableMenu)
0.6.1 $wgSmjSize 110 (odstraněno)
(replaced by $wgSmjScale)
0.6.1 $wgSmjInlineMath [] (odstraněno)
(replaced by $wgSmjExtraInlineMath)
0.6.1 $wgSmjDisableChem false (odstraněno)
(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']
(odstraněno)
(replaced by $wgSmjUseCDN)
can use local or another remote scripts
( defaults to use cloudflare CDN )
0.6 $wgSimpleMathJaxSize 125 (odstraněno)
(replaced by $wgSmjSize)
0.6 $wgSimpleMathJaxUseCDN true (odstraněno)
(replaced by $wgSmjScripts)
0.6 $wgSimpleMathInlineMath [] (odstraněno)
(replaced by $wgSmjInlineMath)

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

wfLoadExtension( 'SimpleMathJax' );
$wgSmjScale = 1.5;

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

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

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

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

SimpleMathJax and Live Preview (versions < 0.8.0)

Prior to version 0.8.0, the following had to be added to MediaWiki:Common.js in order to have the Live Preview in the editor show rendered math output instead of raw LaTeX source code:

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);

Samples

Comparison

:

More examples

:

See also

Category:TeX/cs Category:Math display extensions/cs
  1. SimpleMathJax 0.8.0+ uses manifest_version 2. Příručka:Extension.json/Schéma
Category:All extensions/cs Category:Extensions in GitHub version control/cs Category:Extensions included in Canasta/cs Category:Extensions included in MyWikis/cs Category:Extensions with manual MediaWiki version Category:MIT licensed extensions/cs Category:Math display extensions/cs Category:ParserFirstCallInit extensions/cs Category:Stable extensions/cs Category:Tag extensions/cs Category:TeX/cs