Разница между 1.41
и текущей версией
MdroffFormatter.
@@ -1,33 +1,32 @@
-- Макропакет mdroff
+= Макропакет mdroff
Макропакет mdroff предназначен для форматирования и генерации текстовых документов ''''''PostScript'''''' и PDF. В первую очередь mdroff разрабатывался для подготовки текстов технической документации, дипломов, курсовых и диссертаций. О других возможных применениях этого макропакета стоит сообщить авторам и поместить сведения на эту страницу.
--- Настройка и запуск
+- Настройка и запуск
Mdroff работает на любой версии ОС Unix, если установлены и работают следующие программы:
1 GNU troff (Groff);
1 GNU Awk.
---- Для пользователей Debian
+-- Для пользователей Debian
Пользователям дистрибутивов, основанных на ОС GNU/Linux Debian, достаточно убедиться, что установлены пакеты groff и gawk. По умолчанию устанавливается только минимальный пакет для форматирования man-страниц groff-base.
$ sudo apt-get install groff gawk
---- Для пользователей Cygwin под Windows
+-- Для пользователей Cygwin под Windows
-Установщик сygwin представляет из себя одновременно менеджер пакетов, и установку дополнительных пакетов я предлагаю делать с помощью него.
+С помощью инсталлятора cygwin установить следующие пакеты: groff, awk, ghostscript, ghostscript-fonts-std, iconv-devel.
-Дополнительный файлы, которые будут упомянуты ниже, можно найти в репозитории mdroff.
+Переустановить пакет preconv. Необходимо, потому что по умолчанию preconv собран без поддержки iconv, а после установки iconv-devel эта поддержка в preconv появится.
- 1 Установить groff, awk, ghostscript, ghostscript-fonts-std, iconv-devel;
- 1 Переустановить preconv. Нужно это из-за того, что без iconv-devel preconv собирается без поддержки iconv (это можно увидеть, выполнив ``preconv '''-v'''``). А preconv без поддержки iconv нормально в mdroff не работает;
- 1 Создать Fontmap для шрифтов ghostscript'а, установленных пакетом ghostscript-fonts-std. Сами шрифты расположены чаще всего в ''/usr/share/fonts/type1''. Fontmap рекомендую, за неимением лучшего, в эту же директорию со шрифтами.
-[Здесь должен быть код для генерации файла Fontmap]
+Сгенерировать файл Fontmap для шрифтов из пакета ghostscript-fonts-std:
+ $ grep -a \/''''''FontName'''''' /usr/share/fonts/type1/*.pfb | sed 's!^(.\+\.pfb\):/''''''FontName'''''' \(/[^[:space:]]\+\).*$!\2 (\1) ;!' > /usr/share/fonts/type1/Fontmap
--- Исходные тексты
+
+- Исходные тексты
Последняя версия исходных текстов mdroff находится на http://github.com/gsitkarev/mdroff. Проще всего склонировать дерево Git локально так:
@@ -67,7 +66,7 @@
Метрики для других семейств шрифтов ''''''PostScript'''''' (в mdroff используются шрифты семейства Times New Roman) пользователь может генерировать самостоятельно утилитой ''afmtodit''(1).
--- Проверка работоспособности
+- Проверка работоспособности
После того, как файлы метрик и переносов скопированы, для проверки можно отформатировать один из примеров:
@@ -79,13 +78,13 @@
Если в выходном файле отсутствуют кириллические глифы, то, скорее всего, это произошло потому, что не установлена переменная окружения LC_ALL:
- $ LC_ALL=ru_RU.UTF-8 ./mdroff -Tps examples/example.tr >/tmp/out.pdf
+ $ LC_ALL=ru_RU.UTF-8 ./mdroff -Tps examples/example.tr >/tmp/out.ps
Это связано с тем, что mdroff использует эту переменную для определения перекодировочного метода в ''iconv''(1).
Для удобства пользователя рекомендуется добавить каталог с исполняемым файлом ''mdroff'' в переменную окружения PATH.
--- Кто из учащихся уже использовал mdroff?
+- Кто из учащихся уже использовал mdroff?
Как минимум, одна курсовая работа сдавалась студентом СыктГУ. Для генерации титульной страницы а также настроек документа (отступы, поля и т. п.) разработан стандартный шаблон, соответствующий требованиям университета. Этот файл находится в ''contrib/syktsu.tmac''. Для того, чтобы им воспользоваться, достаточно включить его в начало файла.