TeX記法フィルター

TeXフィルタは、テキスト表現をGIF、PNG、またはSVG画像に変換できるようにすることを目的とした、コアのMoodleフィルタです。フィルタは、適切なトークン間に含まれる式に対してこれを実現するために、いくつかの追加のバイナリに依存しています。これらのバイナリが利用できない場合、MoodleはMimetexの使用による代替を提供します。 Moodleディストリビューションには、Linux(glib2.3 32bit)、Windows、Mac OS X、およびFreeBSD用のMimeTexのバージョンが含まれています。 Texを表示するために利用可能な他の技術があります(議論については数学ツールに関するセクションを見てください)。

:バイナリをベースにしているため、3つのPHPプログラム実行関数を使用できる必要があります。
執行部
 shell_exec 
そして
システム

方法と使い方

混乱を避けるために、TeXフィルタにはTeX表記をイメージに変換するための2つの別々の方法があることに注意してください。推奨される方法は、3つのバイナリを集めて(それらがまだ存在していない場合は、多くのWebホストで利用可能になりますが)サーバー上で設定することです。フィルタ設定ページは完全にこのメソッドに関連しています。これが何らかの理由で失敗した場合、フィルタは単一のバイナリ - MimeTeXにフォールバックします。一般的なオペレーティングシステム向けのMoodleディストリビューションには、さまざまなビルドが含まれていますが、Mimetexとその兄弟であるMathTexは、システム管理経験があればコンパイルおよびインストールが簡単です。

それ以外のことをする前に、あなたは設定>サイト管理>プラグイン>フィルタに行き、TeX記法フィルタを有効にする必要があります。代数フィルタは実際にはTexフィルタの「フロントエンド」にすぎないため、代数フィルタ(別のコアフィルタ)を使用する場合は、代数フィルタもオンにする必要があります。代数フィルターの詳細については参照の代数フィルタを

フィルタがオンになり正しく設定されたら、二重ドル記号で区切られたTeX式を含めることでそれを利用できます。例:

 $$ \ sqrt {x + y} $$

これが正しく表示されない場合は、デバッグに関する情報を参照してください。

MimeTeX

Moodleがdvips、convert、およびlatexバイナリに適切にアクセスできない場合は、(フィルタ/ texディレクトリにある)ビルド済みのMimeTeXバイナリを代替として使用することができます。異なるオペレーティングシステムには、さまざまなバージョンがあります。 TeXフィルタは、検出されたホストオペレーティングシステム用の適切なバイナリを選択します(オペレーティングシステムが含まれていない場合は、スクリプトをハッキングする必要があります)。その場所でバイナリを実行するには、Webサーバーに適切な権限を設定する必要があります。

MimeTeXマニュアルは利用可能ですが、おそらくシステム管理経験のある人を対象としており、Moodle環境には特に言及していません。

LaTeXシステム全体のインストールに失敗した場合、またはバイナリがあなたのシステムで利用できない場合にのみ、MimeTeXを使うべきです。結果はそれほど良くありません。

MathJaxとの互換性

Moodle 2.8以降では、TeX表記法とMathJaxloaderフィルタを組み合わせて使用することができます。両方のフィルタがページ上で有効になっている場合、画像は最初にTeX表記法フィルタによって表示され、MathJaxバージョンのTeX式はしばらく経ってからMathJaxのロードと処理が終了します。両方のフィルタが利用可能である場合、教師は一方を有効にし、他方を無効にすることによって活動でどちらを使用するかを決定できます。

サイト管理設定

場所: [設定]> [サイトの管理]> [プラグイン]> [フィルタ]> [フィルタの管理]にある[ TeX表記法の設定]リンク

