Extension:SimpleMathJax

MediaWiki 拡張機能マニュアル

SimpleMathJax リリースの状態: 安定
実装	タグ
説明	MediaWiki の数式スタイルを含む MathJax を使用して、数式をレンダリングできるようにする
作者	jmnote, vedmaka, jamesmontalvo3, badshah400
最新バージョン	0.8.4 (2023-11-04)
MediaWiki	1.29+
データベースの変更	いいえ
ライセンス	MIT ライセンス
ダウンロード	GitHub: プロジェクトのページ git リポジトリの URL [ヘルプ ] コミット履歴 注: 地域化の更新は translatewiki.net からは提供されません。 README
例	zetawiki.com
パラメーター $wgSmjUseCdn $wgSmjUseChem $wgSmjDisplayMath $wgSmjExtraInlineMath $wgSmjScale $wgSmjEnableMenu $wgSmjDisplayAlign $wgSmjWrapDisplaystyle
使用するフック ParserFirstCallInit
使用中の公開ウィキ	909 (Ranked 270th)

SimpleMathJax 拡張機能は JavaScript ライブラリMathJaxを使用して MediaWiki の内でmathタグ形式をTeX数式で表現してくれます。 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.

インストール

• ダウンロードして、ファイルをextensions/フォルダー内のSimpleMathJaxという名前のディレクトリ内に配置します。
• 以下のコードを LocalSettings.php ファイルの末尾に追加します:

  wfLoadExtension( 'SimpleMathJax' );
  

• If necessary configure at your convenience
•  完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

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.

環境設定

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™.

バージョン	設定名	既定値	説明
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	(除去済) ($wgSmjEnableMenu に置き換えられました)
0.6.1	$wgSmjSize	110	(除去済) ($wgSmjScale に置き換えられました)
0.6.1	$wgSmjInlineMath	[]	(除去済) ($wgSmjExtraInlineMath に置き換えられました)
0.6.1	$wgSmjDisableChem	false	(除去済) ($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']	(除去済) ($wgSmjUseCDN に置き換えられました) can use local or another remote scripts ( defaults to use cloudflare CDN )
0.6	$wgSimpleMathJaxSize	125	(除去済) ($wgSmjSize に置き換えられました)
0.6	$wgSimpleMathJaxUseCDN	true	(除去済) ($wgSmjScripts に置き換えられました)
0.6	$wgSimpleMathInlineMath	[]	(除去済) ($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);

サンプル

比較

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

その他の例

• http://zetawiki.com/wiki/TeX_문법 (文法)
• http://zetawiki.com/wiki/TeX_행렬 (行列)
• http://zetawiki.com/wiki/TeX_특수문자 (特殊文字)
• http://zetawiki.com/wiki/Mhchem_테스트 (chem tags)

関連項目

• Extension:Math

外部リンク

• Using MathJax version 3