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

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

Июль 2008

Содержание

1 Введение
 1.1 TEX Live и TEX Collection
 1.2 Поддерживаемые операционные системы
 1.3 Основы установки TEX Live
 1.4 Где можно получить поддержку
2 Структура TEX Live
 2.1 TEX Collection: TEX Live, proTEXt, MacTEX
 2.2 Корневые директории
 2.3 Описание директорий texmf
 2.4 Расширения TEXа
 2.5 Другие интересные программы в дистрибутиве TEX Live
 2.6 Шрифты в TEX Live
3 Установка
 3.1 Запуск программы установки
  3.1.1 Юникс
  3.1.2 Mac OS X
  3.1.3 Windows
  3.1.4 Установка в текстовом режиме
  3.1.5 Установка в графическом режиме
 3.2 Работа программы установки
  3.2.1 Меню выбора платформы (только для Юникса)
  3.2.2 Выбор основных компонентов
  3.2.3 Директории
  3.2.4 Опции
  3.2.5 Настройка для работы с DVD (только текстовый режим)
 3.3 Опции командной строки
  3.3.1 Параметр location
 3.4 Действия после установки
  3.4.1 Windows
  3.4.2 Если созданы симлинки
  3.4.3 Переменные окружения для Юникса
  3.4.4 Переменные окружения: глобальная конфигурация
  3.4.5 Работа с DVD
  3.4.6 ConTEXt Mark IV
  3.4.7 Добавление личных и локальных пакетов
  3.4.8 Добавление шрифтов
 3.5 Тестирование системы
4 Установка в локальной сети
5 Максимально переносимая система TEX Live на DVD и USB
6 Администрирование системы при помощи tlmgr
 6.1 Программа tlmgr в графическом режиме
 6.2 Запуск программы tlmgr из командной строки
7 Дополнительные замечания о Windows
 7.1 Дополнительные возможности Windows
 7.2 Дополнительные пакеты для Windows
 7.3 Программа Dviout
 7.4 Ссылки на дополнительные программы
 7.5 Домашняя директория под Windows
 7.6 Регистр Windows
 7.7 Права доступа под Windows
8 Руководство пользователя Web2C
 8.1 Поиск файлов в Kpathsea
  8.1.1 Источники путей поиска
  8.1.2 Конфигурационные файлы
  8.1.3 Подстановка путей
  8.1.4 Подстановка по умолчанию
  8.1.5 Подстановка скобок
  8.1.6 Подстановка поддиректорий
  8.1.7 Список специальных символов и их значений
 8.2 Базы данных
  8.2.1 Базы данных ls-R
  8.2.2 kpsewhich: поиск файлов
  8.2.3 Примеры использования
  8.2.4 Отладка
 8.3 Опции запуска
9 Благодарности
10 История издания
 10.1 Прошлое
  10.1.1 2003
  10.1.2 2004
  10.1.3 2005
  10.1.4 2006–2007
 10.2 Настоящее
 10.3 Будущее

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

1 Введение

1.1 TEX Live и TEX Collection

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

TEX Live можно скачать с Интернета, а можно получить на DVD «TEX Collection». Эти DVD распространяются группами пользователей TEXа. В разделе 2.1 кратко описано содержание такого DVD. И TEX Live, и TEX Collection поддерживаются группами пользователей TEXа. В этом документе в основном описан TEX Live.

В TEX Live включены программы TEX, LaTeX2e, ConTEXt, Metafont, MetaPost, BibTeX и многие другие; обширная коллекция макросов, шрифтов и документации; а также поддержка вёрстки на многих языках мира.

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

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

1.2 Поддерживаемые операционные системы

В TEX Live включены скомпилированные программы для многих юниксоподобных систем, включая Mac OS X. Исходный код также включен в дистрибутив, что позволяет установить TEX Live на машинах, для архитектур которых мы не собрали программы.

Что касается Windows: поддерживаются только версии Windows 2000 и младше. Мы прекратили поддерживать Windows 9x, ME и NT. Это позволило значительно сократить затраты труда на эту платформу. Мы не собрали 64-битовые программы для Windows, но 32-битовые варианты должны работать на 64-битовых систем.

