Extension:Math/ja

Math拡張機能は、数式を表現するためのサポートを提供します. この拡張機能で現在できることの概要は、英語版ウィキペディアのドキュメントにあります.

古いバージョンを含め、この拡張機能のインストールと設定に関する詳細はにあります.

数式の表示
Math拡張機能は、MathMLをSVGまたはPNG画像にそれぞれフォールバックして出力しようとします. 使用しているデバイスの機能に応じて、出力の種類が選択されます. 基本的な数式のサポートはどのブラウザでも機能します. ただし最適な解析を行うには、以下のような特定の調整が必要かもしれません：


 * FirefoxやGeckoを使用している他のブラウザでは、ネイティブMathML拡張機能と算術フォントをインストールする必要があります. アクセシビリティサポートは、NVDA、VoiceOverまたはOrcaによって提供されます.  これらに加えて、NVDAで数式を読み取るには、 MathPlayerプラグインが必要です.
 * Safariその他の WebKit を使用するブラウザーでは、ネイティブの MathML レンダリングを有効にするには数式フォントをインストールし、ブラウザー設定のカスタム スタイルシートにいくつかの CSS ルールを挿入します.

アクセシビリティサポートはVoiceOverスクリーンリーダーで提供されますが、まだOrcaでは提供されていません.


 * Chrome では、ChromeVox によるアクセシビリティ支援や MathJax プラグイン 経由の視覚的レンダリングを利用するには、ブラウザの設定のカスタム スタイルシートにいくつかの CSS ルールを挿入する必要があります.
 * いくつかのバージョンの Internet Explorer では、MathPlayer を支援技術として使用できます.

インストール
You should additionally go to the page Special:MathStatus to see whether all of the components of the Math extension now work. 何か問題が発生した場合は、https://phabricator.wikimedia.org にタスクを作成することをお勧めします

残念ながら、とのインストールについては、Math拡張機能を使用するための十分にテストされたガイドはありませんが、少なくとも作業用のドラフトはあります. に貢献してください.

さらに、MW1.28にRestbaseとMathoidをインストールしてセットアップするためのガイドがあります.

数式の出力モード
$wgMathValidModesを設定すると、レンダリングに使用できる出力モードの名前を持つ配列が保持されます. 複数のモードが有効になっている場合、ログインしているユーザーは、自分の個人設定ページの表示から設定できます.

$wgDefaultUserOptions設定を使用して、これらのモードのどれをデフォルトにするかを設定することもできます. 例:

Mathoid
モード: 'mathml' (pre-July 2015: MW_MATH_MATHML)

MW 1.23以上の場合、MathJaxを使用するMathoidサーバーを使用して、サーバー側のtexvc入力をMathML+SVGレンダリングに変換できます. これが最も推奨されるオプションです. Mathoidは将来Wikipediaで使用されるレンダリングモードです.

Mathoid をサービスとして提供する
Mathoidをサービスとして提供してパフォーマンス上の利点を得るには、次の設定をお勧めします.

独自のMathoidサーバーを実行する方法については、Mathoidを参照してください. 2017年3月現在の注記事項として、これにはさらにRESTbaseサーバ/インストールが必要な場合があります (を参照してください. )

Mathoidの CLI インターフェース
Mathoidの CLI インターフェース利用は設定が簡単で、永続的なメモリ消費を避けることができ、パフォーマンスは低下するものの、次の設定をお勧めします.

LaTeX
モード: 'png' (pre-July 2015: MW_MATH_PNG)

このモードは設定に最も手間がかかり、最低でもtexvcユーティリティをインストールして作動させる必要があり、理想的にはtexvccheckのインストールもお奨めしています. インストール方法は両方ともを参照してください.

LaTeXML
モード: 'latexml' (pre-July 2015: MW_MATH_LATEXML)

LaTeXML ユーティリティを使用. オンラインサービスを経由して解析処理します (既定値のある$wgLaTeXMLUrlとともに設定. )

解析処理をしない
モード: 'source', (pre-July 2015: MW_MATH_SOURCE)

This mode will forward the Latex input without rendering, presenting it in a element, surrounded by $ :formula $.

Make sure to set $wgMathDisableTexFilter to 'always' (see below) if you only want the raw latex formula, else an error will appear due to the failed check for PNG depictions.

MathJax
モード: MW_MATH_MATHJAX

このモードではクライアント側の解析にMathJaxアプリケーションを使用します. 現在、これは非推奨となり、実行するには MediaWiki 1.25 以前が必要です. 使用方法は、を参照してください.

ヒントとトリック

 * FirefoxのアドオンMathML コピーを使うと、数式を Microsoft Wordなど他のアプリケーションに (video)、g(Math)プラグインを使うとGoogle docs (video) にそれぞれ転写できます.
 * 個人設定と既定の解析モードをオーバーライドするには、 $$ 要素に 変数を追加し、例えば画像を強制的に ...$$ でレンダリングさせます.

エラーの報告
数式拡張機能でなにか問題が発生した場合は、Phabricatorに報告をお願いします. さらに、CoverageTestページから生成される自動化単体テストと、発生した問題に関連があるかどうか、点検する必要があります.

更なる情報
古いバージョンの情報ならびにその他の情報はで確認します.

関連項目

 * - texvcやLaTeXanを利用せずに、別の方法でウィキ上で数式の解析サポートを提供するには
 * - texvcの説明
 * もう一つの方法とは:
 * - texvcの説明
 * もう一つの方法とは:
 * もう一つの方法とは:
 * もう一つの方法とは: