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を設定すると、レンダリングに使用できる出力モードの名前を持つ配列が保持されます. If multiple modes are enabled, logged-in users can set a personal preference in the appearance pane of their user preferences page.

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

Mathoid
モード: 'mathml'

You can use Mathoid, an application that uses MathJax on the server side to convert texvc input to MathML+SVG rendering. This is the most recommended option; Mathoid is the Math rendering mode used on Wikipedia.



Mathoid をサービスとして提供する
"Mathoid as a service" is the recommended approach for the Math extension, and the default one. If you do not add any additional settings to LocalSettings.php, Math will use the Beta cluster's Mathoid and services to do all math formula rendering. The default settings are:

You can modify these settings in order use different Mathoid and RESTBase services, potentially including your own.



Mathoidの CLI インターフェース
You can instead run Mathoid as a command-line utility on the local server. To use this approach, the following settings are recommended:

LaTeX
モード: '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'

LaTeXML ユーティリティを使用. The rendering is done via an online service (set with $wgLaTeXMLUrl, which has a default value of https://latexml.formulasearchengine.com/convert).



解析処理をしない
モード: '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.



ヒントとトリック

 * 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. 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 Integral article. Afterwards you need to bypass your browser cache so that the new created images of the formulas are actually downloaded.



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



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

下位ページ


関連項目

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