Макропакет mdroff

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

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

Для запуска mdroff требуются следующие программы:

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

Последняя версия исходных текстов 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

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

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

• В: Может быть стоит выложить ссылку на исходный текст курсовой работы?