Формулы в формате TeX

Местонахождение: Настройки фильтра "Формулы в формате TeX" находятся в Администрирование > Модули > Фильтры > Настройки фильтров

Фильтр "Формулы в формате TeX" преобразовывает выражения TeX в изображения в формате GIF. Для этого на сервере запускаются специальные программы для создания изображения (либо полная версия LaTeX, либо специальная компактная версия MimeTeX). Версии MimeTeX для Linux, Windows, Mac OS X и FreeBSD включены в стандартную поставку Moodle.

Для отображения формул на клиентских компьютерах не требуется наличия плагинов или другого дополнительного программного обеспечения.

Как использовать?

Чтобы воспользоваться фильтром вставьте формулу в формате TeX между парами знаков доллара. Например:

$$ \sqrt{x + y} $$

С чего начать настройку, или сказка о двух фильтрах

Чтобы не возникало путаницы - предупреждаем заранее, в Moodle используется два различных способа преобразования формул в формате TeX в изображения. Предпочтительным способом является использование трёх исполняемых файлов (latex, dvi2ps и convert), которые потребуется установить и настроить на сервере. Страница настроек фильтра полностью относится именно к этому методу. Однако, если по какой-то причине этот способ не сработал, фильтр попробует запустить один исполняемый файл (mimetex), который идёт вместе с Moodle.

Настройка фильтра для работы с LaTeX

Наилучший результат получается при использовании системы LaTeX для преобразования формул в изображения.

Как это работает?

LaTeX преобразует формулу в dvi-файл. dvi-файл преобразовывается утилитой dvi2ps в файл PostScript. Файл PostScript преобразуется в GIF утилитой Convert из пакета ImageMagick. Для её работы требуется установленный GhostScript.

Установка под Linux

Практически в любой сборке Linux есть возможность установить LaTeX. В большинстве современных дистрибутивов используется его реализация teTex. Кроме этого вам понадобятся ImageMagick и GhostScript. В Ubuntu это можно сделать командой

  apt-get install tetex-base tetex-bin tetex-extra imagemagick ghostscript

Установка под Windows

Самый популярный дистрибутив LaTeX под Windows - это MiKTeX.

Скачать GhostScript можно тут

Скачать ImageMagick можно тут

Внимание! Папки, в которые устанавливается LaTeX и ImageMagick не должны содержать пробелов.

Параметры на странице настроек фильтра

Внимание! Изменение любых настроек фильтра приводит к сбросу кэша, что может резко понизить производительность сервера, если будет сразу запрошено большое количество формул.

LaTeX preamble

Возможность настроить преамбулу документа LaTeX позволяет очень гибко регулировать отображение формул. В преамбуле указывается кодировка документа и все используемые пакеты, такие как amsmath. В преамбуле также можно определить пользовательские стили или команды.

Для корректного отображения формул с русскими символами можно использовать следующую преамбулу:

\usepackage{mathtext}
\usepackage[T2A]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage[russian]{babel}
\usepackage{amsmath}
\usepackage{amsfonts}
\RequirePackage{amsmath,amssymb,latexsym}

Transparent colour

Эта настройка позволяет изменить цвет фона изображения в формуле.

Density

Этот параметр влияет на размер результирующего изображения

Path of latex binary

Путь к исполняемому файлу latex. В Windows указывайте путь без кавычек и пробелов

Path of dvips binary

Путь к исполняемому файлу dvips. Обычно он находится в той же папке, что и latex. В Windows указывайте путь без кавычек и пробелов

Path of convert binary

Путь к исполняемому файлу convert из пакета ImageMagick. В Windows указывайте путь без кавычек и пробелов

В случае, когда фильтр получает доступ к необходимым файлам рядом с ними появится зелёная галочка, в обратном случае - красный крестик.

Настройка фильтра для работы с MimeTeX

MimeTeX - это специальная упрощённая версия TeX, скомпилированная в один исполняемый файл с небольшим набором шрифтов. Она входит в загружаемую версию Moodle и располагается в папке filters/tex. Там есть версии для различных операционных систем. Фильтр выбирает исполняемый файл в зависимости от операционной системы (если ваша операционная система не распознаётся, вам придётся исправлять файлы фильтра). Обратите внимание, что у веб-сервера должны быть выставлены разрешения на запуск исполняемых файлов из этой папки. Иногда из-за этого возникают проблемы.

Внимание! Версия, MimeTeX идущая вместе с Moodle не поддерживает русские символы. Подробнее о том, как быть в этом случае тут

Documentation