Альтернативные варианты для Windows и Mac OS X описаны в разделе 2.1.

1.3 Основы установки TEX Live

TEX Live можно установить с DVD или с Интернета. Программа для установки с сети сама по себе мала — она скачивает все нужное с Интернета. Это удобно, если вам нужна только часть пакетов TEX Live.

Программа установки с DVD позволяет установить TEX Live на диск компьютера, но можно также запускать TEX Live непосредственно с DVD (или с образа DVD, если ваша система поддерживает монтирование образа диска).

Всё это подробно описано в следующих разделах. Вкратце:

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

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

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

Страница для новичков:
Если вы — новичок, то страница http://tug.org/begin.html может послужить для начала.
TEX FAQ:
TEX FAQ (ЧаВо, часто задаваемые вопросы) — огромная коллекция ответов на всевозможные вопросы, от самых простых до самых сложных. Английская версия ЧаВо находится на TEX Live в разделе texmf-doc/doc/english/FAQ-en/html/index.html и доступна в Интернете по адресу http://www.tex.ac.uk/faq. Пожалуйста, начинайте поиск ответа на ваши вопросы отсюда.
TEX Catalogue:
Если вы ищете какой-либо пакет, шрифт, программу и т.п., то вам стоит заглянуть в TEX Catalogue. Это огромный каталог всего, что относится к TEXу. См. http://www.ctan.org/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, вам лучше задавать вопросы её автору или посылать их на соответствующий список рассылки. Часто соответствующий адрес можно получить при помощи опции --help нужной программы.
Русскоязычные ресурсы
(добавлено переводчиком) Эхоконференция ru.tex доступна как в сети ФИДО, так и в Интернете (как news:fido7.ru.tex). Русские группы ФИДО можно найти на многих серверах, например demos.ddt.su. В FAQ этой группы (автор — Михаил Колодин) приводится много ссылок на русскоязычные ресурсы.

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

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

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

2.1 TEX Collection: TEX Live, proTEXt, MacTEX

DVD TEX Collection содержит следующие пакеты:

TEX Live:
полная система, которой можно пользоваться либо непосредственно с DVD, либо установив на диск компьютера.
MacTEX:
вариант для Mac OS X. Этот пакет добавляет к TEX Live программу установки для Mac OS X и другие программы для Макинтошей. Страница проекта — http://www.tug.org/mactex/.
proTEXt:
улучшенный вариант дистрибутива MiKTEX для Windows. ProTEXt включает в себя дополнительные программы и упрощённую установку. Он не зависит от TEX Live и включает собственные инструкции по установке. Страница ProTEXt — http://tug.org/protext.
CTAN:
Зеркало архива CTAN.
texmf-extra:
директория с разнообразными дополнительными пакетами.

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

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

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

bin:

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

readme.html:

Странички WWW с кратким руководством для пользователя и различными ссылками, на разных языках.

source:

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

support:

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

texmf:

См. TEXMFMAIN ниже.

texmf-dist:

См. TEXMFDIST ниже.

texmf-doc:

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

tlpkg:

Скрипты, программы и другие файлы для поддержки системы. Это дерево также содержит собственные копии программ Perl и Ghostscript, невидимые вне TEX Live, а также новую оболочку для просмотра постскриптовских файлов под Windows, PSView.

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

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

Документация к самому дистрибутиву TEX Live находится в директории texmf-doc и доступна на нескольких языках:

2.3 Описание директорий texmf

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

TEXMFMAIN

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

TEXMFDIST

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

TEXMFLOCAL

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

TEXMFHOME

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

TEXMFCONFIG

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

TEXMFSYSCONFIG

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

TEXMFVAR

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

TEXMFSYSVAR

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

По умолчанию структура директорий выглядит так:

корневая директория
может содержать несколько версий TEX Live:
2007

Предыдущая версия.

...

2008

Текущая версия.

bin

 

i386-linux

Программы для GNU/Linux

...

universal-darwin

Программы для Mac OS X

win32

Программы для Windows

texmf

TEXMFMAIN.

texmf-dist

TEXMFDIST

texmf-doc

TEXMFDOC

texmf-var

TEXMFSYSVAR

