Extension:Math/advancedSettings/ja

数式拡張機能はtexvcその他のバックエンドを利用し、数式のレンダリングをサポートします. この拡張機能で現在、何ができるかについては数式の表示にまとめてあります.

texvc のインストール
サーバ側で LaTeX から PNG に変換するには、以下のステップに従います.

texvc について
TeXバリデーター兼コンバーターtexvc は数式を入力するとフォーマットし、HTMLやMathML、PNG画像として出力します. 入力データは安全のため解析して精査します.

シェルアクセスが制限された共有ホスト
共有ホストでコマンドラインからのアクセスに制限がある場合 (たとえばjailshell 配下) すべての依拠関係を使ったコンパイルは不可能です. 回避策としてtexvcのコンパイルはオフラインで行う必要があるはずです. を使用して共有ホストのOSを識別し、オフラインで同様にインストールします. 実行には好みにより USB ブートドライブかライブ CD あるいはデスクトップコンピュータの仮想マシンを使用します. その後、たとえば Ubuntu では依存関係のあるインストールを次の手順で行います.

Math 拡張機能を入手し texvc その他を作成：

アーカイブをホストにアップロードし、必要なファイルを$IP/extensions/Math フォルダに抽出します.

texvc が稼動しているかどうか試験する方法の例 (texvc 利用を参照)：

シェルアクセスが無制限の共有ホスト
texvcとtexvccheckを変換：

(仮想) プライベートサーバの場合
Linux の配布によってはMediaWiki Mathパッケージにtexvcとtexvccheckが同梱されています.

配布に含まれる拡張機能の比較.

たとえば Debian や Ubuntu ではこれとともに依存関係のあるパッケージをインストールします：

(MediaWikiMath、texvcとtexvccheck) もしくは

(texvc限定)

設定
設定は必ず の後に置き、MW_MATH_XXX 定数が未定義になるのを防ぎます.

クライアント側で MathJax を使用して変換
Math拡張機能は1.19/1.20以降、クライアント側の JavaScript ライブラリである MathJax を使う処理をサポートし、によるレンダリングをサポートします. ブラウザのHTML + CSS、MathML、またはSVGのネイティブサポートを使用してラテックスコードまたはmathmlコードを解析し、ブラウザ内で数式を生成します.

これは数式をより鮮明に（サブピクセルレンダリングを使用して）レンダリングしたりより大きく (ズーム、印刷と高解像度画面用に拡大) できます.

$wgUseMathJaxを設定して MathJax レンダリングモードを有効にします. ただ現状ではまだ実験段階といえます. 利用者は個人設定ページのチェックボックスで MathJax を有効にしたり、以下のように既定モードに設定できます.


 * 設定 (MW 1.19 - 1.22)


 * 設定 (MW 1.23 - 1.25)

MathJaxのコンテキストメニューを変更する方法How to modify the MathJax contextual menuも参照してください.


 * MathJax を強制的に唯一の画像生成オプションとする (MW 1.23以降)

もしご利用のウィキで MathJax が唯一の画像生成モードである場合、これを強制的に有効にするには上記の処理の代わりに、LocalSettings.php に下記を追加してください.

これにより既定で匿名利用者全員とMath拡張機能用に保存された設定のない利用者に対し MathJax を有効にします. 注記として、登録利用者が別の画像生成モードを選択してあった場合には、各自で[個人設定] > [表示] と選択し、強制的な設定を選択してから[保存] を押し、有効にします. 数式を表示するには JavaScript を有効にする必要があることは、記事において利用者に助言する必要があります (たとえば TeX 数式を含む記事のテンプレートを使う).

サーバ側で MathJax を使用して変換
Beginning from MW 1.23+ you can use a Mathoid server that uses MathJax to convert texvc input on the server side to MathML+SVG rendering. Mathoid is the rendering mode that is going to be used on future Wikipedia. For that the following settings are recommended:

Check out Mathoid to find instructions how to run your own Mathoid server. After enabling the MathML rendering mode you have to run the database update script again to create the required table.

サーバ側で LaTeXML を使用して変換
A convenient option to render LaTeX is to use the LaTeXML web service. This service converts LaTeX to high quality MathML.


 * Settings (MW 1.22) most or all of the 1.23+ settings also work


 * 設定 (MW 1.23 以降)

A short guide to install LaTeXML on your own server can be found here: Install LaTeXML

After enabling the LaTeXML rendering mode you have to run the database update script again to create the required table.

サーバ側で LaTeX を使用して変換
To use your local webserver to convert the texvc input to PNG images via a local LaTeX installation and OCAML based translation from texvc to LaTeX you have to install texvc; see above for how to do that.

Settings in  should refer to the   rendering engine:

すべての環境設定一覧
を呼び出した後、LocalSettings.phpに以下の変数を定義します.

CSS で MathML に SVG フォールバックモードを設定
MathML は既定ではアクセシビリティのツールからしか見えない設定です. しかしながら以下のスタイルを指定し、強制的にレンダリングを視覚化できます.

すると MathML 数式の書式も自由に変更可能で、たとえば数式用フォントの設定ができます.