Руководство пользователя TEX Live
TEX Collection 2007

Редактор: Карл Берри
http://tug.org/texlive/

Январь 2007

Содержание

1 Введение
 1.1 Как пользоваться TEX Live
 1.2 Где можно получить поддержку
2 Структура TEX Live
 2.1 Дистрибутивы: live, inst, protext
 2.2 Корневые директории
 2.3 Описание деревьев texmf
 2.4 Расширения TEXа
 2.5 Другие интересные программы в дистрибутиве TEX Live
3 Установка в системах типа Unix
 3.1 Работа с TEX Live непосредственно с установочного диска (Unix)
 3.2 Установка TEX Live на диск
 3.3 Установка на диск индивидуальных пакетов
4 Действия после установки
 4.1 Программа texconfig
 4.2 Тестирование установки
5 Установка в системе Mac OS X
6 Установка в системе Windows
 6.1 Установка системы TEX Live на диск
 6.2 Дополнительные пакеты для Windows
7 Действия после установки под Windows
 7.1 Добавление и удаление пакетов
 7.2 Конфигурация и другие административные действия
 7.3 Удаление TEX Live
 7.4 Добавление ваших собственных пакетов к дистрибутиву
 7.5 Запуск tlmp.exe из командной строки
 7.6 Установка по сети
 7.7 Чем Windows отличаются от других систем?
 7.8 Индивидуальные настройки
 7.9 Тестирование
 7.10 Печать
 7.11 Советы пользователям Win32
 7.12 Что делать в случае проблем
8 Руководство пользователя Web2C
 8.1 Поиск файлов в Kpathsea
 8.2 Базы данных
 8.3 Опции запуска
9 Благодарности
10 История издания
 10.1 Прошлое
 10.2 Настоящее
 10.3 Будущее

Список таблиц

Поддерживаемые архитектуры.
Опции главного меню установки.

1 Введение

В этом документе описаны основные возможности программного продукта TEX Live — дистрибутива TEXа и других программ для GNU/Линукса и других Unixов, Mac OS X и (32-битовых) Windows. (Внимание: этот продукт не совместим со старыми Макинтошами или MS-DOS).

В TEX Live включены программы TEX, LaTeX2e, Metafont, MetaPost, BibTeX и многие другие; обширная коллекция макросов, шрифтов и документации; а также поддержка вёрстки на многих языках мира. Он является частью ещё б´ольшей коллекции TEX Collection (кратко описанной ниже в разделе 2, стр. 7). И TEX Live, и TEX Collection поддерживаются группами пользователей TEXa.

Более новые версии пакетов, включённых в дистрибутив, можно найти в архиве CTAN, http://www.ctan.org.

Краткий список основных изменений в этом издании TEX Live можно найти в разделе 10, стр. 70.

1.1 Как пользоваться TEX Live

TEX Live можно использовать тремя способами:

  1. Можно работать с TEX Live прямо с live DVD (см. раздел 2.1, стр. 7). Естественно, при этом почти не тратится место на диске, и вы немедленно получаете доступ ко всему дистрибутиву TEX Live. Разумеется, система работает несколько медленнее, чем при работе с диска, но и эта скорость работы может оказаться вполне удовлетворительной.
  2. Вы можете установить TEX Live полностью или частично на ваш диск. Это самый распространённый способ использования TEX Live. Вам потребуется примерно 100 мегабайтов в минимальном варианте и 1.3 гигабайта и выше для полной системы.
  3. Вы можете установить определённый пакет или коллекцию пакетов для уже установленного у вас TEXа: либо установленной ранее системы TEX Live, либо другого дистрибутива.

Всё это подробно описано в разделе руководства по установке, относящемся к вашей операционной системе. Вкратце:

1.2 Где можно получить поддержку

