Extension:Math/ja

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

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

数式の表示
Math 拡張機能は、MathML を SVG (文字を &lt;path> に変換) または PNG (least preferentially) 内の画像にそれぞれフォールバックして出力しようとします.

基本的な数式のサポートはすべてのブラウザーで機能します. ただし最適なレンダリングを行うには、以下のような特定の調整が必要かもしれません:


 * 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月現在の注記事項として、これにはさらに サーバー/インストールが必要な場合があります (を参照してください. )

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

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

Since MediaWiki 1.32, this mode will also require a Mathoid server to work. In older versions, it requires installing texvc and texvccheck, which may require the most setup work.

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.

カテゴリの追跡
The extension creates a number of tracking categories to detect errors and deprecated features. The exact name of the categories is determined by pages in the MediaWiki namespace.

ヒントとトリック
To force the re-rendering of all formulas of a page, purge using the  action. For example the URL https://en.wikipedia.org/w/index.php?title=Integral&action=purge&mathpurge=true will force re-rendering of the Integer article. Afterwards you need to bypass your browser cache so that the new created images of the formulas are actually downloaded.
 * FirefoxのアドオンMathML コピーを使うと、数式を Microsoft Wordなど他のアプリケーションに (video)、g(Math)プラグインを使うとGoogle docs (video) にそれぞれ転写できます.
 * 個人設定と既定の解析モードをオーバーライドするには、 $$ 要素に 変数を追加し、例えば画像を強制的に ...$$ でレンダリングさせます.
 * All images of rendered formula are stored in a cache and not automatically recreated if the page is viewed or edited.

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

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

関連項目

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