Extension:Math/ja

Math拡張機能は、数式を表現するためのサポートを提供します. この拡張機能で現在できることの概要は、m:Help:数式の表示にあります.

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



数式の表示
The type of output depends on the software that you use to read the page. 可能な場合、Math 拡張機能が MathML を出力します. それ以外の場合は、文字を &lt;path> 要素に変換した 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を設定すると、レンダリングに使用できる出力モードの名前を持つ配列が保持されます. 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 to 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を利用せずに、別の方法でウィキ上で数式の解析サポートを提供するには