texmf-config

TEXMFSYSCONFIG

texmf-local

TEXMFLOCAL, общая для всех версий TEX Live.

домашняя директория пользователя
($HOME или %USERPROFILE%)
.texlive2007

Данные и конфигурационные файлы предыдущей версии.

.texlive2008

Данные и конфигурационные файлы текущей версии.

texmf-var

TEXMFVAR

texmf-config

TEXMFCONFIG

texmf

TEXMFHOME Личные макропакеты. etc.

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

Кнутовский вариант TEXа заморожен — за исключением редких исправлений багов, в него не вносится никаких изменений. Он все ещё распространяется в TEX Live как tex и будет распространяться в обозримом будущем. В состав TEX Live входит несколько расширений TEXа:

e-TEX
добавляет набор новых примитивов (относящийся к макроподстановкам, чтению символов, дополнительным возможностям отладки и многому другому) и расширения TEX--XE T для вёрстки справа налево и слева направо. В обычном режиме e-TEX на 100% совместим со стандартнымTEXом. См. texmf-dist/doc/etex/base/etex_man.pdf.
pdfTEX
включает в себя расширения e-TEXа, добавляя поддержку формата PDF, помимо стандартного DVI. Эта программа используется большинством форматов, например, etex, latex, pdflatex. См. http://www.pdftex.org/. В руководстве пользователя texmf/doc/pdftex/manual/ и примере texmf/doc/pdftex/manual/samplepdf/samplepdf.tex описаны возможности программы.
LuaTEX
предназначен заменить pdfTEX в будущем. Предполагается, что он будет совместим с последним. Он также заменит Aleph, см. ниже. Встроенный интерпретатор языка Lua (см. http://www.lua.org/) позволяет элегантно решить многие сложные проблемы TEXа. Когда эта программа запускается как texlua, она работает как интерпретатор Lua, и в этом качестве используется в TEX Live. См. http://www.luatex.org/ и texmf-dist/doc/luatex/luatexref-t.pdf.
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.

dvipdfmx

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

psselect, psnup, …

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

lacheck

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

texexec, texmfstart

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

tex4ht

конвертер из TEXа в HTML, XML и многие другие форматы.

2.6 Шрифты в TEX Live

В TEX Live включено много векторных шрифтов высокого качества. См. http://tug.org/fonts и texmf-doc/english/free-math-fonts-survey.

3 Установка

3.1 Запуск программы установки

Для начала вам потребуется DVD TEX Collection или программа установки TEX Live с Интернета. Найдите скрипт установки: install-tl для Юникса, install-tl.bat для Windows.

Установка с сети:
скачайте программу из архива CTAN, директория systems/texlive/tlnet; адрес http://mirror.ctan.org/systems/texlive/tlnet автоматически приводит к ближайшему зеркалу архива. Вы можете скачать либо install-tl.zip (установка под Юниксом и Windows), либо файл существенно меньшего размера install-unx.tar.gz (только для Юникса). После распаковки файлы install-tl и install-tl.bat окажутся в директории install-tl.
TEX Collection DVD:
Перейдите в поддиректорию texlive. Под Windows программа установки запускается автоматически, когда вы вставляете DVD в компьютер. Вы можете получить DVD, вступив в группу пользователей TEXа (мы настоятельно рекомендуем это сделать, http://tug.org/usergroups.html), либо купив его отдельно (http://tug.org/store), либо сделав его самостоятельно, скачав ISO образ диска (http://tug.org/texlive/acquire.html).

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

3.1.1 Юникс


  ======================> TeX Live installation procedure <=====================
  
  =======> Note: Letters/digits in <angle brackets> indicate menu items <=======
  =======>       for commands or configurable options                   <=======
  
  
   Detected platform: Intel x86 with GNU/Linux
  
   <B> binary systems: 1 out of 16
  
   <S> Installation scheme (scheme-full)
  
   Customizing installation scheme:
     <C> standard collections
     <L> language collections
     83 collections out of 84, disk space required: 1666 MB
  
   <D> directories:
     TEXDIR (the main TeX directory):
       !! default location: /usr/local/texlive/2008
       !! is not writable, please select a different one!