Extension:Math/advancedSettings/ja

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

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

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

シェルアクセスが制限された共有ホスト
On a shared host with limited command line access, (e.g. under jailshell) compiling with all the dependencies won't be possible. As a workaround compiling texvc will have to be done offline. Use  to identify the OS of the shared host, and install the same offline. This can be done via a USB boot drive, live CD, virtual machine on a desktop PC or whichever you prefer. Then for example in Ubuntu, all dependencies can be installed using:

Get the Math extension and make texvc etc.:

Upload the  archive to the host and extract the required files  into the $IP/extensions/Math folder.

To test texvc is working (see texvc usage), e.g.:

シェルアクセスが無制限の共有ホスト
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 数式の書式も自由に変更可能で、たとえば数式用フォントの設定ができます.