Формулы в формате TeX: различия между версиями
(не показано 16 промежуточных версий этого же участника) | |||
Строка 11: | Строка 11: | ||
== С чего начать настройку, или сказка о двух фильтрах == | == С чего начать настройку, или сказка о двух фильтрах == | ||
Чтобы не возникало путаницы - | Чтобы не возникало путаницы - предупреждаем заранее, в Moodle используется два различных способа преобразования формул в формате TeX в изображения. Предпочтительным способом является использование трёх исполняемых файлов (latex, dvi2ps и convert), которые потребуется установить и настроить на сервере. Страница настроек фильтра полностью относится именно к этому методу. Однако, если по какой-то причине этот способ не сработал, фильтр попробует запустить один исполняемый файл (mimetex), который идёт вместе с Moodle. | ||
== Настройка фильтра для работы с LaTeX== | == Настройка фильтра для работы с LaTeX== | ||
Наилучший результат получается при использовании системы LaTeX для преобразования формул в изображения. LaTeX преобразует формулу в dvi-файл. dvi-файл преобразовывается утилитой dvi2ps в файл [http://ru.wikipedia.org/wiki/PostScript PostScript]. Файл PostScript преобразуется в GIF утилитой Convert из пакета [http://ru.wikipedia.org/wiki/ImageMagick ImageMagick]. Для её работы требуется установленный [www.ghostscript.com GhostScript]. | Наилучший результат получается при использовании системы LaTeX для преобразования формул в изображения. | ||
===Как это работает?=== | |||
LaTeX преобразует формулу в dvi-файл. dvi-файл преобразовывается утилитой dvi2ps в файл [http://ru.wikipedia.org/wiki/PostScript PostScript]. Файл PostScript преобразуется в GIF утилитой Convert из пакета [http://ru.wikipedia.org/wiki/ImageMagick ImageMagick]. Для её работы требуется установленный [http://www.ghostscript.com GhostScript]. | |||
=== Установка под Linux === | === Установка под Linux === | ||
Строка 22: | Строка 25: | ||
=== Установка под Windows === | === Установка под Windows === | ||
Самый популярный дистрибутив LaTeX под Windows - это [http://www.miktex.org/ MiKTeX]. | Самый популярный дистрибутив LaTeX под Windows - это [http://www.miktex.org/ MiKTeX]. | ||
Скачать ImageMagick можно в | |||
Скачать GhostScript можно [http://sourceforge.net/projects/ghostscript/ тут] | |||
Скачать ImageMagick можно [http://www.imagemagick.org/ тут] | |||
Внимание! Папки, в которые устанавливается 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== |
Текущая версия от 08:08, 28 мая 2011
Местонахождение: Настройки фильтра "Формулы в формате 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 не поддерживает русские символы. Подробнее о том, как быть в этом случае тут