Макропакет mdroff

Макропакет mdroff предназначен для форматирования и генерации в PostScript/PDF текстовых документов. В первую очередь mdroff разрабатывался для подготовки текстов технической документации, дипломов, курсовых и диссертаций. О других возможных применениях этого макропакета стоит сообщить авторам и поместить сведения на эту страницу.

Настройка и запуск

Mdroff работает на любой версии ОС Unix, если имеются следующие установленные программы:

1. GNU troff (Groff);
2. GNU Awk.

• В: ПотолицынАлександр сообщал, что mdroff удалось запусть на ОС Windows в окружении Cygwin. Может ли кто-то добавить подробностей?

Последняя версия исходных текстов mdroff находится на http://github.com/gsitkarev/mdroff. Проще всего склонировать дерево Git локально так:

 $ git clone https://github.com/gsitkarev/mdroff.git

После выполнения команды в текущем каталоге появится каталог mdroff/ с файлами макропакета.

 $ pwd
 /home/user
 $ ls -1 mdroff
 contrib
 examples
 LICENSE
 mdroff
 README.md
 tmac
 $

Далее следует отредактировать расположение файлов макропакета в файлe mdroff/mdroff:

 MDTMACPATH=/home/sitkarev/Projects/git/mdroff/tmac
 #MDTMACPATH="tmac/"

В переменной MDTMACPATH нужно указать абсолютный путь к каталогу mdroff/tmac/.

Для поддержки кириллических шрифтов нужно установить файлы метрик и переносов.

• В: Кто допишет как и где их взять и куда положить?

После того, как файлы метрик и переносов скопированы, для проверки можно отформатировать один из примеров:

 $ cd mdroff
 $ ./mdroff examples/example.tr -Tps >/tmp/out.ps

В файле examples/example.tr находится пример исходного текста документа. Вывод форматирования перенаправляется в файл /tmp/out.ps как PostScript. Этот же исходный текст можно получить в виде PDF файла:

 $ ./mdroff examples/example.tr -Tpdf >/tmp/out.pdf

Если в выходном файле отсутствуют кириллические глифы, то, скорее всего, это произошло потому, что не установлена переменная окружения LC_ALL:

 $ LC_ALL=ru_RU.UTF-8 ./mdroff examples/example.tr -Tps >/tmp/out.pdf

Это связано с тем, что mdroff использует эту переменную для определения перекодировочного метода в `iconv`(1).

Кто из учащихся уже использовал mdroff?

Как минимум, одна курсовая работа сдавалась студентом СыктГУ. Для генерации титульной страницы а также настроек документа (отступы, поля и т. п.) разработан стандартный шаблон, соответствующий требованиям университета.

• В: Может быть стоит выложить ссылку на исходный текст курсовой работы? Я даже знаю, что это сделает ПипуныровЕгор :-D