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 を使用して変換
MW 1.23以降は Mathoid サーバで MathJax を使いサーバ側の texvc 入力を MathML+SVG 画像生成に変換できます. Mathoid は将来的にウィキペディアで用いられる画像生成モードです. それに関して、以下の設定が推奨されます.

Mathoid を確認し、自分専用の Mathoid サーバ上で実行する手順を探します. MathML 画像生成モードを有効に設定後、データベース更新スクリプトをもう一度実行し、必要なテーブルを作成します.

サーバ側で LaTeXML を使用して変換
LaTeX 画像生成の便利なオプションとして LaTeXML ウェブサービスを利用します. このサービスは LaTeX を高画質 MathML に変換します.


 * 設定 (MW 1.22) 1.23以降のほぼすべての設定が有効です


 * 設定 (MW 1.23 以降)

LaTeXML を自分戦丁野サーバにインストールする短いガイドはこちらを参照してください: Install LaTeXML

LaTeXML 画像生成モードを有効に設定後、データベース更新スクリプトを毛一度実行し、必要なテーブルを作成します.

サーバ側で LaTeX を使用して変換
ローカルのウェブサーバーを使い texvc 入力を PNG 画像に変換するとき、ローカルの LaTeX インストールと OCAML に基づく texvc から LaTeX への変換を行うには、texvcの導入が必要です. 手順は上記を参照してください.

の設定には、必ず 画像生成エンジンを参照します：

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

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

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