TeXフィルタは、tex式をGIF、PNG、またはSVG画像に変換できるようにすることを目的としたコアMoodleフィルタです。フィルタは、適切なトークンの間に含まれる式に対してこれを実現するために、いくつかの追加のバイナリに依存しています。これらのバイナリが利用できない場合、MoodleはMimetexの使用によるフォールバックを提供します。 Linux用のMimeTex(glib2.3 32ビット)、Windows、Mac OS X、FreeBSDのバージョンがMoodleディストリビューションに含まれています。 Texを表示するために利用できる他のテクノロジーがあります(議論については数学ツールのセクションを参照してください)。
注:バイナリに基づいているため、3つのPHPプログラム実行関数を使用できる必要があります。exec
、 shell_exec
そしてsystem
。
メソッドと使用法
混乱を避けるために、TeXフィルタにはTeX表記法を画像に変換するための2つの別々の方法があることに注意してください。推奨される方法は、インストール(多くのウェブホストがこれらを利用可能にしているが、まだ存在していない場合)とサーバでの構成を担当する3つのバイナリのコレクションです。フィルタ設定ページは、この方法に完全に関連しています。何らかの理由でこれが失敗した場合、フィルタは単一のバイナリ(MimeTeX)にフォールバックします。 Mimetexとその兄であるMathTexは、システム管理の経験があれば、コンパイルとインストールが簡単ですが、一般的なオペレーティングシステムのMoodleディストリビューションにはさまざまなビルドが含まれています。
他のことをする前に、 設定 > サイト管理 > プラグイン > フィルタ、でTeX表記法フィルタをアクティブにする必要があります。代数フィルタは実際にはTexフィルタの "フロントエンド" にすぎないため、代数フィルタ(別のコアフィルタ)を使用する場合は、代数フィルタもオンにする必要があります。代数フィルタの詳細については、代数フィルタを参照してください。
フィルタがオンになり、適切に構成されたら、次の方法で使用できます。 2つのドル記号で区切られたTeX式を含みます。例:
$$ \sqrt{x + y} $$
これが正しく表示されない場合は、デバッグに関する情報を参照してください。
MimeTeX
Moodleは、dvips、convert、latexバイナリに適切にアクセスできない場合、フォールバックとしてビルド済みのMimeTeXバイナリ(filters/texディレクトリにあります)を使用する場合があります。オペレーティングシステムごとに異なるバージョンがいくつかあります。 TeXフィルタは、検出されたホストオペレーティングシステムに適切なバイナリを選択します(オペレーティングシステムが含まれていない場合は、スクリプトをハックする必要があります)。 Webサーバは、その場所でバイナリを実行するための適切な権限を設定する必要があることに注意してください。
MimeTeXマニュアルは入手可能ですが、おそらくシステム管理の経験がある人を対象としており、Moodle環境を特に扱っていません。
MimeTeXは、完全なLaTeXシステムのインストールに失敗した場合、またはシステムでバイナリを使用できない場合にのみ使用してください。結果はそれほど良くありません。
MathJaxとの互換性
Moodle 2.8以降では、TeX表記法とMathJaxloaderフィルタを組み合わせて使用できます。ページで両方のフィルタが有効になっている場合、画像は最初にTeX表記法フィルタによって表示され、MathJaxバージョンのTeX式は、しばらくしてMathJaxの読み込みと処理が終了したときに置き換えられます。両方のフィルタが使用可能な場合、教師は一方を有効にし、もう一方を無効にすることで、活動でどちらを使用するかを決定できます。
サイト管理設定
場所:設定 > サイト管理 > プラグイン > フィルタ >フィルタ設定 のTeX表記法設定リンク
TeXフィルタ設定ページは、主にLaTeXレンダラの動作を調整することを目的としています。 3つのパス設定のデフォルトは、Moodleが実行されているオペレーティングシステムの検出に応じて選択されます。これらは単に提案された一般的な値です - Moodleはバイナリが実際にこれらの場所に存在することをチェックしません。 Moodleの最近のバージョンでは、パス設定の横に緑色のチェックマークまたは赤い十字が表示されます。これは、バイナリがその場所に存在することを示しています(のみ)。この設定は、MimeTexバイナリの動作には影響しません(これらのバイナリのいずれかが見つからない場合に使用されます)。
バイナリのインストール
これはプラットフォームによって異なりますが、通常のインストールではLaTeXの実装が必要になります。最新のLinux実装では、Windowsバージョンが利用可能ですが、 'texlive' パッケージ(例:apt-get install texlive )を探す必要があります(Tex Liveを参照)。これらすべてのバイナリが標準インストールの一部として含まれる可能性はほとんどありません。 texliveが見つからない場合は、LaTeX、Ghostscript、ImageMagickを個別にインストールする必要があります。 Moodle.orgによって承認されていませんが、Windows用のシンプルなインストールバイナリはMikTeX。
フィルタ設定ページは、検出されたプラットフォームに応じて、バイナリファイルの最も可能性の高い場所を推測しようとします。正しければ、各設定に対して緑色のチェックマークが表示されます。赤い十字が表示された場合は、必要に応じて設定を確認および変更する必要があります。指定されたパスにバイナリが存在するかどうかを確認するために、簡単なチェックが行われます。結果として、目盛りまたは十字がそれぞれの横に表示されます。これは、アプリケーションが実際に機能するかどうかをチェックするのではなく、そこにあることだけをチェックすることに注意してください。
一部のシステムは、フォントを個別のパッケージとして提供します。問題が発生した場合は、必要なすべてのフォントがインストールされていることを確認してください。必要な数学フォントを取得するには、'追加' フォントパッケージを追跡する必要がある場合があります。
LaTeXプリアンブル
LaTeXプリアンブルを指定できるようにします。デフォルトはほとんどのユーザで機能するはずですが、ラテン文字以外の文字セットなどをサポートするように変更する必要がある場合があります。詳細については、LaTeXのドキュメントを参照してください。
透明色
これは、通常のテキストの背景色に設定する必要があります。デフォルト設定は#FFFFFF(つまり白)です。
密度
この設定は、結果の画像のサイズに影響します。デフォルト設定は120ピクセルで、適度な品質の画像を生成しますが、一部の複雑な方程式では、これでも十分でない場合があります。それ以下のものでは十分な品質の画像が生成されない可能性がありますが、ページがレンダリングされるときに画像サイズはTeXエンコーディングによって制御できます。
latex バイナリのパス
標準のlatexバイナリへのパス。
Unixベースのシステムでは、通常は "/usr/bin/latex" です。 MacOS Xでは、パスは "/usr/texbin/" です。
Windowsでは、MiKTeXを使用すると、通常はC:\texmf\miktex\bin\latex.exeのようになります。
dvips バイナリのパス
標準のdvipsバイナリへのパス - 通常、LaTeXシステムの一部として配布されます。
Unixベースのシステムでは、通常は "/usr/bin/dvips" です。 MacOS Xでは、パスは "/usr/texbin/" です。
Windowsでは、MikTeXを使用すると、通常、C:\texmf\miktex\bin\dvips.exeのようになります。
変換 バイナリのパス
標準の変換バイナリへのパス。ラテックスとdvipsのバイナリを使用してGIFまたはPNG画像を作成する必要があります。これは、GhostscriptシステムまたはLinuxのImageMagickの一部として配布されます。
Unixベースのシステムでは、通常は "/usr/bin/convert" です。 MacOS Xでは、パスは "/usr/local/bin/" です。
WindowsベースのPCでは、パスはC:\Program Files\ImageMagick\convert.exeのようなものです(ImageMagickの場合ですが、GhostScriptの場合は別のものです)。
dvisvgm バイナリのパス
このバイナリは、SVG画像を生成するために変換の代わりに使用されます。これはLinux上のTeXliveの一部として配布されますが、完全または追加のパッケージをインストールする必要がある場合があります。
Unixベースのシステムでは、通常は "/usr/bin/dvisvgm" です。
WindowsベースのPCでは、コンパイルされたバイナリはsourceforgeから入手でき、ラテックスバイナリと同じディレクトリに配置できます。
mimetex バイナリのパス
これが空白で、上記のバイナリが欠落しているか失敗した場合、TeXフィルタはMoodleで配布されているmimetexバイナリを使用しようとします。サーバにmimetexをインストールしていて、それを使用したい場合は、ここにパスを含めてください。
TeXフィルタのデバッグ
TeXフィルタには、問題が発生した場合に役立つデバッグスクリプト(デバッグをオンにするとはるかに役立ちます)が含まれています。 URLは次のようになります...
http://your.moodle.path/filter/tex/texdebug.php
このパスを明示的に入力するか、適切なロールのアクセス許可を使用して、TeXイメージ(またはデバッグが必要な場合は誤ってレンダリングされたテキスト)がこれにリンクします。 Moodleの最新バージョンでは、この機能にアクセスするために管理者としてログインする必要があります。
関連項目
- TeXフィルタ用語集 - 用語集コースに詳細を追加できますサポートされているTeX表記法の使用法。
- LaTeX - LaTeXドキュメント準備システム。
- ghostscript - 画像のレンダリングに必要
- MimeTeXマニュアル - デフォルトのTeX表記法マニュアル
- MikTeX - Windowsシステム用のLaTeX
- ImageMagick - Windows用の画像をレンダリングするために必要
- TeX表記法の使用
- Advanced Maths Tools for Moodle2.x - 参照 - 次世代のTeXツール
- 数学ツールフォーラム moodle.org