Extensão:SimpleMathJax

Manual de extensões do MediaWiki

SimpleMathJax Estado de lançamento: estável
Implementação	Etiqueta
Descrição	Permite mostrar fórmulas matemáticas no estilo matemático do MediaWiki
Autor(es)	jmnote, vedmaka, jamesmontalvo3, badshah400
Última versão	0.8.4 (2023-11-04)
MediaWiki	1.29+
Alterações à base de dados	Não
Licença	Licença MIT
Transferência	GitHub: project page git repository URL [help ] commit history Note: No localisation updates are provided by translatewiki.net . README
Exemplo	zetawiki.com
Parâmetros $wgSmjUseCdn $wgSmjUseChem $wgSmjDisplayMath $wgSmjExtraInlineMath $wgSmjScale $wgSmjEnableMenu $wgSmjDisplayAlign $wgSmjWrapDisplaystyle
Hooks utilizados ParserFirstCallInit
Public wikis using	909 (Ranked 270th)

A extensão SimpleMathJax usa MathJax, uma biblioteca JavaScript, para a composição de fórmulas TeX no MediaWiki, em ambientes matemáticos. 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.

Instalação

• Download e coloque o ficheiro, ou ficheiros, num diretório chamado SimpleMathJax, na sua pasta extensions/.
• Acrescente o seguinte código ao fundo do ficheiro $LocalSettings:

  wfLoadExtension( 'SimpleMathJax' );
  

• If necessary configure at your convenience
•  Pronto – Na página especial Special:Version da sua wiki verifique se a extensão foi instalada.

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.

Parâmetros de configuração

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	Descrição
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	(removed) (replaced by $wgSmjEnableMenu)
0.6.1	$wgSmjSize	110	(removed) (replaced by $wgSmjScale)
0.6.1	$wgSmjInlineMath	[]	(removed) (replaced by $wgSmjExtraInlineMath)
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 $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

Comparação

• en:user:Jmkim dot com/TeX Samples (rendering with wikipedia math engines, English)
• ko:user:Jmkim dot com/TeX 샘플 (rendering with wikipedia math engines, Korean)
• http://zetawiki.com/wiki/TeX_샘플 (rendering with SimpleMathJax)

Mais exemplos

• http://zetawiki.com/wiki/TeX_문법 (Gramática)
• http://zetawiki.com/wiki/TeX_행렬 (Matrix)
• http://zetawiki.com/wiki/TeX_특수문자 (Caracteres especiais)
• http://zetawiki.com/wiki/Mhchem_테스트 (chem tags)

Ver também

• Extension:Math

External links

• Using MathJax version 3