Ассоциация CyrTUG Россия, 129820, Москва, 1-й Рижский пер., Кирилический дистрибутив СyrTUG-emTeX Версия от 31.01.94 Введение Дистрибутив CyrTUG-emTeX представляет собой кирилическую версию пакета emTeX, разработанного Эберхардом Маттесом (Герма- ния) на базе издательской системы TeX, созданной американским ученым профессором Дональдом Кнутом специально для набора сложных научно-технических текстов. Работа по кирилизации пакета emTeX проводилась в рамках ассо- циации CyrTUG, руководитель работы И.А. Маховая (Москва). Кирили- ческая часть и инсталятор CyrTUG-emTeX разработаны С.А.Стрелковым при участии О.Г.Лапко. Кирилическая часть шрифтов семейства LH разработаны O.Г.Лапко и А.Б.Ходулевым. Авторы выражают благодарность следующим организациям и специ- алистам, оказавшим содействие в работе над дистрибутивом: TUG (Санта-Барбара) и AMS (Провиденс) - за предоставление не- обходимого программного обеспечения и литературы; издательству "МИР" (Москва) - за предоставление персональных компьютеров и принтеров; Дмитрию Вулису (Нью-Йорк) - за представление программы рус- ких переносов; членам ассоциации CyrTUG А.С.Бердникову (с. Петербург), П.А.Овченкову (Москва), Е.M.Янковскому (Москва) - за ценные замечания и написание отдельных программ. CyrTUG-emTeX представляет собой "public domain" продукт, т.е. не защищен от копирования и распространяется свободно в учебных и просветительских целях. При издании литературы на кириллице в данном дистрибутиве обязательно следует помещать фразу: "Издание подготовлено в пакете CyrTUG-еmTeX с использованием кириллических шрифтов семейства LH". При использовании шрифтов семейства LH с иной версией TeX'а до- бавлять фразу: "... с использованием кириллических шрифтов семейства LH". С замечаниями и предложениями по усовершенствованию дистрибу- тива CyrTUG-emTeX просьба обращатся по e-mail: distr@mir.msk.su Дистрибутив системы CyrTUG-EmTeX базируется на пакете EmTeX от 23.06.92 и Beta-Test-Version EmTeX 10.08.94, а также AMS-TeX версии 2.1 LaTeX2e 31.07.94 и предназначенн для русификации различных версий TeX'а: Plain TeX, LaTeX2.09, LaTeX2e и AMS-TeX. Инсталятор предназначен для установки только пакета CyrTUG-emTeX. Предполагается, что основной пакет EmTeX инсталлируется самостоятельно используя приведенные в списке архивов файлы. При инсталяции система должна быть установлена на жесткий диск, при этом все относящиеся к CyrTUG-EmTeX файлы будут располагаться в директории \EMTEX\ указанного Вами жесткого диска и ее поддиректориях. I. Установка системы CyrTUG-emTex I.0. Подготовка к инсталяции Выйти из командной оболочки типа Norton Comander. Это необхо- димо для того, чтобы инсталятор мог устанавливать значения для переменных среды DOS'а в процессе своей работы. В противном слу- чае возможно сообщение операционной системы: Out of environment space, и неправильная работа инсталятора. I.1. Установка выполняемых программ и документации Вставить в дисковод дискету с меткой #DISK.00 (дискету, со- держащую файл "readme_.rus", который вы в данный момент читаете); сделать этот дисковод текущим устройством; выполнить команду CYRINST с двумя параметрами - буквой диска, на который вы желаете установить TeX, и буквой дисковода, с которого производится чтение дискет. Например, если используемый вами дисковод имеет логический номер A:, а TeX надо устанавливать на диск C:, то к цели приве- дет такая последовательность команд: A: CYRINST C A Во время инсталяции требуется ответить на несколько вопросов: Вопрос первый: Install Tex compiler (Y/N)? При первоначальной установке TeX'а следует ответить утверди- тельно (Y). Вопрос второй: What type of computer you use ? Press 1 for XT or 2 for AT-286 or 3 for AT-386(486) Вопрос третий (только при ответе "3" на предыдущий вопрос): What type TeX compiler you use ? Press 1 for tex186.exe or 2 for tex386.exe Данный инсталятор предлагает установить компиляторы из пакета BETA-TEST-VERSION: для PC XT - tex.exe (занимает 2212 KB, из них 289 KB директория \EMTEX\DOC\ с документацией); для PC AT-286 - tex186.exe (занимает 2.207 KB, 279 KB - документация); для PC AT- 386(486) на выбор tex186.exe или tex386.exe (занимает 2415 KB, 419 KB - документация). Для полноценной работы tex386 необходимо 3MB оперативной памяти. Кроме того рекомендуем прочесть файл EMTEX386.DOC (tex386b8.zip или \EMTEX\DOC, если tex386 инсталли- рован). Для начала рекомендуем на третий вопрос выбрать ответ 1. Желающие установить различные версии Big Tex или Tex-компиля- торы для OS/2 могут сделать это самостоятельно, следуя инструкци- ям, содержащимся в файлах README.ENG и TEX386.DOC. В последующих вопросах предлагается выбрать, какие из макро- расширений TeX надо инсталировать: AmSTeX, LaTex или PlainTeX. Безусловно инсталируется только латинская и кирилическая версии PlainTeX. Для всех макрорасширений можно использовать латинскую и кирилическую версии. Вопрос четвертый: Install LaTeX (Y/N)? Производится инсталяция LaTex'а версии 2.09 от 31.03.92. Тре- бует для установки 1060 KB, в директорию \EMTEX\DOC\RUSSIAN\ по- мещается курс по LaTeX'у на русском языке (113 KB). Вопрос пятый: Install LaTeX2e (Y/N)? Производится инсталяция LaTeX2e 31.07.94. Вопрос шестой: Install AMSTeX (Y/N)? Производится инсталяция AMSTeX'а версии 2.1 от 09.04.91 (см. файл -READ.ME). Требует для установки 605 KB, из них 239 KB доку- ментация в директории \EMTEX\AMSTEX\DOC\. После ответа на эти вопросы инсталятор разворачивает необходимые пакеты. I.2. Генерация шрифтов и создание шрифтовых библиотек Если Вы располагаете дискетами с шрифтовыми библиотеками, то их следует разместить в директории \TEXFONTS\ (см. файлы README.FX на дискете #DISK_FX.01, README.P6H на дискете #DISK_PH.01, README.LJ на дискете #DISK_LJ.01). В противном слу- чае Вы можете сгенерировать шрифты самостоятельно с помощью прог- раммы METAFONT. Генерация шрифтов и создание шрифтовых библиотек описаны в файлах README.ENG и MAKEFONT.DOC. I.3. Модификация конфигурации компьютера С помощью любого текстового редактора вам следует отредакти- ровать файл AUTOEXEC.BAT на верхнем уровне диска C. В нем указать путь к директории EMTEX: PATH ....;C:\EMTEX В файл AUTOEXEC.BAT следует добавить строку CALL C:\EMTEX\SET-TEXR.BAT Эту строку следует поместить непосредственно после команд PATH и SET (вместо C: следует указать букву диска, на который был уста- новлен TeX). Необходимо отредактировать первую строку файла SET-TEXR.BAT находящегося в директории \EMTEX\. SET EMTEXDRV=C: указав вместо буквы диска С букву того диска, на котором располо- жена директория \EMTEX. Предполагается, что директория C:\TEXFONTS\ находится на том же диске, что и директория C:\EMTEX\. Если это не так, то необхо- димо исправить следующую строку в файле SET-TEXR.BAT: SET DVIDRVFONTS=%EMTEXDRV%\TEXFONTS заменив подстроку %EMTEXDRV%, например, если \TEXFONTS\ находится на диске D: SET DVIDRVFONTS=D:\TEXFONTS Назначение всех переменных среды, устанавливаемых в файле SET-TEXR.BAT, описаны в файлах README.ENG и TEX386.DOC. Затем следует перезагрузить операционную систему, чтобы из- мененная конфигурация вступила в силу. Замечание. Команда SET-TEXR вызывает установку довольно боль- шого числа переменных среды, что может вызвать переполнение памя- ти среды (сообщение "Out of environment space" при перезагрузке системы). Эту трудность можно преодолеть, включив в файл CONFIG.SYS команду SHELL с соответствующими параметрами SHELL = C:\COMMAND.COM /P /E:1024 I.4(а). Генерация форматных файлов для TeX-компиляторов tex.exe и tex186.exe На этом этапе дистибутивные дискеты не используются. Следует перейти в директорию \EMTEX\TEXFMTS\CYRFMT\ на диске, где уста- навливался TeX. При этом будет выполняться программа TeX (в режиме инициали- зации), так что этот этап одновременно является проверкой пра- вильности установки. В этом режиме TeX'у требуется довольно много оперативной па- мяти, так что вам, возможно, придется выйти из Norton Commander и/или выполнить другие действия по освобождению памяти. Для генерации форматных файлов, позволяющих работать на рус- ском и английском языках, следует использовать следующие BAT-файлы: INILHPL.BAT порождает LHPLAIN.FMT - версия Plain TeX LHPLAIN.LOG INILHLPL.BAT порождает LHLATEX.FMT - версия LaTeX 2.09 LHLATEX.LOG INILHLTX.BAT порождает LHLTX2E.FMT - версия LaTeX2e LHLTX2E.LOG INILHAMS.BAT порождает LHAMSTEX.FMT - версия AMSTeX. LHAMSTEX.LOG Вышеперечисленные BAT-файлы первоначально создают LOG и FMT файлы в директории \EMTEX\TEXFMTS\CYRFMT\, затем копируют их в директорию \EMTEX\TEXFMTS\ и только после удачного копирования происходит удаление их из директории \EMTEX\TEXFMTS\CYRFMT\. Фор- матные файлы имеют большой объем, поэтому на диске у Вас должно быть достаточное пространство для их генерации (до 700 KB для каждого файла при работе с tex186). LOG-файлы можно удалить, не- посредственно для работы TeX'а они не нужны. Не советуем создавать форматные файлы, которые в дальнейшем не будут использоваться. При генерации форматных файлов кирилической версии русским буквам присвоен catcode`# =11 и таким образом русские буквы можно использовать в именах макроопределений TeX'а (см. файл \emtex\(b)texfmts\cyrfmt\rusdef.tex). Генерация форматных файлов, позволяющих работать только на английском языке, производится в директории \EMTEX\TEXFMTS\, для чего используются BAT-файлы: FMT.BAT порождает PLAIN.FMT - версия Plain TeX PLAIN.LOG LPLAIN.FMT - версия LaTeX 2.09 LPLAIN.LOG FMT_AMS.BAT порождает AMSTEX.FMT - версия AMSTeX 2.1 - AMSTEX.LOG I.4(б). Генерация форматных файлов для TeX-компимлятора tex386.exe Компилятор tex386 предназначен для обработки документов боль- шого объема, с которым не справляется стандартная версия. Гене- рация форматных файлов выполняется так же, как п.I.4(a), но сле- дует перейти в директорию \EMTEX\BTEXFMTS\CYRFMT. Компилятор tex386 создан на основе программы BigTeX и может работать на компьютерах с процессором 80386DX, 80386SX или i486, используя операционную систему MS DOS не ниже версии 3.0 или опе- рационную систему OS/2 2.2x (cм. файл EMTEX386.DOC). Данный компилятор быстро работает только при наличии доста- точно большой оперативной памяти, рекомендуется 3 мегабайта. Ком- пилятор может использовать как EMS, так и XMS память. Рекомендуем использовать диспетчер памяти QEMM-386, поскольку на некоторых машинах использование компилятора совместно с драйвером HYMEM.SYS приводит к зависанию машины (подробнее см. список сообщений об ошибках в конце файла EMTEX386.DOC). В целом для рабочей версии с минимальным набором библиотек для работы в LaTeX'е вам потребуется около 5 MB пространства на диске и около 19 MB - для версии с полным комплектом лазерных шрифтов и несколькими форматными файлами. После успешной установки вы можете использовать TeX для под- готовки ваших документов. II. Работа в инсталированном пакете II.1. Подготовка исходного файла Выполняется при помощи любого текстового редактора. Относи- тельно формы исходного файла см. Литературу. При наборе рускоязычных текстов помимо русских букв следует использовать и другие знаки: открывающие и закрывающие кавычки "ёлочка" (набираются с помощью лигатур << и >> или макроопределе- ний \llq и \rrq), и знак номера (набирается с помощью команды \No). Макрокоманда \qr вводит нижнюю русскую двойную кавычку (в качестве верхней - закрывающей - кавычки используются два апост- рофа ``). Команда \Russian включает русские переносы, а команда \English - английские. Первоначально установлены английские пере- носы. Файл russian.sty представляет собой переопределения некоторых команд \LaTeX'а, и предназначен для набора русских документов. Переопределены команды \chaptername, \partname и т.д. на русские названия Глава, Часть и т.д. Переопределена команда \today для набора дат по-русски. Определены счетчики русских прописных (\Asbuk) и строчных (\asbuk) букв для перечней по аналогии с ла- тинскими \Alph и \alph. В документацию, готовящуюся на \LaTeX'е, стиль можно подклю- чить следующим образом: \documentstyle[russian]{book} В russian.sty предусмотрена возможность переключения названий разделов с русского на английский, используя команды \originalTeX и \russianTeX. II.2. Обработка файла TeXом TEX &<имя формата> <имя исходного файла> Возможен автоматический вход в текстовый редактор, если TeX обнаруживает ошибки (см. описание опции компилятора /a в файле \emtex\doc\english\tex.doc) В качестве <имени формата> можно указать имена любых формат- ных файлов, перечисленных в п.1.4(а) при условии, что соот- ветствующий форматный файл сгенерирован. В директории \emtex\ имеются готовые Вatch-файлы для запуска TeX'a с соответсвующими форматными файлами: LHAMSTEX BAT - русифицированный AMS-TeX, LHLATEX BAT - русифицированный LaTeX, LHLTX2E BAT - русифицированный LaTeX2e, LHTEX BAT - русифицированный Plain TeX. Если вы используете Norton Commander, то можно рекомендовать добавить к файлу подразумеваемых команд (Extension file) следую- щие строки: tex: lhtex.bat !.! или tex: texed &jplain !.! ams: lhamstex.bat !.! lat: lhlatex !.! lae: lhltx2e !.! dvi: v_lj_lh.bat !.! Это обеспечит автоматическую обработку ваших исходных файлов и просмотр результирующих файлов (с расширением .dvi) на экране по клавише Enter в среде Norton Commander. II.3. Исправление ошибок в исходном файле Может выполняться с помощью любого привычного для Вас тексто- вого редактора. Список всех найденных ошибок TeX помещает в файл с расширением .log (см. файл \EMTEX\DOC\ENGLISH\TEX.DOC). Замечание. В качесте среды для работы с TeX'ом удобно исполь- зовать редактор MultiEditor 6.0, который имеет встроенную под- держку обработки ошибок EmTex, и позволяет запускать TeX-файл на трансляцию, просматривать dvi-файлы, производить распечатку на принтере, не выходя из редактора. II.4. Просмотр подготовленного документа на экране В результате работы TeXа образуется файл с расширением .dvi, который можно просмотреть на экране или распечатать. EmTeX умеет использовать шрифты для принтера для просмотра на экране, в директории \EMTEX\ имеются три Batch-файла для просмотра dvi-файлов на экране: V_FX_LH BAT - использует шрифтовые библиотеки fx для просмот- ра dvi-файлов (шрифты для 9-точечного матричного принтера типа EPSON FX-80) : fx_{0,1,2,3,4,5,h} - латинские шрифты семейства CM; fx_{0,1,2,3,4,5,h}-lh - кириллические шрифты семейства LH; fx_{0,1,2,3,4,5,h}-ms - дополнительные математические шрифты из набора AMSFonts 2.1; fx_{0,1,2,3,4,5,h}-eu - шрифты эйлерова семейства из набора AMSFonts 2.1. Полный набор библиотек занимает 7.3 MB, набор библиотек, не- обходимый для работы в LaTeX'е 10 кеглем (fx_{0,1,2} и fx_{0,1,2}-lh) требует 1.89 MB дисковой памяти. V_PH_LH BAT - использует шрифтовые библиотеки p6h для просмотра dvi-файлов (шрифты для 24-точечного матричного принтера типа EPSON LQ) : p6h_{0,1,2,3,4,5,h,r} - латинские шрифты семейства CM; p6h_{0,1,2,3,4,5,h,r}-lh - кириллические шрифты семейства LH; p6h_{0,1,2,3,4,5,h}-ms - дополнительные математические шрифты из набора AMSFonts 2.1; p6h_{0,1,2,3,4,5,h}-eu - шрифты эйлерова семейства из набора AMSFonts 2.1. Полный набор библиотек занимает 11.7 MB, набор библиотек не- обходимый для работы в LaTeX'е 10 кеглем (p6h_{0,1,2} и p6h_{0,1,2}-lh) требует 2.96 MB дисковой памяти. V_LJ_LH BAT - использует шрифтовые библиотеки lj для просмот- ра dvi-файлов (шрифты для лазерного принтера типа HP Laser Jet II) : lj_{0,1,2,3,4,5a,5b,h} - латинские шрифты семейства CM; lj_{0,1,2,3,4,5a,5b,h}-lh - кириллические шрифты семейства LH; lj_{0,1,2,3,4,5,5,h}-ms - дополнительные математические шрифты из набора AMSFonts 2.1; lj_{0,1,2,3,4,5,5,h}-eu - шрифты эйлерова семейства из набора AMSFonts 2.1. Полный набор библиотек занимает 9.77 MB, набор библиотек, не- обходимый для работы в LaTeX'е 10 кеглем (lj_{0,1,2} и lj_{0,1,2}-lh) требует 2.45 MB дисковой памяти. Для увереной работы с драйверами экрана и печати необходимо изучить файл \emtex\doc\english\dvidrv.doc. Таблица соответствия разрешений шрифтов названиям шрифтовых библиотек находится в фай- ле MAGSTEP.DOC. II.5. Распечатка результата Распечатка на матричном принтере выполняется с помощью ко- манд: PR_FX_LH BAT <имя dvi-файла> - для печати на EPSON FX-80 PR_LQ_LH BAT <имя dvi-файла> - для печати на EPSON-LQ Файл pr_fx_lh.bat содержит строку: dvidrv dvidot fx80 @fx_lh.cnf /po=prn /h=12 %1 где файл fx80.dot содержит описание принтера EPSON FX-80. Внимание! При инсталяции разархивированы не все имеющиеся в пакете emTeX описания принтеров. Важную роль для управления драйверами печати и экрана играют конфигурационные файлы - это файлы с расширением .cnf. Команды, которые могут содержать конфигурационные файлы, подробно описаны в файле DVIDRV.DOC. Если вы желаете использовать минимальный набор шрифтовых библиотек, например, fx_{0,1,2} и fx_{0,1,2}_lh, то необходимо внести исправления в конфигурационный (.cnf) файл, и по необходи- мости создать файл замены шрифтов (substitution file) (об этом также читайте в dvidrv.doc). Для печати шрифтами с разрешением 360х360 точек на дюйм на матричных притерах с разрешением 360Х180 и 180Х180 точек на дюйм надо использовать файлы p6l_lh.cnf и p6m_lh.cnf. Например: dvidrv dvidot lql @p6l_lh.cnf /po=prn /h=12 <имя .dvi файла> Для распечатки на лазерном принтере служит команда PR_LJ_LH.BAT <имя dvi-файла> Разумеется, если у вас на машине не установлены лазерные шрифты, то печать на лазерном принтере невозможна. Ряд полезных дополнительных сведений об упомянутых выше прог- раммах, а также о других, входящих в состав дистрибутива emTeX'а, можно найти в файлах, содержащихся в директории \EMTEX\DOC (на английском языке). Как правило, эти файлы представлены в UNIX'овском формате (конец строки - код CR), для перевода их в формат DOS (конец строки CR/LF) используйте программу TOMS.EXE, заимствованную из дистрибутива пакета AMSTeX и находящуюся на дискете #DISK.00. Cразу после инсталяции LaTeX'а Вы сможете просмотреть на экране и распечатать на принтере краткий курс по LaTeX'у на русском языке. Файлы, содержащие курс, наxодятся в директории \EMTEX\DOC\RUSSIAN. Требуется выполнить три раза подряд команду LHLATEX.BAT LKYPC.TEX в этой директории, получить файл LKYPC.DVI, который Вы можете просмативать на экране или распечатать. Предварительно надо сгенерировать форматный файл LHLPLAIN.FMT (см. п.I.4). Литература Все перечисленные издания доступны для членов Ассоциации CyrTUG 1) Д.Кнут. Всё про TeX. - АО RDTeX, Протвино, 1993. 2) М.Спивак. Восхитительный TeX. Руководство по комфортному изго- товлению научных публикаций в пакете AmSTeX. - "Мир", М., 1993. 3) М.Евграфов, Л.Евграфов. TeX. Руководство по набору математи- ческих текстов. - "Наука", М., 1993. 4) Г.Петрова, В.Руденко. TeX. Руководство для начинающих. Преп- ринт N 511, ИПМех РАН, М., 1992. 5) А.Журов, И.Карпов. Основы TeX'а. Препринт N 518, ИПМех РАН, М., 1992. 6) X.Партль, Э.Шлегл, И.Хина. LaTeX: Краткое руководство. Перера- ботанный и дополненный перевод с немецкого. - Файл LKYPC.TEX в дистрибутиве CyrTUG-emTeX.- CyrTUG, М., 1994. Приложения Некоторая информация о пакете emTeX В основном пакете emTeX от 23.06.92 имеется несколько TeX-компиляторов (см. файл README.ENG): tex.exe (DOS, OS/2 реаль- ный режим), tex286.exe (DOS, OS/2 реальный режим, процессор 80286 и выше), texp.exe (OS/2 защищенный режим); btex.exe BigTeX (DOS), btex286.exe BigTeX (DOS, процессор 80286 и выше), btexp.exe BigTeX (OS/2 защищенный режим). В дополнительном Beta-Test-Version пакете реализованы более быстрые версии компиляторов: tex.exe, tex186.exe, texp.exe - реализации emTeX 3.14 [3c-beta5]; btex.exe, btex186.exe, btexp.exe реализации Big emTex 3.141 [3c-beta8]; tex386.exe - Tex386 3.141 [3c-beta8], работающий с процессором не ниже 80386 и использующий расширитель памяти ЕMX, позволяющий работать под DOS или OS/2 2.x, используя интерфейс VCPI, интерфейс DPMI не поддерживается, т.е. программа не может работать в DOS-окне WINDOWS 3.1 или OS/2 2.x.(подробнее см. файл EMTEX386.DOC).