Рис. 1: Первая ступень установки под Windows (.exe)
В этом документе описаны основные возможности программного продукта TEX Live — дистрибутива TEXа и других программ для GNU/Linux и других UNIXов, Mac OS X и 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 и многие другие; обширная коллекция макросов, шрифтов и документации; а также поддержка вёрстки на многих языках мира.
Краткий список основных изменений в этом издании TEX Live можно найти в разделе 10, стр. 76.
В TEX Live включены скомпилированные программы для многих вариантов UNIX, включая GNU/Linux, Mac OS X и Cygwin. Исходный код также включён в дистрибутив, что позволяет компилировать TEX Live и на платформах, для которых мы не включили собранных программ.
Что касается Windows: поддерживаются версии Windows XP и младше. Программы также более или менее работоспособны под Windows 2000. Мы не собрали 64-битовые программы для Windows, но 32-битовые варианты должны работать на 64-битовых систем.
Альтернативные варианты для Windows и Mac OS X описаны в разделе 2.1.
TEX Live можно установить с DVD или с Интернета (http://tug.org/texlive/acquire.html). Программа для установки с сети сама по себе мала — она скачивает все нужное с Интернета.
Программа установки с DVD позволяет установить TEX Live на диск компьютера. Вы не сможете запускать TEX Live непосредственно с DVD, но вы можете собрать работающую версию TEX Live, например, на флешке USB (см. 5). Установка системы подробно описана в следующих разделах (стр. 11), но вкратце она состоит в следующем:
Насколько мы можем сказать, основные программы TEXа были и остаются очень надежными. Однако несмотря на все усилия, некоторые программы дистрибутива могут не достичь этого уровня. Как обычно, вы должны быть осторожны, обрабатывая любыми программами ненадежные исходные данные; для безопасности делайте это в отдельной поддиректории.
Особенной осторожности требует работа под Windows, поскольку Windows обычно запускает в первую очередь копию программы из текущей директории, даже если существует другая копия там, где в системе обычно находятся бинарники. Это открывает много возможностей для хакерских атак. Мы закрыли много дыр в безопасности, но без сомнения, ещё больше дыр осталось, особенно в предоставленных нам чужих программах. Поэтому мы рекомендуем проверять подозрительные файлы в рабочей директории, особенно исполняемые файлы (бинарники и скрипты). Обычно их там быть не должно, и вёрстка документов не должна их создавать.
Наконец, TEX (и вспомогательные программы) способны писать в файлы при обработке документов. Это можно использовать для атаки разнообразными способами. И опять, безопаснее всего обрабатывать неизвестные документы в отдельной директории.
Сообщество пользователей TEXа активно и дружелюбно, и практически на каждый серьёзный вопрос найдётся ответ. Однако эта поддержка неформальна, выполняется добровольцами, и поэтому очень важно, чтобы вы сами попробовали найти ответ перед тем, как задавать вопрос. (Если вы предпочитаете коммерческую поддержку, возможно вам ст´оит вместо TEX Live купить одну из коммерческих версий TEXа, см. список по адресу http://tug.org/interest.html#vendors).
Вот список источников поддержки, приблизительно в том порядке, в котором мы рекомендуем к ним обращаться:
С другой стороны, вы сами тоже можете помочь тем, у кого есть вопросы. И comp.text.tex, и texhax, и fido7.ru.tex открыты для всех, поэтому вы тоже можете присоединиться, читать и помогать другим.
Этот раздел описывает структуру и содержание TEX Collection и его составной части TEX Live.
DVD TEX Collection содержит следующие пакеты:
Лицензии на использование CTAN, protext и texmf-extra могут отличаться от лицензии TEX Live, поэтому будьте внимательны при распространении или модификации программ, входящих в эти дистрибутивы.
Вот краткое описание корневых директорий в дистрибутиве TEX Live.
Программы системы TEX, сгруппированные по платформам.
Краткое руководство пользователя и коллекция ссылок на разных языках, в текстовом формате и формате HTML.
Исходный код всех программ, включая дистрибутивы Web2C TEX и Metafont.
См. TEXMFDIST ниже.
Скрипты, программы и другие файлы для поддержки системы, а также некоторые полезные программы для Windows
Кроме этих директорий, в корневой директории находятся скрипты установки и файлы README (на разных языках).
Файл doc.html в корневой директории содержит много ссылок на полезную документацию. Документация к отдельным программам (руководства, man, info) находится в директории texmf-dist/doc. Документация макропакетов и форматов находится в директории texmf-dist/doc. Для поиска документации можно воспользоваться программой texdoc.
Документация к самому дистрибутиву TEX Live находится в директории texmf-dist/doc/texlive и доступна на нескольких языках:
В этом разделе описаны все переменные, задающие положение деревьев директорий texmf и их значения по умолчанию. Команда tlmgr conf показывает текущие значения этих переменных, так что вы можете определить, где эти директории находятся в вашей системе.
Дерево, где находятся практически все файлы дистрибутива: кнофигурационные файлы, шрифты, скрипты, пакеты и т.д. (основное исключение — зависящие от архитектуры программы, которые находятся в директории bin/.)
Дерево, которое может быть использовано администраторами системы для дополнительных пакетов, шрифтов и т.д.
Дерево, которое пользователи могут использовать для установки собственных пакетов, шрифтов и т.д., или для обновлённых версий системных пакетов. Эта переменная указывает на дерево в домашней директории, своей для каждого пользователя.
Это дерево используется утилитами texconfig, updmap и fmtutil для хранения модифицированных файлов конфигурации (своих для каждого пользователя)
Это дерево используется утилитами texconfig-sys, updmap-sys и fmtutil-sys для хранения модифицированных файлов конфигурации, общих для всех пользователей.
Это дерево используется утилитами texconfig, updmap и fmtutil для хранения создаваемых автоматически файлов: форматов, карт шрифтов.
Это дерево используется программами ConTEXt MkIV и LuaLATEX для хранения файлов, создаваемых автоматически при работе программ. По умолчанию совпадает с TEXMFSYSVAR, или, если эта директория закрыта для записи, TEXMFVAR.
Это дерево используется утилитами texconfig-sys, updmap-sys, fmtutil-sys, а также tlmgr для хранения создаваемых автоматически файлов: форматов, карт шрифтов, — общих для всех пользователей.
По умолчанию структура директорий выглядит так:
Предыдущая версия.
Текущая версия.
Программы для GNU/Linux
Программы для Mac OS X
Программы для Windows
TEXMFDIST и TEXMFMAIN
TEXMFSYSVAR, TEXMFCACHE
TEXMFSYSCONFIG
TEXMFLOCAL, общая для всех версий TEX Live.
Данные и конфигурационные файлы предыдущей версии.
Данные и конфигурационные файлы текущей версии.
TEXMFVAR
TEXMFCONFIG
TEXMFHOME Личные макропакеты и т.д.
Кнутовский вариант TEXа заморожен — за исключением редких исправлений багов, в него не вносится никаких изменений. Он распространяется в TEX Live как tex и будет распространяться в обозримом будущем. В состав TEX Live входит несколько расширений TEXа:
Вот несколько других важных программ в дистрибутиве TEX Live:
поддержка библиографий.
поддержка алфавитных указателей.
преобразование DVI в PostScript.
программа для просмотра DVI для X Window System.
драйвер для лазерных принтеров семейства HP LaserJet.
перестановка страниц в файлах DVI.
преобразование DVI в PDF, альтернатива pdfTEXу, упомянутому выше.
утилиты для работы с файлами в формате PostScript.
утилиты для работы с файлами в формате PDF.
Программы для ConTEXtа и обработки PDF.
tex4ht: конвертер из (LA )TEXа в HTML, (и XML и многие другие форматы).
Для начала вам потребуется DVD TEX Collection или программа установки TEX Live с Интернета. Подробно различные способы приобретения и установки дистрибутива рассмотрены на странице http://tug.org/texlive/acquire.html.
Во всех случаях программа установки системы одна и та же. Главное различие состоит в том, что при установке с сети ставятся последние версии пакетов — в отличие от установки с DVD или ISO.
В следующих разделах установка описывается более подробно.
Ниже > указывает системный промпт; то, что вводит пользователь, показано жирным шрифтом. Проще всего начать установку так:
Для установки в экспертном графическом режиме (рисунок 3) вам потребуется модуль Perl::TK, собранный с поддержкой XFT (он обычно есть в системах GNU/Linux, но может отсутствовать на других системах). Если он у вас установлен, используйте
Полный список возможных опций дает команда
Предупреждение о правах доступа в UNIX: система установки TEX Live использует текущее значение параметра umask. Поэтому если вы хотите, чтобы системой могли пользоваться не только вы, но и другие пользователи, вы должны установить, например, umask 022. Более подробно umask обсуждается в документации к вашей системе.
Замечание об установке под Cygwin: в отличие от других систем типа UNIX, Cygwin в стандартной конфигурации не включает всех необходимых для установки TEX Live программ. См. раздел 3.1.4.
+
Как отмечается в разделе 2.1, для Mac OS X существует специальный дистрибутив, MacTEX (http://tug.org/mactex). Мы рекомендуем пользоваться его системой установки, а не общим скриптом TEX Live, поскольку у него есть дополнительные возможности, специфические для Макинтошей, например, удобное переключение между различными дистрибутивами TEXа для Mac OS X (MacTEX, Fink, MacPorts, …) используя так называемую структуру TEXDist.
MacTEX основан на TEX Live, основные деревья директорий и программы у этих дистрибутивов совпадают. MacTEX добавляет несколько поддиректорий с программами и документацией, предназначенными для Макинтошей.
Если вы устанавливаете систему с сети при помощи распакованного архива .zip, или если программа установки с DVD не стартовала автоматически, дважды щёлкните по install-tl.bat. Если вам нужна более тонкая настройка, например, если вы хотите выбрать определенные коллекции пакетов, запустите install-tl-advanced.bat.
Можно также запустить программу из командной строки. Ниже > означает системный промпт; то, что вводит пользователь, указано жирным шрифтом. Если вы находитесь в директории программы установки, напечатайте:
Программу можно вызвать и из другой директории, например,
Для установки в текстовом режиме используйте
Все опции программы можно получить при помощи команды
Перед началом установки TEX Live, установите при помощи программы setup.exe из комплекта Cygwin пакеты perl и wget, если их нет в вашей системе. Мы рекомендуем также следующие дополнительные пакеты:
На рисунке 2 показано основное меню программы установки в текстовом режиме для UNIX. Текстовый режим является режимом по умолчанию для UNIX.
Интерфейс программы довольно примитивен: поддержки курсора в нем нет. Например, нельзя передвигаться по полям при помощи клавиши «Tab». Вы просто печатаете что-то (регистр учитывается!) и нажимаете клавишу «Enter», после чего перерисовывается весь экран.
Этот интерфейс примитивен не случайно: он должен работать на как можно большем количестве платформ, включая такие, где есть только усеченный вариант программы Perl.
На рисунке 3 изображено меню программы установки в графическом режиме под GNU/Linux. Основное различие между этим рисунком и рисунком 2 в том, что в первом используются кнопки и меню.
Этот вариант может быть выбран командой
Под Windows установка по умолчанию работает в самом простом режиме, который мы только могли придумать, напоминающий интерфейс «Проводника установки». Он устанавливает все и (почти) не задает никаких вопросов. Если вы хотите более тонкую настройку, вызовите другой режим.
Для других платформ этот режим может быть выбран командой
Меню программы установки должно быть понятно без объяснений. Мы все же приведем несколько кратких замечаний по поводу различных опций и подменю.
На рисунке 5 изображено меню выбора платформы. По умолчанию устанавливаются только программы для вашей текущей архитектуры. В этом меню вы можете выбрать также установку программ для других платформ. Это может быть полезно, если вы используете одно и то же дерево TEXа для разных машин и раздаёте его по локальной сети, либо если на вашей машине установлено несколько операционных систем.
На рисунке 6 показано меню выбора основных компонентов (схем) TEX Live. В этом меню вы можете выбрать «схему», т.е. набор коллекций пакетов. По умолчанию используется схема full, т.е. все пакеты TEX Live, но вы можете выбрать схему basic для небольшой системы, схему minimal для тестирования или схемы medium или teTeX. Есть также ряд специальных схем, в том числе и предназначенных для различных стран.
Вы можете уточнить ваш выбор при помощи меню «коллекций» (рисунок 7, для разнообразия сделанный в графическом режиме).
Коллекции представляют собой следующий после схем уровень иерархии TEX Live. Грубо говоря, схемы состоят из коллекций, коллекции состоят из пакетов, а пакеты (нижний уровень иерархии TEX Live) содержат макросы, шрифты и т.д.
Если вы хотите более тонкой настройки, чем возможна в меню коллекций, вы можете использовать программу tlmgr после установки (см. раздел 6). Эта программа позволяет устанавливать или удалять отдельные пакеты.
Схема директорий по умолчанию описана в разделе 2.3, стр. 8. Положение дерева TEXDIR отличается для Windows (%SystemDrive%\texlive\2014) и UNIX (/usr/local/texlive/2014). Таким образом, по умолчанию у вас будет параллельно установлено несколько систем, и вы сможете переключаться между ними, изменив список директорий поиска программ.
Вы можете изменить это, задав для программы-установщика другое значение параметра TEXDIR. Основная причина, по которой бывает необходимо изменить эту схему — отсутствие у вас прав на запись в нужные директории. Вам не надо иметь права администратора для установки TEX Live, однако вам надо иметь право на запись в директорию, куда устанавливается система.
Если у вас нет права на запись в системные директории, естественной альтернативой является установка в вашу домашнюю директорию, особенно если вы будете единственным пользователем системы. Для этого используйте ‘~’ например ‘~/texlive/2014’.
Мы рекомендуем включать номер года в название директории, чтобы можно было держать отдельно разные версии TEX Live. Вы также можете использовать общее имя, не зависящее от года, например, /usr/local/texlive-cur, создав ссылку на соответствующую директорию.
Изменение TEXDIR изменит также TEXMFLOCAL, TEXMFSYSVAR и TEXMFSYSCONFIG.
Личные пакеты и файлы рекомендуется держать в директории TEXMFHOME. По умолчанию это ~/texmf. В отличие от TEXDIR, здесь ~ будет своим для каждого пользователя. Эта переменная становится $HOME под UNIX и %USERPROFILE% под Windows. На всякий случай повторим, что структура TEXMFHOME должна совпадать со стандартной структурой директорий TEXMF, иначе система может не найти ваши файлы.
Директория TEXMFVAR используется для хранения автоматически создаваемых файлов, своих для каждого пользователя. Директория TEXMFCACHE используется для этой же цели программой ConTEXt MkIV (см. раздел 3.4.5, стр. 41), по умолчанию это директория TEXMFSYSVAR, или, если она закрыта для записи, TEXMFVAR.
На рисунке 8 приведено меню опций (текстовый режим). Стоит упомянуть несколько из них:
Задав нужные настройки, вы можете начать установку системы, нажав клавишу «I». Когда установка будет закончена, перейдите к разделу 3.4 чтобы проверить, нужно ли вам сделать ещё что-нибудь.
Напечатайте
Если возможно, использовать графический режим. Для этого нужен модуль Perl/Tk с поддержкой XFT (http://tug.org/texlive/distro.html#perltk); если этого модуля в системе нет, установка происходит в текстовом режиме.
Использовать текстовый режим, даже под Windows.
Задать язык интерфейса программы установки (стандартным кодом страны, обычно двухбуквенным). Программа установки пытается определеть нужный язык автоматически, но если это не получается или если нужный язык не поддерживается, она переходит на английский. Команда install-tl --help выдает список языков.
(Документируется здесь для полноты; не используйте эту, опцию если вы не эксперт). Если у вас уже есть копия TEX Live, полученная из репозитория по rsync, svn или иным способом (см. http://tug.org/texlive/acquire-_mirror.html), то эта опция позволяет использовать эту копию. Учтите, что при этом база данных tlpkg/texlive.tlpdb может быть затерта; вы должны сохранить её сами. Кроме того, удаление пакетов нужно будет делать вручную. Эту опцию нельзя выбрать из интерфейса установщика.
Установить переносимую версию TEX Live, например, на флешку USB. Эту опцию также можно указать при помощи команды V в текстовом установки, или из графического режима. См. также раздел 5.
Использовать конфигурацию установки le и не задавать пользователю никаких вопросов. Программа установки всегда записывает файл texlive.profile в поддиректорию tlpkg. Этот фаил может быть использован в качестве аргумента данной опции, чтобы, например, получить идентичную конфигурацию на другой машине. Вы можете также создать собственную конфигурацию, например, взяв за основу автоматически созданный файл или пустой файл (так что параметры, которые не заданы в файле, получат значения по умолчанию).
Указать альтернативный источник о пакетов для установки; см. ниже.
По умолчанию пакеты сгружаются с одного из зеркал архива CTAN. Ссылка http://mirror.ctan.org автоматически выбирает зеркало.
Если вы хотите указать другой источник, вы можете задать его как URL, начинающийся с ftp:, http:, file:/ или просто как директорию на диске. (Когда вы указываете репозиторию как ftp: или http:, окончание / или /tlpkg игнорируется.)
Например, вы можете задать в качестве параметра определенное зеркало CTAN: http://ctan.example.org/tex-_archive/texlive/tlnet/. Разумеется, вам следует подставить вместо example.ctan.org нужное зеркало и путь к архиву на этом зеркале. Список зеркал находится на http://ctan.org/mirrors.
Если параметр задает директорию на диски (прямо или при помощи file:/), система автоматически определяет, является ли источник архивом: если найдена поддиректория archive со сжатыми файлами, то она будет использована, даже если рядом находятся незаархивированные файлы.
Иногда после установки системы требуются дополнительные действия.
Если бы решили создать симлинки в стандартных директориях (см. раздел 3.2.4), то изменять переменные окружения не требуется. В противном случае вам нужно добавить к списку поиска программ директорию, где лежат программы TEXlive (под Windows программа установки делает это сама).
Программы для каждой архитектуры помещаются в собственную поддиректорию под TEXDIR/bin. См. список поддиректорий и соответствующих платформ на рисунке 5.
Вы можете также добавить директории с документацией в формате man и info к соответствующим путям поиска, если вы хотите, чтобы ваша операционная система знала о них. В некоторых системах документация в формате man будет найдена автоматически после изменения переменной PATH.
Ниже мы используем для примера стандартную систему директорий в системе Intel86 GNU/Linux.
Для оболочек типа Bourne (bash и т.п.) вы можете добавить в файл $HOME/.profile (или в файл, который вызывается из .profile) следующее:
Для csh или tcsh следует редактировать файл $HOME/.cshrc, и следует добавить что-то вроде
Разумеется, в ваших конфигурационных файлах уже могут быть определены эти переменные; фрагменты выше добавляют к ним директории TEX Live.
Если вы хотите внести эти изменения для всех пользователей, или добавлять их автоматически для новых пользователей, то вам следует разобраться самому: в разных системах это делается слишком по-разному.
Два совета: 1) возможно, вам следует добавить в файл /etc/manpath.config строчки вроде:
И 2) иногда пути поиска и другие глобальные переменные окружения задаются в файле /etc/environment.
Мы также добавляем симлинк man в каждой поддиректории bin. Некоторые варианты программы man, например, в Mac OS X, автоматически ищут файлы в этих поддиректориях, что избавляет от необходимости добавлять их в MANPATH.
Если вы устновили TEX Live с DVD и хотите получать обновления из Интернета, запустите следующую команду (после добавления программ TEX Live к списку поиска программ, см. предыдущий раздел):
Она указывает программе tlmgr, что нужно искать обновления на ближайшем зеркале CTAN. Это делается по умолчанию при установке с DVD при помощи опций, описанных в разделе 3.2.4.
Если автоматический выбор зеркала не работает, вы можете указать адрес зеркала вручную, взяв его из списка на http://ctan.org/mirrors. Задайте при этом точное положение директории tlnet, как указано выше.
XeTEX и LuaTEX могут использовать все шрифты, установленные в вашей системе, не только те, которые находятся в директориях TEXа. Они это делают при помощи похожих, но чуть-чуть разных методов.
Под Windows шрифты, включенные в дистрибутив TEX Live, автоматически доступны в XeTEXе. Но если вы установили пакет xetex под UNIX, то вам нужно настроить вашу систему, чтобы XeTEX мог найти шрифты TEX Live по названию шрифта, а не только по имени файла.
Чтобы помочь этому, когда пакет xetex устанавливается (либо при первоначальной установке дистрибутива, либо позже), он создает необходимый конфигурационный файл в TEXMFSYSVAR/fonts/conf/texlive-fontconfig.conf.
Если вы обладаете правами администратора, то для того, чтобы шрифты TEX Live были доступны всем программам, сделайте следующее:
Если у вас нет прав администратора, то вы можете вместо этого сделать шрифты TEX Live доступными только вам:
Чтобы посмотреть названия системных шрифтов, вы можете запустить программу fc-list. Можно получить много интересной информации, запустив её как fc-list : family style file spacing (все аргументы—текстовые строки).
Как «старый» ConTEXt(Mark II), так и «новый> ConTEXt (Mark IV) должны работать «из коробки» после установки TEX Live и после обновления системы при помощи tlmgr.
Однако так как ConTEXt MkIV не использует библиотеку kpathsea, после установки новый файлов вручную (не при помощи tlmgr) нужны дополнительные действия. Каждый пользователь MkIV должен после такого обновления запустить
чтобы обновить базу данных ConTEXt. Получившиеся файлы будут установлены в директории TEXMFCACHE. В TEX Live эта директория совпадает с TEXMFVAR.
ConTEXt MkIV читает файлы из всех директорий, заданных переменной TEXMFCACHE и пишет в первую директорию в списке, в которой у него есть права на запись. При чтении в случае дублирующих записей имеет преимущество последняя прочитанная запись.
См. также http://wiki.contextgarden.net/Running_Mark_IV.
Этот вопрос уже обсуждался в разделе 2.3: для локальных шрифтов и пакетов, общих у всех пользователей, предназначена директория TEXMFLOCAL (по умолчанию, /usr/local/texlive/texmf-local или %SystemDrive%\texlive\texmf-local), а для личных шрифтов и пакетов — директория TEXMFHOME (по умолчанию, $HOME/texmf или %USERPROFILE%\texmf). Эти директории предполагаются общими для всех версий TEX Live, и каждая версия TEX Live видит их автоматически. Поэтому мы не рекомендуем менять значение TEXMFLOCAL, иначе вам придется делать это для каждой новой версии.
Файлы в обеих директориях должны находиться в правильных поддиректориях; см. http://tug.org/tds и texmf-dist/web2c/texmf.cnf. Например, LATEXовский класс или пакет должен находиться в директории TEXMFLOCAL/tex/latex или TEXMFHOME/tex/latex или какой-либо из их поддиректорий.
Для директории TEXMFLOCAL должна поддерживаться база данных о файлах, иначе система не сможет найти там нужные файлы. Эта база обновляется командой mktexlsr или кнопкой «Reinit file database» в графическом режиме программы tlmgr.
По умолчанию, каждая из этих переменных указывает на одну директорию, как в нашем примере. Однако это не обязательное требование. Если вам нужно, например, поддерживать несколько версий больших пакетов, вы можете захотеть иметь несколько деревьев директорий. Тогда вы можете определить TEXMFHOME как набор директорий в фигурных скобках, разделенных запятыми:
Подробнее эти вопросы объясняются в разделе 8.1.5.
К сожалению, это очень сложная задача. Не делайте этого, если вы не знаете TEXа как свои пять пальцев. В состав TEX Live включено много шрифтов, поэтому полезно сначала проверить, не входит ли нужный шрифт в дистрибутив.
Возможная альтернатива — программа XeTEX (см. раздел 2.4), которая позволяет автоматически использовать в TEXе шрифты вашей операционной системы.
Если вам все же нужно добавить шрифты, то посмотрите страницу http://tug.org/fonts/fontinstall.html — это лучшее, что мы смогли написать по этому поводу. Если вы правильно поддерживаете карты шрифтов, tlmgr generate updmap может оказаться полезной, особенно при переходе на новую версию TEX Live; см. документацию программы tlmgr.
После установки TEX Live вы, скорее всего, захотите проверить работу системы, а уже затем перейти к созданию прекрасных документов и/или шрифтов.
Вы можете начать с программы для редактирования файлов. TEX Live устанавливает TEXworks (http://tug.org/texworks) под Windows, а MacTEX устанавливает TeXShop (http://pages.uoregon.edu/koch/texshop. На других системах выбор редактора остается за вами. Есть много возможностей, некоторые из которых перечислены ниже; см. также http://tug.org/interest.html#editors. Вообще говоря, годится любой текстовый редактор.
В этом разделе описываются основные процедуры по тестированию системы. Мы приводим команды для операционных систем типа Unix; под Mac OS X и Windows вы, скорее всего, будете использовать графический интерфейс, но принцип тот же.
Более простой документ, чем sample2e, удобный, если последний слишком велик для вас.
Проверяет поля и позиционирование бумаги для вашего принтера.
Используется для печати таблиц шрифтов и тестов.
Печать таблиц шрифтов под plain TEX.
Самый канонический файл в формате (plain) TEX. Вы должны напечатать «\bye» в ответ на приглашение * после «tex story.tex».
Если вы получите сообщение об ошибке: «Invalid fontname ‘Latin Modern Roman/ICU’…», то вам нужно настроить систему, чтобы можно было найти шрифты TEX Live. См. раздел 3.4.4.
Если вы новичок в TEXе, или вам нужна помощь в создании документов на языке TEX или LATEX, посетите http://tug.org/begin.html.
Вот ссылки на некоторые другие программы, которые вам могут пригодиться:
Гораздо более полный лист программ и пакетов находится на http://tug.org/interest.html.
В предыдущих разделах описывались основы процесса установки TEX Live. Здесь мы остановимся на нескольких особых случаях.
TEX Live может использоваться одновременно разными пользователями или даже разными машинами в локальной сети. В стандартной схеме директорий все пути к файлам являются относительными: программы TEX Live определяют, где лежат нужные им файлы, исходя из того, где они находятся сами. Вы можете увидеть, как это делается, посмотрев конфигурационный файл $TEXMFDIST/web2c/texmf.cnf со строчками типа
Это означает, что другие системы или пользователи должны просто добавить директорию с программами TEX Live к директориям поиска.
Точно так же вы можете установить TEX Live на один компьютер, а затем перенести всю иерархию на локальную сеть.
Под Windows скрипт для установки системы в локальной сети называется w32client и находится на http://tug.org/texlive/w32client.html. Он добавляет к уже установленной системе TEX Live необходимые для работы в локальной сети изменения. Есть также скрипт для удаления этих изменений w32unclient. См. более подробное описание на странице скрипта выше.
Опция программы установки -portable (или команда V в текстовом режиме, или соответствующий пункт меню в графическом режиме) создает систему, находящуюся полностью в своей директории, и не изменяет конфигурации компьютера. Вы можете установить такую систему на USB флешку или в отдельную директорию, а потом скопировать её на флешку.
Чтобы запустить TEX с такой флешки, вам нужно добавить директорию с программами к путям поиска программ. Под Юниксом это делается при помощи изменения переменной окружения PATH. Под Windows вы можете щелкнуть на tl-tray-menu, чтобы выбрать из нескольких стандартных задач, как показано ниже:
Меню «Custom Script» вызывает окошко с объяснением, как добавить дополнительные возможности в меню.
Если вам не нужно часто обновлять систему, и/или у вас несколько машин, на которых вы хотите использовать TEX Live, то для вас может иметь смысл создать образ ISO или DVD, так как:
Разумеется, вы можете также прожечь реальный DVD, если это вам удобнее.
Десктопные версии GNU/Linux/Unix, включая Mac OS X, умеют монтировать ISO. Windows 8 — первая (!) система семейства Windows, которая умеет это делать. В остальном установка такая же, как при установке на жесткий диск, см. раздел 3.4.1.
При установке на ISO имеет смысл не делать поддиректорию для года текущей версии, и устанавливать texmf-local на том же уровнем что и другие деревья (texmf-dist, texmf-var, и т. д.). Это можно сделать при помощи опций программы установки.
Для обычной (не виртуальной) машины под Windows вы можете прожечь ISO на DVD. Однако возможно, что вам будет удобно использовать разнообразные свободные программы для монтирования виртуальных дисков, например, WinCDEmu, http://wincdemu.sysprogs.org/.
Для лучшего взаимодействия с системой, вы можете включить скрипты для w32client, описанные в разделе 4.1 и на странице http://tug.org/texlive/w32client.html. Они работают с ISO точно так же, как и с системой в локальной сети.
Под Mac OS X TeXShop может использовать систему на DVD, если симлинк /usr/texbin указывает на директорию с программами для нужной архитектуры, например
Историческая справка: TEX Live 2010 была первым изданием TEX Live, который не мог работать непосрественно с диска («live»). Однако для работы с DVD или ISO всегда нужны были дополнительные усилия: например, необходимо было установить хотя бы одну переменную окружения. Если бы создаете образ ISO из существующей системы, то в этом нет нужды.
В TEX Live входит программа tlmgr для администрирования системы после установки. Программы updmap, fmtutil и texconfig все ещё есть в системе и будут там в будущем, но мы рекомендуем теперь программу tlmgr. Среди её возможностей:
Программа tlmgr может быть запущена в графическом режиме:
На рисунках 10 и 11 показаны главное меню и меню выбора размера бумаги.
После первоначальной установки вы можете обновить систему до последних версий, имеющихся на сети:
В более сложном примере мы добавляем новую коллекцию (XeTEX) из локальной директории:
Как вы видите, tlmgr учитывает зависимости между пакетами, и сама делает нужные после установки шаги, включая обновление базы имен файлов и перегенерирование форматов. В примере выше она создала новые форматы для программы XeTEX.
Описание пакета (или коллекции или схемы):
И наконец, полная документация находится по адресу http://tug.org/texlive/tlmgr.html или вызывается командой
Под Windows программа установки делает несколько дополнительных вещей:
Для полноты дистрибутиву TEX Live необходимы дополнительные пакеты, которые обычно не встречаются на машине под Windows. В TEX Live есть недостающие программы и пакеты:
Аналогом домашней директории под UNIX является директория %USERPROFILE%. Под Windows XP это обычно C:\Documents and Settings\<username>, а под Windows Vista и младше — C:\Users\<username>. В файле texmf.cnf и вообще при работе Kpathsea, тильда ~ правильно интерпретируется как домашняя директория пользователя и под Windows, и под UNIX.
Windows хранит почти все конфигурационные данные в регистре. Регистр содержит набор иерархически организованных записей, с несколькими корневыми записями. Наиболее важны для программ установки записи HKEY_CURRENT_USER и HKEY_LOCAL_MACHINE, сокращенно HKCU и HKLM. Как правило, HKCU находится в домашней директории пользователя (см. раздел 7.3), а HKLM — поддиректория директории Windows.
Иногда конфигурация системы определяется переменными окружения, но некоторые вещи (например, положение ярлыков) задаются в регистре. Для того, чтобы перманентно задать переменные окружения, также нужен доступ к регистру.
В поздних версиях Windows делается различие между обычными пользователями и администраторами, причем только последние имеют право доступа ко всей операционной системе. Мы постарались сделать возможным установку TEX Live без прав администратора.
Если программа устанвки запущена с привилегиями администратора, она может установить TEX Live для всех пользователей. В этом случае ярлыки создаются у всех пользователей, и модифицируются системные параметры. В противном случае ярлыки и меню создаются только для текущего пользователя, и модифицируются его параметры.
Вне зависимости от статуса пользователя, корень установки TEX Live, предлагаемый по умолчанию, всегда находится под %SystemDrive%. Программа установки всегда проверяет, открыта ли корневая директория на запись для текущего пользователя.
Может возникнуть проблема, если у пользователя нет прав администратора, а в пути поиска уже есть TEX. Поскольку в пути поиска системный путь стоит перед путем пользователя, TEX из TEX Live не будет найден. Чтобы обойти эту проблему, программа в таком случае создает ярлык с командной строкой, в которой директория TEX Live стоит первой в пути поиска. Из этой командной строки можно пользоваться TEX Live. Ярлык для TEXworks, если эта программа установлена, также добавляет директории TEX Live в начало пути поиска.
У Windows Vista и новее есть ещё одна особенность: даже если вы являетесь администратором, вам нужно отдельно указать административные права при запуске программ. Поэтому не имеет особого смысла заходить в систему как администратор: вместо этого, щелкнув правой клавишей мыши на ярлык, выберите из меню «Run as administrator».
Пользователи Windows и Cygwin (см. раздел 3.1.4 об особенностях установки под Cygwin) могут обнаружить, что для некоторых программ TEX Live не хватает оперативной памяти. Например, программа asy может не запуститься, если вам нужно разместить массив в 25 000 000 числе с плавающей точкой, а LuaTEX может не справиться с документом, в котором много разных шрифтов.
Под Cygwin можно увеличить используемый объем памяти, если воспользоваться инструкциями в Руководстве пользователя Cygwin (http://www.cygwin.com/cygwin-_ug-_net/setup-_maxmem.html).
Под Windows нужно создать файл, скажем, moremem.reg, со следующими четырьмя строками:
а затем выполнить как администратор команду regedit /s moremem.reg. Если вы хотите изменить этот параметр только для текущего пользователя, то в третьей строке надо написать HKEY_CURRENT_USER.
Web2C — это интегрированная коллекция программ, относящихся к TEXу: сам TEX, Metafont, MetaPost, BibTeX, и т.д. Это сердце TEX Live. Страница Web2C с руководством пользователя и многим другим находится на http://tug.org/web2c.
Немного истории. Первая версия программы была написана Томасом Рокики, который в 1987 году создал систему TEX-to-C, адаптировав патчи для UNIX, разработанные в основном Говардом Трики и Павлом Куртисом. Тим Морган стал поддерживать систему, и в этот период её название сменилось на Web-to-C. В 1990 году Карл Берри взял на себя этот проект, координируя работу десятков программистов, а в 1997 он передал руководство Олафу Веберу, который вернул его Карлу в 2006 году.
Система Web2C работает под UNIX, 32-битовых Windows, Mac OS X, и других операционных системах. Она использует оригинальные исходники Кнута для TEXа и других программ, написанных на языке WEB и переведённых на C. Основные программы системы:
Поддержка библиографий.
Работа с виртуальными шрифтами в файлах DVI.
Перевод DVI в MPX (рисунки в MetaPost).
Перевод DVI в текст.
Гранки шрифтов.
Упаковка шрифтов
Перевод GF в текст.
Создание шрифтов.
Вёрстка исходников Metafont.
Рисование диаграмм.
Создание таблиц переносов.
Перевод PK в GF.
Перевод PK в текст
Перевод из списка свойств шрифта в TFM.
Расшифровка файлов pool в WEB.
Перевод WEB в Pascal.
Вёрстка.
Перевод TFM в список свойств шрифта.
Перевод виртуального шрифта в список свойств шрифта.
Перевод списка свойств шрифта в виртуальный шрифт.
Перевод WEB в TEX.
Полностью эти программы описаны в документации к соответствующим пакетам и самой Web2C. Однако знание некоторых общих принципов для всей семьи программ поможет вам полнее использовать программы системы Web2C.
Все программы поддерживают стандартные опции GNU:
напечатать краткую справку
печатать подробную информацию по мере работы
Напечатать версию программы и завершить работу.
Для поиска файлов программы Web2C используют библиотеку Kpathsea (http://tug.org/kpathsea). Эта библиотека использует комбинацию переменных окружения и конфигурационных файлов, чтобы найти нужные файлы в огромной системе TEX. Web2C может просматривать одновременно больше одного дерева директорий, что полезно для работы со стандартным дистрибутивом TEXа и его локальными расширениями. Для ускорения поисков файлов каждое дерево содержит файл ls-R, в котором указаны названия и относительные пути всех файлов в этом дереве.
Рассмотрим сначала общий алгоритм библиотеки Kpathsea.
Будем называть путём поиска набор разделённых двоеточием или точкой с запятой элементов пути, представляющих из себя в основном названия директорий. Путь поиска может иметь много источников. Чтобы найти файл «my-file» в директории «.:/dir», Kpathsea проверяет каждый элемент пути по очереди: сначала ./my-file, затем /dir/my-file, возвращая первый файл (или, возможно, все файлы).
Чтобы работать с разными операционными системами, Kpathsea под системой, отличной от UNIX может использовать разделители, отличные от «:» и «/».
Чтобы проверить определённый элемент пути p, Kpathsea вначале проверяет наличие базы данных (см. раздел «База данных файлов» на стр. 66), т.е., есть ли база в директории, которая является префиксом для p. Если это так, спецификация пути сравнивается с содержимым базы данных.
Если база данных не существует, или не относится к этому элементу пути, или не содержит нужного элемента, проверяется файловая система (если это не запрещено спецификацией, начинающейся с «!!», и если файл должен существовать). Kpathsea конструирует список директорий, которые соответствуют элементу, и в каждой директории ищет нужный файл.
Условие «файл должен существовать» важно для файлов «.vf» и файлов, которые открывает TEX по команде \openin. Такие файлы могут и не существовать (например, файл cmr10.vf), и было бы неправильно искать их на диске. Поэтому, если вы не обновите ls-R при установке нового файла «.vf», он никогда не будет найден. Каждый элемент пути ищется по очереди: сначала база данных, затем диск. Если нужный файл найден, поиск останавливается, и возвращается результат.
Хотя самый простой и часто встречающийся элемент пути — это название директории, Kpathsea поддерживает дополнительные возможности: разнообразные значения по умолчанию, имена переменных окружения, значения из конфигурационных файлов, домашние директории пользователей, рекурсивный поиск поддиректорий. Поэтому мы говорим, что Kpathsea вычисляет элемент пути, т.е., что библиотека преобразует спецификации в имя или имена директории. Это описано в следующих разделах в том же порядке, в котором происходит поиск.
Заметьте, что имя файла при поиске может быть абсолютным или относительным, т.е. начинаться с «/», или «./», или «../», Kpathsea просто проверяет, существует ли файл.
Путь поиска может иметь разные источники. Kpathsea использует их в следующем порядке:
Вы можете увидеть каждое из этих значений для данного пути поиска, задав соответствующий уровень отладки (см. «Отладка» на стр. 69).
Kpathsea читает конфигурационные файлы texmf.cnf, в которых задаются параметры программы. Раньше для поиска этих файлов использовалась переменная TEXMFCNF, но теперь мы не рекомендуем пользоваться этой (или какой-либо другой) переменной окружения.
Теперь при нормальной установке создается файл .../2014/texmf.cnf. Если вам нужно изменить настройки (обычно этого делать, не приходится), внесите их в этот файл. Главный конфигурационный файл — файл .../2014/texmf/web2c/texmf.cnf Его редактировать не следует, так как при обновлении системы ваши изменения пропадут.
Все найденные файлы texmf.cnf будут прочитаны, и определения в более ранних файлах имеют преимущество перед определениями в более поздних. Таким образом, если путь поиска задан как .:$TEXMF, значения в ./texmf.cnf имеют преимущество перед значениями в $TEXMF/texmf.cnf.
Фрагмент конфигурационного файла, иллюстрирующий эти правила, приведeн ниже:
Kpathsea распознаёт определённые специальные символы и конструкции в путях поиска, аналогичные конструкциям в стандартных оболочках UNIX. Например, сложный путь ~$USER/{foo,bar}//baz, означает все поддиректории директорий foo и bar в домашней директории пользователя $USER, которые содержат файл или поддиректорию baz. Это объяснено в следующих разделах.
Если путь поиска с наибольшим приоритетом (см. раздел «Источники путей поиска» на стр. 61) содержит дополнительное двоеточие (в начале, в конце, двойное), Kpathsea заменяет его следующим по приоритету путём. Если этот вставленный путь содержит дополнительное двоеточие, то же происходит со следующим путём. Например, если переменная окружения задана как
Поскольку было бы бесполезно вставлять значение по умолчанию более чем один раз, Kpathsea изменяет только одно лишнее двоеточие, и оставляет остальные: она проверяет сначала двоеточие в начале, потом в конце, потом двойные двоеточия.
Полезна также подстановка скобок, из-за которой, например, v{a,b}w означает vaw:vbw. Вложенность тут допускается. Благодаря этому можно иметь несколько иерархий директорий, присвоив $TEXMF несколько вариантов путей. Например, в файле texmf.cnf, можно найти следующее определение (это упрощение, на самом деле там ещё больше деревьев):
Мы можем теперь использовать это, чтобы задать директории поиска:
что означает, что кроме текущей директории будет происходить поиск только в $TEXMFVAR/tex, $TEXMFHOME/tex, $TEXMFLOCAL/tex, и $TEXMFDIST/tex (последние два дерева используют файлы ls-R). Это удобно для поддержки двух параллельных структур, «замороженной» (например, на CD) и обновляемой по мере появления новых версий. Используя переменную $TEXMF во всех определениях, можно задать поиск в обновляемом дереве первым.
Два или более слэша «/» в элементе пути вслед за именем директории d заменяются всеми поддиректориями d рекурсивно. На каждом уровне порядок поиска по директориям не определён.
Если вы определите компоненты имени файла после «//», только поддиректории с соответствующими компонентами будут включены. Например, «/a//b» даёт поддиректории /a/1/b, /a/2/b, /a/1/1/b, и т.д., но не /a/b/c или /a/1.
Возможны несколько конструкций «//» в одном пути, но «//» в начале пути игнорируются.
В следующем списке приводятся специальные символы в конфигурационных файлах Kpathsea.
Разделитель в спецификациях путей; в начале или конце спецификации означает подстановку по умолчанию.
Разделитель путей в системах, отличных от UNIX (то же, что :).
Подстановка переменных.
Означает домашнюю директорию пользователя.
Подстановка скобок.
Подстановка поддиректорий (может встретиться где угодно, кроме начала пути).
Начало комментария.
Символ продолжения (для команд из нескольких строк).
Поиск только в базе данных, но не на диске.
Kpathsea старается минимизировать обращение к диску при поиске. Тем не менее в системах с большим количеством директорий поиск в каждой возможной директории может занять долгое время (это особенно верно, если надо проверить сотни директорий со шрифтами). Поэтому Kpathsea умеет использовать внешний текстовый файл, «базу данных» ls-R, который знает, где находятся файлы в директориях, что даёт возможность избежать частых обращений к диску.
Ещё одна база данных, файл aliases позволяет вам давать дополнительные названия файлам в ls-R. Это полезно, если вам нужно соблюдать правило DOS «8.3».
Как объяснено выше, основная база данных называется ls-R. Вы можете создать её в корне каждого дерева TEXа, которое просматривается Kpathsea (по умолчанию, $TEXMF). Kpathsea ищет файлы ls-R в пути TEXMFDBS.
Рекомендуемый способ создания и поддержки «ls-R» — скрипт mktexlsr, включённый в дистрибутив. Он вызывается разными скриптами «mktex»…. В принципе этот скрипт выполняет команды типа
Если файл не найден в базе данных, по умолчанию Kpathsea ищет его на диске. Если элемент пути начинается с «!!», то поиск происходит только в базе данных.
Программа kpsewhich выполняет поиск в соответствии с алгоритмом, описанным выше. Это может быть полезно в качестве варианта команды find для поиска файлов в иерархиях TEXа (это широко используется в скриптах «mktex»…).
Kpathsea рассматривает каждый аргумент, не являющийся опцией, как имя файла, и возвращает первый найденный файл. Нет опции вернуть все найденные файлы (для этого можно использовать программу «find»).
Наиболее важные опции описаны ниже.
Установить разрешение num; это влияет только на поиск файлов «gf» и «pk». Синоним «-D»,
для совместимости с dvips. По умолчанию 600.
Установить формат для поиска name. По умолчанию, формат определяется из имени файла.
Для форматов, для которых нет однозначного суффикса, например, файлов MetaPost
и конфигурационных файлов dvips, вы должны указать название, известное Kpathsea,
например, tex или enc files. Список вариантов можно получить командой kpsewhich
--help.
Установить значение режима печати string; это влияет только на поиск файлов «gf» и «pk».
Значения по умолчанию нет: ищутся файлы для всех режимов.
Сделать всё возможное, чтобы найти файл включая поиск на диске. По умолчанию для
повышения эффективности просматривается только база данных ls-R.
Искать в наборе директорий string (как обычно, разделённых двоеточиями), вместо того,
чтобы вычислять путь поиска по имени файла. «//» и обычные подстановки работают.
Опции «--path» и «--format» несовместимы.
Установить имя программы равным name. Это влияет на путь поиска из-за префикса
.progname. По умолчанию kpsewhich.
Показать путь, используемый при поисках файлов типа name. Можно использовать
расширение (.pk, .vf и т.д.) или тип файла, как для опции «--format».
Установить уровень отладки num.
Давайте посмотрим на Kpathsea в действии. Вот простой поиск:
Кстати, последнее — библиографическая база данных статей журнала TUGBoat.
Теперь обратимся к заголовкам и конфигурационным файлам dvips. Вначале рассмотрим один из наиболее часто используемых файлов, пролог tex.pro для поддержки TEXа, а затем рассмотрим общий конфигурационный файл config.ps и карту шрифтов psfonts.map (с 2004 года карты и файлы кодировок имеют собственные пути поиска в деревьях texmf). Так как суффикс «.ps» неоднозначен, мы должные явно указать тип файла, который мы ищем: (dvips config) для файла config.ps.
Рассмотрим теперь файлы поддержки URW Times (PostScript). Префикс для этих файлов в стандартной схеме обозначения шрифтов «utm». Вначале мы рассмотрим конфигурационный файл, который содержит название карты шрифтов:
Из этих примеров видно, что вы можете легко найти заданный файл. Это особенно важно, если вы подозреваете, что программы находят неправильную версию файла, поскольку kpsewhich показывает первый найденный файл.
Иногда необходимо проверить, как программа ищет файлы. С этой целью Kpathsea предлагает разные уровни отладки:
статистика обращений к диску. При работе с базами ls-R это почти не должно давать записей в лог.
Ссылки на хеши (например, базы данных ls-R, конфигурационные файлы и т.д.).
Операции открытия и закрытия файлов.
Общая информация о типах файлов, которые ищет Kpathsea. Это полезно для того, чтобы найти, где определяется тип пути поиска для данного файла.
Список директорий для каждого элемента пути (при поисках на диске).
Поиски файлов.
Значения переменных.
Значение -1 задаст все опции выше; именно это значение чаще всего используется на практике.
Аналогично, запустив программу dvips и используя сочетание этих опций, можно проследить подробно, как ищутся файлы. С другой стороны, если файл не найден, трассировка показывает, где его искали, так что можно понять, в чём состоит проблема.
Вообще говоря, поскольку большинство программ пользуются библиотекой Kpathsea, вы можете установить опцию отладки используя переменную окружения KPATHSEA_DEBUG, и установив её на комбинацию описанных выше значений.
(Примечание для пользователей Windows: в этой системе трудно перенаправить все сообщения в файл. Для диагностики вы можете временно установить SET KPATHSEA_DEBUG_OUTPUT=err.log).
Рассмотрим в качестве примера простой файл в формате LATEX, hello-world.tex, со следующим содержанием:
Этот маленький файл использует только шрифт cmr10, так что давайте посмотрим, как dvips создаёт файл в формате PostScript (мы хотим использовать версию шрифтов в формате Type 1, отсюда опция -Pcms).
Программа dvips вначале ищет свои конфигурационные файлы. Сначала находится texmf.cnf, который содержит определения для путей поиска остальных файлов, затем база данных ls-R (для оптимизации поиска файлов) и файл aliases, который позволяет объявить несколько имён (например, короткие 8.3 и более длинные) для одного файла. Затем dvips ищет свой конфигурационный файл config.ps и файл .dvipsrc (который в данном случае не найден). Наконец, dvips находит конфигурационный файл для шрифтов Computer Modern PostScript config.cms (это было задано опцией -Pcms в командной строке). Этот файл содержит список карт, которые определяют соотношения между файлами в форматах TEX, PostScript и названиями шрифтов:
В этот момент dvips сообщает о себе пользователю:
Найдя этот файл, dvips печатает дату и время, и информирует нас, что собирается генерировать файл hello-world.ps, что ей нужен файл cmr10, и что последний является «резидентным» (битмапы не нужны):
Ещё одна полезная возможность Web2C — изменение параметров памяти (в особенности размеров массивов) при запуске, во время чтения файла texmf.cnf библиотекой Kpathsea. Параметры памяти находятся в части 3 этого файла в дистрибутиве TEX Live. Вот самые важные:
Общее количество слов в памяти для программ TEX, Metafont и MetaPost. После изменения этого параметра надо перегенерировать формат. Например, вы можете создать «огромную» версию TEXа, и назвать соответствующий формат hugetex.fmt. По общим правилам Kpathsea, значение переменной main_memory будет читаться из файла texmf.cnf.
Дополнительная память для «больших» структур, которые создаёт TEX: боксов, клея и т.д. Особенно полезно при использовании PI CTEXа.
Количество слов информации о шрифтах для TEXа. Это примерно суммарный размер всех файлов TFM, которые читает TEX.
Дополнительный размер хеша для имён команд. Примерно 10 000 команд может быть помещено в основной хеш. Если вы делаете большую книгу со многими перекрёстными ссылками, этого может не хватить. По умолчанию hash_extra равен 50000.
Разумеется, это не замена настоящих динамических массивов и распределения памяти, но поскольку эти черты исключительно сложно осуществить в текущем TEXе, использование этих параметров представляет собой полезный компромисс и обеспечивает некоторую гибкость.
TEX Live — результат объединённых усилий практически всех групп пользователей TEXа. Это издание TEX Live выходит под редакцией Карла Берри. Другие основные авторы, прошлые и настоящие, перечислены ниже. Мы благодарим:
Программы компилировали: Этторе Алдрованди (i386-solaris, x86_64-solaris), Марк Бадон (amd64-netbsd, i386-netbsd), Карл Берри (i386-linux), Алан Браслау (amd64-kfreebsd, i386-kfreebsd), Питер Брейтенлохнер (x86_64-linux), Кен Браун (i386-cygwin, x86_64-cygwin), Саймон Дейлес (armhf-linux), Акира Какуто (win32), Дик Коч (universal-darwin, x86_64-darwin), Никола Лечич (amd64-freebsd, i386-freebsd), Мойка Миклавек (mipsel-linux, sparc-solaris), Норберт Прейнинг (alpha-linux), Юкка Салми (i386-netbsd), Томас Шмитц (powerpc-linux), Борис Вейцман (armel-linux), Информация о процессе компилирования TEX Live находится на http://tug.org/texlive/build.html.
Перевод документации: Борис Вейцман (русский), Цзигод Цзян, Цзиньсун Чжао, Юэ Ван и Хэлинь Гай (китайский), Уве Цигенхаген (немецкий), Мануэль Пьегорье-Гоннар (французский), Марко Паллант (итальянский), Никола Лечич (сербский), Петр Сойка и Ян Буса (чешский и словацкий), Сташек Ваврикевич (польский). Страница документации TEX Live: http://tug.org/texlive/doc.html.
Разумеется, наша главная благодарность — Дональду Кнуту, во-первых, за разработку TEXа, и во-вторых, за то, что он подарил его миру.
В конце 1993 года в голландской группе пользователей TEXа во время работы над дистрибутивом 4AllTEX CD для пользователей MS-DOS возникла новая идея. Была поставлена цель создать единый CD для всех систем. Эта цель была черечур сложна для того времени, однако она привела не только к появлению очень успешного CD 4AllTEX, но и к созданию рабочей группы Технического Совета TUG по структуре директорий для TEXа (http://tug.org/tds), которая разработала стандарт структуры директорий для системы TEX и указала, как создать логичную единую систему файлов для TEXа. Несколько версий TDS было опубликовано в декабрьском выпуске TUGboat в 1995 году, и с самого начала стало ясно, что следует создать пример структуры на CD. Дистрибутив, который вы держите в руках, — прямой результат работы этой группы. Из успеха 4AllTEX был сделан вывод, что пользователям UNIX также подойдёт такая удобная система, и так родилась другая важная часть TEX Live.
Мы начали делать CD с UNIX и структурой директорий TDS осенью 1995 года, и быстро поняли, что у teTEXа Томаса Эссера идеальный состав дистрибутива и поддержка многих платформ. Томас согласился нам помочь, и мы в начале 1996 года стали серьёзно работать над дистрибутивом. Первое издание вышло в мае 1996 года. В начале 1997 года Карл Берри завершил новую версию Web2C, которая включила практически все новые возможности, добавленные Томасом Эссером в teTEX, и мы решили основать второе издание на стандартном Web2C, с добавлением скрипта texconfig из teTEXа. Третье издание CD основывалось на новой версии Web2C 7.2, Олафа Вебера; в то же время была выпущена новая версия teTEXа, и TEX Live включил почти все его новые возможности. Четвертое издание следовало той же традиции, используя новую версию teTEXа и Web2C (7.3). Теперь в нём была полная система для Windows.
Для пятого издания (март 2000 года) многие пакеты на CD были пересмотрены и проверены. Информация о пакетах была собрана в файлы XML. Но главным изменением в TEX Live 5 было удаление всех несвободных программ. Всё на TEX Live преполагается совместимым с Правилами Дебиана для Свободных Программ (http://www.debian.org/intro/free); мы сделали всё, что могли, чтобы проверить лицензии всех пакетов, и мы будем благодарны за любое указание на ошибки.
В шестом издании (июль 2001 года) было много нового материала. Главным была новая концепция установки: пользователь выбирал нужный набор коллекций. Языковые коллекции были полностью реорганизованы, так что выбор любой из них устанавливал не только макросы, шрифты и и т.д., но и вносил изменения в language.dat.
Седьмое издание 2002 года добавило поддержку Mac OS X, и большое количество обновлений для пакетов и программ. Важной целью была интеграция с teTEXом, чтобы исправить расхождение, наметившееся в версиях 5 и 6.
В 2003 году мы продолжили изменения и дополнения, и обнаружили, что TEX Live так вырос, что не помещается на CD. Поэтому мы разделили его на три дистрибутива (см. раздел 2.1, стр. 7). Кроме того:
В 2004 году мы внесли много изменений.
Файлы .map теперь ищутся только в поддиректориях fonts/map (в каждом дереве texmf) в пути TEXFONTMAPS. Аналогично файлы .enc теперь ищутся в только в поддиректориях fonts/enc в пути ENCFONTS. Программа updmap предупреждает, если находит эти файлы не там, где они должны быть.
См. описание этой структуры на http://tug.org/texlive/mapenc.html.
Это также означает, что теперь очень важно использовать пакет ifpdf (работает и с plain, и с LATEX) или эквивалентные средства, поскольку просто проверка, определён ли \pdfoutput или другой примитив не достаточна для того, чтобы понять, в каком формате генерируется результат. Мы сделали всё возможное для совместимости в этом году, но в будущем году \pdfoutput может быть определён даже если генерируется DVI.
См. подробности в руководстве к программе Web2C: texmf/doc/web2c.
В 2005 году было, как всегда, сделано много изменений в пакетах и программах. Инфраструктура почти не изменилась по сравненению с 2004 годом, но некоторые неизбежные изменения были сделаны.
В 2006–2007 главным нововведением была программа XeTEX, вызываемая как xetex или xelatex; см. http://scripts.sil.org/xetex.
Значительно обновлена программа MetaPost; предполагаются дополнительные обновления в будущем (http://tug.org/metapost/articles). Также обновлён pdfTEX (http://tug.org/applications/pdftex).
Форматы .fmt и т.д. теперь хранятся в поддиректориях texmf/web2c, а не в самой директории (хотя директория всё ещё включена в поиск форматов, на случай, если там находятся старые файлы). Поддиректории названы по имени программы, например, tex, pdftex, xetex. Это изменение не должно влиять на работу программ.
Программа (plain) tex больше не определяет по %& в первой строке, какой формат использовать: это всегда Кнутовский TEX (LATEX и другие ещё используют %&).
Разумеется, в этом году были, как обычно, сотни обновлений пакетов и программ. Как обычно, обновлённые версии можно найти в сети CTAN (http://www.ctan.org).
Дерево TEX Live теперь хранится в системе Subversion, и у нас появился WWW-интерфейс для его просмотра. Мы предполагаем, что эта система будет использована для разработки в будущем.
Наконец, в мае 2006 года Томас Эссер объявил о прекращении работы над teTEXом (http://tug.org/tetex). Это вызвало всплеск интереса к TEX Live, особенно среди разработчиков систем GNU/Linux (мы добавили схему tetex, которая устанавливает систему, примерно соответствующую teTEXу). Мы надеемся, что это приведёт в конечном итоге к улучшению работы в TEXе для всех.
В 2008 была заново разработана и переписана вся структура TEX Live. Полная информация об установке системы теперь хранится в текстовом файле tlpkg/texlive.tlpdb.
Помимо прочего, это наконец позволило обновление TEX Live по сети — возможность, которая много лет была у программы MiKTEX. Мы предполагаем регулярно обновлять пакеты, поступающие на CTAN.
Включен новый важный «движок» LuaTEX (http://luatex.org); помимо нового уровня вёрстки, это дает прекрасный скриптовый язык для использования как изнутри документов TEXа, так и отдельно.
Поддержка многих платформ на основе UNIX и Windows теперь гораздо более последовательна. В частности, большинство скриптов на языках Perl и Lua теперь доступны под Windows благодаря версии Perlа, распространяемой с TEX Live.
Новый скрипт tlmgr (см. раздел 6) теперь является основным интерфейсом для администрирования TEX Live после установки. Он осуществляет обновление пакетов и перегенерирование форматов, карт шрифтов и языков, включая локальные добавления.
В связи с появлением программы tlmgr, возможности программы texconfig по редактированию конфигурационных файлов форматов и таблиц переноса отключены.
Программа xindy (http://xindy.sourceforge.net/) для создания указателей теперь работает на большинстве платформ.
Программа kpsewhich теперь может сообщить обо всех нужных файлах (опция -all) и ограничить поиск определенной поддиректорией (опция -subdir).
Программа dvipdfmx теперь может извлекать информацию о высоте и ширине текста, если вызвана как extractbb; это одна из последних возможностей программы dvipdfm, которой не было у dvipdfmx.
Алиасы Times-Roman, Helvetica и т.д. убраны. Разные пакеты ожидают от них разного поведения (особенно при разных кодировках), и мы не нашли способа решить эту проблему единообразно.
Формат platex убран из-за конфликта с японским пакетом platex; теперь основная поддержка польского языка осуществляется через пакет polski.
Пулы строковых констант WEB теперь компилируются в сами программы для удобства обновлений.
Наконец, добавлены изменения, сделанные Дональдом Кнутом в его «Настройке TEXа 2008 года», см. http://tug.org/TUGboat/Articles/tb29-_2/tb92knut.pdf.
Начиная с 2009 года по умолчанию Lua(LA )TEX теперь создает файлы в формате PDF, чтобы полнее использовать поддержку шрифтов в формате OpenType. Чтобы получить результат в формате DVI, используйте программы dviluatex и dvilualatex. Страница LuaTEX находится на http://luatex.org.
Программа Omega и формат Lambda были после консультаций с авторами исключены из дистрибутива. В дистрибутиве остались Aleph и Lamed, а также утилиты из набора Omega.
Включена новая версия шрифтов AMS в формате Type 1. Она включает Computer Modern: были учтены изменения, которые Кнут внес в исходные параметры для программы Metafont, а также обновлены хинты. Шрифты Euler были полностью перерисованы Германом Цапфом (см. http://tug.org/TUGboat/Articles/tb29-_2/tb92hagen-_euler.pdf). Во всех случаях метрики шрифтов не изменились. Страница шрифтов AMS находится на http://www.ams.org/tex/amsfonts.html.
Новая графическая оболочка TEXworks включена в дистрибутив для Windows и MacTEX. Информация о версиях для других платформ и дополнительная документация находится на http://tug.org/texworks. Это мультиплатформенная оболочка, вдохновленная программой TeXShop для Mac OS X и ориентированная на упрощение работы с TEXом.
Графическая программа Asymptote включена в дистрибутив для нескольких платформ. Она основана на языке представления графики, напоминающем MetaPost, но с поддержкой трехмерных объектов и другими возможностями. Её страница находится на http://asymptote.sourceforge.net.
Программа dvipdfm была заменена программой dvipdfmx; если вызвать последнюю как dvipdfm, она работает в специальном режиме эмуляции dvipdfm. Программа dvipdfmx включает поддержку китайского, японского и корейского языков (CJK) и много других изменений по сравнению с dvipdfm. Её страница находится на http://project.ktug.or.kr/dvipdfmx.
В дистрибутив включены программы для cygwin и i386-netbsd, в то время как другие варианты BSD были исключены: нам сказали, что пользователи OpenBSD и FreeBSD устанавливают TEX, пользуясь пакетными менеджерами. Кроме того, оказалось сложным создать программы, которые бы работали под разными версиями этих систем.
Ещё несколько изменений: мы теперь используем архиватор xz, стабильную замену для lzma (http://tukaani.org/xz/); знак доллара $ теперь допустим в именах файлов, если результат не может быть истолкован как известная перемена окружения; библиотека Kpathsea теперь параллелизована (это нужно для новой версии программы MetaPost); процесс компиляции теперь полностью основан на Automake.
Последнее замечание о прошлом: все выпуски TEX Live вместе с дополнительными материалами вроде обложек CD хранятся на ftp://tug.org/historic/systems/texlive. ftp://tug.org/historic/systems/texlive.
Начиная с 2010 года файлы в формате PDF по умолчанияю создаются в версии PDF 1.5. Это верно для всех вариантов TEXа, которые способны создавать файлы PDF, а также для dvipdfmx. Чтобы получать файлы в формате PDF 1.4, используйте LATEXовский пакет pdf14 или команду \pdfminorversion=4.
pdf(LA )TEX теперь автоматически конвертирует файлы в формате Encapsulated PostScript (EPS) в PDF при помощи пакета epstopdf, если используется конфигурационный файл graphics.cfg в LATEXе, и требуется вывод в формате PDF. Вы можете отказаться от загрузки пакета epstopdf, поместив перед объявлением \documentclass команду \newcommand{\DoNotLoadEpstopdf}{} (или \def...). Он также не загружается, если используется пакет pst-pdf. См. также документацию к пакету epstopdf (http://ctan.org/pkg/epstopdf-_pkg).
С этим связано ещё одно изменение: теперь по умолчанию разрешено вызывать из TEXа несколько внешних команд (при помощи механизма \write18). Это repstopdf, makeindex, kpsewhich, bibtex и bibtex8. Список определен в texmf.cnf. В случае, если необходимо запретить все текие команды, можно убрать соответствующую опцию при установке системы (см. раздел 3.2.4) или переконфигурировать систему после установки командой tlmgr conf texmf shell_escape 0.
Ещё одно изменение, связанное с этим: теперь BibTeX и Makeindex по умолчанию отказываются записывать в файлы, лежащие в произвольной директории системы (как и сам TEX). Поэтому их можно запускать через механизм \write18. Чтобы изменить это правило, можно установить переменную окружения TEXMFOUTPUT или изменить значение параметра openout_any.
XeTEX теперь поддерживает оптическое выравнивание полей, как это умеет делать pdfTEX. (Шрифты с вариантами пока не поддерживаются).
По умолчанию, tlmgr теперь сохраняет предыдущую версию каждого пакета после апгрейда (tlmgr option autobackup 1), поэтому ошибки можно «откатить назад» командой tlmgr restore. Если у вас нет места на диске для этих копий, запустите tlmgr option autobackup 0.
Новые программы: pTEX и пакет утилит для набора японских текстов, программа BibTeXU для варианта BibTeXа с поддержкой Юникода, утилита chktex (http://baruch.ev-_en.org/proj/chktex) для проверки документов, созданных (LA )TEXом, программа dvisvgm (http://dvisvgm.sourceforge.net) для перевода из формата DVI в формат SVG.
Включены программы для следующих новых платформ: amd64-freebsd, amd64-kfreebsd, i386-freebsd, i386-kfreebsd, x86_64-darwin, x86_64-solaris.
Об одном изменении в TEX Live 2009 мы забыли упомянуть в свое время: многочисленные программы конвертера TEX4ht (http://tug.org/tex4ht) были убраны из директорий для бинарников; все теперь делается одной программой mk4ht.
Наконец, релиз TEX Live на TEX Collection DVD уже нельзя использовать «live», непосредственно с диска (что может показаться странным). Кстати, из-за этого установка с DVD будет теперь значительно быстрее.
В 2011 году было сделано относительно немного изменений.
Программы для Mac OS X (universal-darwin и x86_64-darwin) работают теперь только под Leopard или младшей системой; Panther и Tiger больше не поддерживаются.
Программа biber для обработки библиографических списков добавлена для всех платформ. Она тесно связана с пакетом biblatex, который предлагает совершенно новый способ обработки библиографий из LATEXа.
Программа MetaPost (mpost) больше не создает файлов .mem. Нужные файлы, например plain.mp, теперь просто перечитываются при каждом запуске. Это связано с поддержкой MetaPost как библиотеки — ещё одно важное, но прозрачное для пользователя изменение.
Версия программы updmap, написанная на Перле, ранее использованная только под Windows, теперь улучшена и устанавливается для всех платформ. Это должно быть прозрачно для пользователя — разве что программа теперь работает гораздо быстрее.
Программы initex и inimf были возвращены (но другие варианты ini* — нет).
Программа tlmgr теперь поддерживает обновления из нескольких сетевых репозиториев. Эти возможности подробнее описаны в соответствующем разделе tlmgr help.
Параметр \XeTeXdashbreakstate теперь по умолчанию равен 1, как для xetex, так и для xelatex. Это разрешает переход на новую строку после тире, что всегда было разрешено в plain TeX, LATEX, LuaTEX и т.д. Старые документы в XeTEXе, для которых нужно в точности сохранить старое форматирование, теперь должны будут явно установить \XeTeXdashbreakstate равным 0.
Файлы, создаваемые программами pdftex и dvips, теперь могут быть больше 2 гигабайт.
35 стандартных шрифтов PostScriptа теперь по умолчанию включены в файлы, создаваемые dvips, так как сейчас существует много разных версий этих «стандартных» шрифтов.
К программам, которые могут по умолчанию вызываться в ограниченном режиме через \write18, добавлена mpost.
Файл texmf.cnf теперь ищется ещё и в директории ../texmf-local, т. е. если файл /usr/local/texlive/texmf-local/web2c/texmf.cnf существует, он будет использован.
Скрипт updmap теперь читает файлы updmap.cfg в каждом поддереве директорий, вместо одного глобального конфигурационного файла. Это изменение должно быть прозрачным для пользователя, если бы не редактировали вручную файлы updmap.cfg. Подробнее объяснено в документации, выдаваемой командой updmap --help.
Платформы: добавлены armel-linux и mipsel-linux; из основного дистрибутива исключены платформы sparc-linux и i386-netbsd.
Изменена структура директорий: директория texmf/ объединена с texmf-dist/. Переменные TEXMFMAIN и TEXMFDIST указывают теперь на texmf-dist/,
Многие небольие языковые коллекции объединены для упрощения установки.
MetaPost: добавлена поддержка записи в PNG и чисел с плавающей точой (IEEE double).
LuaTEX: обновлено до Lua 5.2 и включена новая библиотека (pdfscanner) для включения страниц в формате PDF и многого другого (см. страницы LuaTEX на WWW).
XeTEX (также см. страницы на WWW):
xdvi: теперь использует FreeType вместо t1lib.
microtype.sty: добавлена поддержка XeTEX (вынесение знаков препинания на поля) и LuaTEX (вынесение знаков препинания на поля, манипуляции со шрифтами, разрядка), помимо други улучшений.
tlmgr: новый механизм pinning для работы с несколькими репозиториями; см. tlmgr --help и http://tug.org/texlive/doc/tlmgr.html#MULTIPLE-_REPOSITORIES.
Платформы: добавлены или восстановлены armhf-linux, mips-irix, i386-netbsd и amd64-netbsd. Убрана powerpc-aix.
2014 год ознаменовался новыми поправками от Кнута; это касается всех програм, но наиболее видимое изменение — восстановлены слова preloaded format в баннере. Как пишет Кнут, это теперь означает, что формат может быть загружен по умолчанию, а не то, что он на самом деле загружен; этот формат может быть изменен.
pdfTEX: новый параметр для подавления предупреждений \pdfsuppresswarningpagegroup; новые примитивы для специальных пробелов, чтобы помочь переверстке PDF \pdfinterwordspaceon, \pdfinterwordspaceoff, \pdffakespace.
LuaTEX: значительные изменения в механизме загрузки шрифтов и переноса. Самое большое изменение — добавление нового движка luajittex (http://foundry.supelec.fr/projects/luajittex) и его собратьев texluajit и texluajitc. Они используют just-in-time компилятор (см. подробную статью http://tug.org/TUGboat/tb34-_1/tb106scarso.pdf). luajittex все еще в состоянии разработки, он поставляется не для всех систем и существенно менее стабилен, чем luatex. Ни мы, ни разработчки не рекомендуем использование его для чего бы то ни было, кроме экспериментов.
XeTEX: сейчас на всех платформах поддерживаются одни и те же форматы графики (включая Mac), исключена декомпозиция составных символов Юникода, шрифты OpenType теперь предпочитаются Graphite для совместимости с предыдущими версиями XeTEXа.
MetaPost: поддерживается новая система нумерации decimal, наряду с внутренней numberprecision; новое определение drawdot в plain.mp, от Кнута; исправлены баги в экспорте SVG и PNG и др.
Утилита pstopdf (ConTEXt) будет убрана в качестве самостоятельной команды после релиза из-за конфликта с системной командой под тем же названием. Ее все еще можно будет использовать как mtxrun –script pstopdf.
Утилиты psutils были существенно обновлены новым разработчиком. В результате несколько редко используемых утилит (fix*, getafm, psmerge, showchar) сейчас находятся в директории scripts/, а не не в общей директории с другими программами (возможно, это будет изменено в будущем). Добавлен новый скрипт psjoin.
Наш вариант MacTEX (раздел 3.1.2) больше не включает специфических для макинтошей пакетов шрифтов Latin Modern и TeX Gyre, так как пользователь может легко включить эти шрифты в систему. Мы также убрали программу convert из пакета ImageMagick, так как TEX4ht (точнее, tex4ht.env) теперь использует Ghostscript напрямую.
Коллекция langcjk для китайского, японского и корейского языков разбита на отдельные коллекции меньшего размера.
Платформа x86_64-cygwin добавлена, mips-irix убрана; Микрософт больше не поддерживает Windows XP, так что наши программы под ними могут в любой момент перестать работать.
Поддержку некоторых дополнительных платформ можно найти на (http://tug.org/texlive/custom-_bin.html). Кроме того, программы для некоторых платформ не попали на DVD (просто чтобы сэкономить место), но могут быть установлены обычным способом по сети
TEX Live не совершенен! (И никогда не будет.) Мы предполагаем выпускать новые версии, добавляя справочный материал, утилиты, установочные программы и (конечно) новое, улучшенное и проверенное дерево макросов и шрифтов. Эта работа делается очень занятыми добровольцами в свободное время, и многое остается сделать. Если вы можете помочь, не стесняйтесь. См. http://tug.org/texlive/contribute.html.
Присылайте, пожалуйста, замечания и предложения по адресу:
Happy TEXing!