TeXフィルタ設定ページは主にLaTeXレンダラの動作を調整することを目的としています。 3つのパス設定のデフォルトは、Moodleが実行されているオペレーティングシステムの検出に従って選択されます。これらは単に推奨される一般的な値です - Moodleはバイナリが実際にこれらの場所に存在することを確認しません。最近のバージョンのMoodleでは、パス設定の隣に緑色のチェックマークまたは赤い十字が表示されます - これはバイナリがその場所にのみ存在することを示しています(のみ)。この設定は、MimeTexバイナリ(これらのバイナリのいずれかが見つからない場合に使用される)の動作には影響しません。

バイナリをインストールする

これはあなたのプラットフォームに依存します、しかし典型的なインストールのためにあなたはLaTeX実装が必要になるでしょう。最近のLinuxの実装では、Windows版もありますが( Tex Live参照)、 'texlive'パッケージ(例えばapt-get install texlive )を探すべきです。標準インストールの一部としてこれらすべてのバイナリが含まれることはほとんどありません。 texliveが見つからない場合は、LaTeX、Ghostscript、およびImageMagickを別々にインストールする必要があります。 Moodle.orgによって承認されていませんが、Windows用の簡単なインストールバイナリはMikTeXです。

フィルタ設定ページは、検出されたプラットフォームに応じて、バイナリファイルの最も可能性の高い場所を推測しようとします。正しければ、各設定に対して緑色のチェックマークが表示されます。赤い十字が表示された場合は、必要に応じて設定を確認および変更する必要があります。指定されたパスにバイナリが存在するかどうかを確認するための簡単なチェックが行われます。その結果、目盛りまたは十字がそれぞれの横に表示されます。これは、アプリケーションが実際に動作していることを確認するのではなく、そこにあることだけを確認します。

一部のシステムではフォントを個別のパッケージとして提供しています。問題がある場合は、必要なフォントがすべてインストールされていることを確認してください。必要な数学フォントを取得するには、「追加の」フォントパッケージを追跡する必要があります。

LaTeXプリアンブル

LaTeXプリアンブルを指定可能にします。デフォルトはほとんどのユーザにとってうまくいくはずですが、ラテン文字以外の文字セットなどをサポートするように変更する必要があるかもしれません。詳細についてはLaTeXのドキュメントを参照してください。

透明色

これは通常のテキストの背景色に設定する必要があります。デフォルト設定は#FFFFFF(つまり白)です。

密度

この設定は、結果の画像のサイズに影響します。デフォルト設定は120ピクセルです、そしてそれは適度な品質のイメージを作り出します、しかし若干の複雑な方程式のために、これはまだ十分でないかもしれません。それ以下では十分な品質の画像を生成することはできませんが、ページがレンダリングされるときの画像サイズはTeXエンコーディングによって制御できます。

ラテックスバイナリのパス

標準ラテックスバイナリへのパス。

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画像を生成するためにconvertの代わりにこのバイナリが使用されます。これはLinux上のTeXliveの一部として配布されていますが、完全または追加のパッケージをインストールする必要があるかもしれません。

Unixベースのシステムでは、通常 "/ usr / bin / dvisvgm"です。

WindowsベースのPCでは、コンパイルされたバイナリがsourceforgeから入手でき、ラテックスバイナリと同じディレクトリに配置できます。

mimetexバイナリのパス

これが空白で上記のバイナリが見つからないか失敗した場合、TeXフィルタはMoodleで配布されているmimetexバイナリの使用を試みます。サーバーにmimetexをインストールしていてそれを使用する場合は、ここにパスを含めてください。

TeXフィルターのデバッグ

TeXフィルタにはデバッグスクリプト(あなたがmoodleデバッグをオンにするともっと役に立つでしょう)が含まれていて、それはあなたが問題を抱えているなら助けになるでしょう。 URLは以下のようになります...

 http://your.moodle.path/filter/tex/texdebug.php

このパスを明示的に入力するか、適切なロールのアクセス許可を使用して、TeXイメージ(デバッグが必要な場合はテキストのレンダリングが正しくない可能性が高い)をリンクすることができます。 Moodleの最近のバージョンでは、この機能にアクセスするには管理者としてログインする必要があります。

関連情報