Сообщество пользователей TEXа активно и дружелюбно, и практически на каждый серьёзный вопрос найдётся ответ. Однако эта поддержка неформальна, выполняется добровольцами, и поэтому очень важно, чтобы вы сами попробовали найти ответ перед тем, как задавать вопрос. (Если вы предпочитаете коммерческую поддержку, возможно вам ст´оит вместо TEX Live купить одну из коммерческих версий TEXа, см. список по адресу http://tug.org/interest.html#vendors for a list).

Вот список источников поддержки, приблизительно в том порядке, в котором мы рекомендуем к ним обращаться:

Страница для новичков
Если вы — новичок, то страница http://tug.org/begin.html может послужить для начала.
TEX FAQ
TEX FAQ (ЧаВо, часто задаваемые вопросы) — огромная коллекция ответов на всевозможные вопросы, от самых простых до самых сложных. Английская версия ЧаВо находится на TEX Live в разделе texmf-doc/doc/english/FAQ-en и доступна в Интернете по адресу http://www.tex.ac.uk/faq. Пожалуйста, попробуйте найти ответ на свой вопрос там перед тем, как задавать его в различных сообществах.
TEX Catalogue
Если вы ищете какой-либо пакет, шрифт, программу и т.п., то вам стоит заглянуть в TEX Catalogue. Это огромный каталог всего, что относится к TEXу. См. texmf-doc/doc/english/catalogue или http://www.ctan.org/tex-archive/help/Catalogue.
TEX во всемирной паутине
Вот страничка, на которой много ссылок по TEXу, включая многочисленные книги, руководства и статьи: http://tug.org/interest.html.
Архивы списков рассылки и групп
Два основных форума технической поддержки — группа news:comp.text.tex и список рассылки texhax@tug.org. В их архивах тысячи вопросов и ответов на все случаи жизни. См. http://groups.google.com/groups?group=comp.text.tex и http://tug.org/mail-archives/texhax. Поиск, например, в Гугле http://google.com тоже часто помогает найти ответ.
Вопросы на форумах
Если вы не можете найти ответа на ваш вопрос, вы можете опубликовать вопрос в comp.text.tex при помощи Google или вашей любимой новостной программы, или послав письмо в texhax@tug.org. Но перед этим пожалуйста прочтите в ЧаВо совет о том, как правильно задавать вопросы на этих форумах: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion.
Поддержка TEX Live
Если вы хотите сообщить о баге или сообщить нам свои предложения и замечания о дистрибутиве TEX Live, его установке или документации, пишите на лист рассылки tex-live@tug.org. Однако если ваш вопрос касается конкретной программы, входящей в TEX Live, вам лучше задавать вопросы её автору или посылать их на соответствующий список рассылки.
Русскоязычные ресурсы
(добавлено переводчиком) Эхоконференция ru.tex доступна как в сети ФИДО, так и в Интернете (как news:fido7.ru.tex). Русские группы ФИДО можно найти на многих серверах, например demos.ddt.su. В FAQ этой группы (автор — Михаил Колодин) приводится много ссылок на русскоязычные ресурсы.

С другой стороны, вы сами тоже можете помочь тем, у кого есть вопросы. И comp.text.tex, и texhax, и fido7.ru.tex открыты для всех, поэтому вы тоже можете присоединиться, читать и помогать другим. Добро пожаловать в сообщество пользователей системы TEX!

2 Структура TEX Live

Этот раздел описывает структуру и содержание TEX Collection и его составной части TEX Live.

2.1 Дистрибутивы: live, inst, protext

Ограничения на объём CD-ROM заставили нас разделить TEX Live на несколько дистрибутивов:

live
полная система, которой можно пользоваться непосредственно с DVD или установить на компьютер; она чересчур велика для CD. В DVD также включена копия архива CTAN, дистрибутив protext для Windows, дистрибутив MacTEX для Mac OS X, (эти дистрибутивы не относятся к TEX Live), а также некоторые другие пакеты в директории texmf-extra.

Лицензии на использование CTAN, protext, MacTEX и texmf-extra отличаются от лицензии TEX Live, поэтому будьте внимательны при распространении или модификации программ, входящих в эти дистрибутивы.

inst(allable)
полная система на CD; чтобы она поместилась, мы сжали всё, что могли. Поэтому невозможно пользоваться TEXом непосредственно с этого CD; вам придётся установить его на диск вашего компьютера (отсюда название дистрибутива). Установка описана в следующих разделах.
protext
улучшенный вариант системы MiKTEX для Windows. ProTEXt включает в себя дополнительные программы и упрощённую установку. Он не зависит от TEX Live и включает собственные инструкции по установке. Его можно запускать с CD/DVD или установить на ваш диск. Страница ProTEXt находится вот тут: http://tug.org/protext.

ProTEXt находится и на live DVD, и на отдельном CD (для тех, кто не может пользоваться DVD).

Вы можете определить, какой дистрибутив перед вами, открыв файл 00type.TL в корневой директории. В этом файле находится также дата выпуска TEX Live.

Естественно, каждая группа пользователей TEXа сама выбирает, что ей распространять.

2.2 Корневые директории

Вот краткое описание корневых директорий в дистрибутиве TEX Live. На live DVD вся иерархия TEX Live помещена в поддиректорию texliveYYYY, где YYYY — номер года, а не в корень диска.

bin

Программы системы TEX, сгруппированные по платформам

source

Исходный код всех программ, включая дистрибутивы Web2C TEX и Metafont. Они хранятся в сжатом архиве (tar-bzip2).

support

Разные вспомогательные пакеты и программы. Они не устанавливаются по умолчанию. Сюда относятся разнообразные редакторы и оболочки для TEXа.

texmf

Дерево для программ, их вспомогательных файлов и документации. Не включает форматов и пакетов TEXа (это дерево соответствует TEXMFMAIN в следующем разделе).

texmf-dist

Основное дерево форматов и пакетов (это дерево соответствует TEXMFDIST в следующем разделе).

texmf-doc

Дерево самостоятельной документации, не относящейся к отдельным пакетам и программам, сгруппированное по языкам.

texmf-var

Дерево автоматически создаваемых файлов (это дерево соответствует TEXMFSYSVAR в следующем разделе).

xemtex

Дерево вспомогательных программы для Windows. Юниксовские версии этих программ обычно входят в стандартную поставку, или же легко устанавливаются отдельно.

Кроме этих директорий, в корневой директории находятся скрипты установки и файлы README (на разных языках).

Директория texmf-doc содержит документацию и только документацию, но она не содержит всю документацию. Документация к отдельным программам (руководства, man, info) находится в директории texmf/doc, поскольку сами программы находятся в директории texmf. Аналогично документация для макропакетов и форматов находится в директории texmf-dist/doc. Для поиска документации можно воспользоваться программами texdoc или texdoctk. Можно также воспользоваться ссылками в файле doc.html.

2.3 Описание деревьев texmf

В этом разделе описаны все переменные, задающие положение деревьев texmf и их значения по умолчанию. Команда texconfig conf показывает текущие значения этих переменных, так что вы можете легко проверить, где эти директории находятся в вашей системе.

TEXMFMAIN

Дерево, где находятся основные части системы, такие, как вспомогательные скрипты (например, web2c/mktexdir), файлы со значениями текстовых констант и другие.

TEXMFDIST

Дерево с основным набором макропакетов, шрифтов и т.д. в первоначальной конфигурации.

TEXMFLOCAL

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

TEXMFHOME

Дерево, которое пользователи могут использовать для установки собственных пакетов, шрифтов и т.д., или для обновлённых версий системных пакетов. Эта переменная зависит по умолчанию от переменной $HOME, своей для каждого пользователя.

TEXMFCONFIG

Это дерево используется утилитами texconfig, updmap и fmtutil программы teTEX для хранения модифицированных файлов конфигурации. По умолчанию находится в директории $HOME.

TEXMFSYSCONFIG

Это дерево используется утилитами texconfig-sys, updmap-sys и fmtutil-sys программы teTEX для хранения модифицированных файлов конфигурации, общих для всех пользователей.

TEXMFVAR

Это дерево используется утилитами texconfig, updmap и fmtutil программы teTEX для хранения создаваемых автоматически файлов: форматов, карт шрифтов. По умолчанию находится в директории $HOME.

TEXMFSYSVAR

Это дерево используется утилитами texconfig-sys, updmap-sys и fmtutil-sys программы teTEX для хранения создаваемых автоматически файлов: форматов, карт шрифтов, — общих для всех пользователей.

Более полное обсуждение утилиты texconfig и родственных ей программ находится в разделе 4.1, стр. 29.

2.4 Расширения TEXа

В состав TEX Live входит несколько расширений TEXа:

e-TEX
добавляет небольшой, но очень полезный набор новых примитивов (относящийся к макроподстановкам, чтению символов, дополнительным возможностям отладки и многому другому) и расширения TEX--XE T для вёрстки справа налево и слева направо. В обычном режиме e-TEX на 100% совместим со стандартнымTEXом. См. texmf-dist/doc/etex/base/etex_man.pdf.
pdfTEX
включает в себя расширения e-TEXа. Эта программа создаёт и файлы в формате Acrobat PDF, и стандартные DVI. См. texmf/doc/pdftex/manual/ и texmf/doc/pdftex/manual/samplepdf/samplepdf.tex. Эта программа по умолчанию используется для генерирования всех форматов, кроме plain TEX.
XeTEX
добавляет поддержку Unicode и шрифтов в формате OpenType, используя системные библиотеки. См. http://scripts.sil.org/xetex.
Omega (Омега)
основана на Unicode (система 16-битовых символов), что позволяет работать одновременно почти со всеми письменностями мира. Она также поддерживает так называемый «процесс трансляции Omega» (OTPs) для сложных преобразований произвольного входного потока. См. texmf-dist/doc/omega/base/doc-1.8.tex (текст несколько устарел).
Aleph
объединяет Omega и e-TEX. См. краткую документацию в texmf-dist/doc/aleph/base.

2.5 Другие интересные программы в дистрибутиве TEX Live

Вот несколько других часто используемых программ в дистрибутиве TEX Live:

bibtex

поддержка библиографий.

makeindex

поддержка алфавитных указателей.

dvips

преобразование DVI в PostScript.

xdvi

программа для просмотра DVI для X Window System.

dvilj

драйвер для лазерных принтеров семейства HP LaserJet.

dv2dt, dt2dv

преобразование DVI в текст и обратно.

dviconcat, dviselect

перестановка страниц в файлах DVI.

dvipdfm

преобразование DVI в PDF, альтернатива pdfTEXу, упомянутому выше. Пакеты ps4pdf и pdftricks предлагают дополнительные возможности.

psselect, psnup,

утилиты для формата PostScript.

lacheck

проверка синтаксиса LATEXа.

texexec

процессор для ConTEXtа и PDF.

tex4ht

конвертер из TEXа в HTML.

3 Установка в системах типа Unix

Как объясняется в разделе 1.1, стр.  4, TEX Live можно использовать тремя способами:

  1. Выполнять непосредственно с дистрибутивного диска.
  2. Установить на диск вашего компьютера.
  3. Интегрировать отдельный пакет или коллекцию в существующий TEX.

В следующих разделах подробно описывается каждый из этих способов для систем типа Unix.


Внимание: CD и DVD TEX Collection изготовлены в формате ISO 9660 (High Sierra), включая расширения Rock Ridge (и Joliet для Windows). Поэтому для того, чтобы использовать TEX Collection, ваша система должна поддерживать расширения Rock Ridge. Пожалуйста, посмотрите документацию к команде mount для вашей системы и выясните, как это делается. Если у вас несколько машин в локальной сети, возможно, вам будет проще смонтировать CD на машине, которая поддерживает Rock Ridge, и читать с остальных машин по сети.

Современные системы должны читать диски без проблем. Если у вас возникли трудности, сообщите нам. Дальнейший текст предполагает, что вам удалось смонтировать диск на машине, которая поддерживает Rock Ridge.


3.1 Работа с TEX Live непосредственно с установочного диска (Unix)

Вы можете использовать TEX непосредственно с live DVD, не устанавливая его на ваш компьютер. (Собственно, отсюда название «TEX Live ».) Однако невозможно запустить TEX с других дисков коллекции (см. раздел 2.1, стр.  7). Сначала нам надо смонтировать CD или DVD с расширениями Rock Ridge. Как именно это делается, зависит от вашей системы; команды ниже работают для Линукса, хотя название устройства (/dev/cdrom) может быть другим. (Все наши примеры используют > в качестве системного приглашения; команды, набираемые пользователем, подчёркнуты.):

> mount -t iso9660 /dev/cdrom /mnt/cdrom

Теперь нужно перейти в смонтированную директорию:

> cd /mnt/cdrom

В Mac OS X нужная директория обычно находится в директории /Volumes, и диск монтируется автоматически. Выполните скрипт установки install-tl.sh:

> sh install-tl.sh Welcome to TeX Live...

После разнообразных стартовых сообщений и списка опций главного меню, установочный скрипт попросит вас ввести команду. Сделайте это, напечатав нужную букву и нажав RETURN; не печатайте угловых скобок. Можно печатать заглавную или строчную букву; в примерах ниже приводятся строчные буквы.

Чтобы работать прямо с дистрибутива, первой командой должна быть d, а затем подкоманда 1, чтобы установить директории. Даже в этом случае мы должны выбрать директорию на локальном диске, чтобы класть туда файлы, которые TEX генерирует сам, например, шрифты и форматы, а также изменённые конфигурационные файлы, если в них появится необходимость.

В этом примере мы будем использовать /opt/texlive2007. Полезно использовать номер года в названии директории, поскольку файлы, созданные разными версиями TEX Live, не всегда совместимы. (Если значение по умолчанию /usr/local/texlive/2007 вам подходит, вы можете пропустить этот шаг.)

Enter command: