tlmgr - Интернет в облаке

ПРОГРАММА:

ИМЯ

tlmgr - Менеджер TeX Live

СИНТАКСИС

тлмгр [вариант] ... действие [вариант] ... [операнд] ...

ОПИСАНИЕ

тлмгр управляет существующей установкой TeX Live, как пакетами, так и параметрами конфигурации.
Для получения информации о первоначальной загрузке и установке TeX Live см.
<http://tug.org/texlive/acquire.html>.

Самая последняя версия этой документации (обновляется каждую ночь с момента разработки
источники) доступно по адресуhttp://tug.org/texlive/tlmgr.html>, а также процедуры для
обновление самого "tlmgr" и информации о тестовых версиях.

ВНИМАНИЕ: tlmgr в Debian всегда работает в пользовательском режиме

TeX Live состоит из нескольких частей верхнего уровня. схемы, каждый из которых указан как
другой набор Коллекции и пакеты, где коллекция - это набор пакетов, а
пакет - это то, что содержит фактические файлы. Схемы обычно содержат сочетание коллекций и
пакеты, но каждый пакет входит ровно в одну коллекцию, не больше и не меньше. А
Установку TeX Live можно настроить и управлять ею на любом уровне.

Видетьhttp://tug.org/texlive/doc> для всей доступной документации TeX Live.

ПРИМЕРЫ

После успешной установки TeX Live, вот несколько общих операций с tlmgr:

репозиторий tlmgr option http://mirror.ctan.org/systems/texlive/tlnet"
Скажите "tlmgr" использовать ближайшее зеркало CTAN для будущих обновлений; полезно, если вы установили
TeX Live из образа DVD и хотите, чтобы обновления продолжались.

"tlmgr update --list"
Сообщите, что будет обновлено, но фактически ничего не обновляя.

"обновление tlmgr - все"
Сделайте так, чтобы ваша локальная установка TeX соответствовала тому, что находится в репозитории пакетов
(обычно полезно при обновлении из CTAN).

"информация о tlmgr" почему
Показать подробную информацию о пакете почему, например статус установки и
описание поисков почему во всех пакетах.

Чтобы узнать обо всех возможностях и деталях "tlmgr", пожалуйста, прочтите следующий объемный
Информация.

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

Следующие параметры для «tlmgr» являются глобальными параметрами, не относящимися к какому-либо действию. Все
параметры, глобальные или специфичные для действий, могут быть заданы в любом месте командной строки, и
в любом порядке. Первый аргумент, не являющийся опцией, будет основным действием. В любом случае,
"-"вариант и "-"вариант эквивалентны, а знак "=" между именем параметра и
его ценность.

--репозиторий url | путь
Определяет репозиторий пакетов, из которого пакеты должны быть установлены или обновлены,
переопределение репозитория пакетов по умолчанию, найденного в установочном пакете TeX Live
База данных (также известная как TLPDB, полностью определенная в файле "tlpkg / texlive.tlpdb"). В
документация для "install-tl" содержит более подробную информацию об этом
(<http://tug.org/texlive/doc/install-tl.html>).

«--repository» изменяет расположение репозитория только для текущего запуска; сделать
постоянное изменение, используйте «репозиторий опций» (см. действие «опций»).

Для обратной совместимости и удобства "--location" и "--repo" принимаются как
псевдонимы для этой опции.

--gui [действие]
"tlmgr" имеет графический интерфейс, а также интерфейс командной строки. Вы можете дать
этот параметр "--gui" вместе с действием, которое должно быть перенесено непосредственно в
соответствующий экран графического интерфейса. Например, бег

обновление tlmgr --gui

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

--gui-lang llcode
По умолчанию графический интерфейс пытается определить ваш язык из среды (в Windows через
реестр в Unix через "LC_MESSAGES"). Если это не поможет, вы можете выбрать другой
язык, указав эту опцию с кодом языка (на основе ISO 639-1). В настоящее время
поддерживаются (но не обязательно полностью переведены): английский (en, по умолчанию),
Чешский (cs), немецкий (de), французский (fr), итальянский (it), японский (ja), голландский (nl), польский
(pl), бразильский португальский (pt_BR), русский (ru), словацкий (sk), словенский (sl), сербский
(sr), украинский (uk), вьетнамский (vi), упрощенный китайский (zh_CN) и традиционный
Китайский (zh_TW).

--debug-перевод
В режиме графического интерфейса этот переключатель указывает tlmgr сообщать о любых непереведенных (или отсутствующих)
сообщения к стандартной ошибке. Это может помочь переводчикам увидеть, что еще предстоит сделать.

- машиночитаемый
Вместо обычного вывода, предназначенного для потребления человеком, напишите (в стандартный
output) фиксированный формат, более подходящий для машинного анализа. См. "МАШИНОЧИТАЕМЫЙ"
ВЫХОД »ниже.

--no-execute-actions
Подавить выполнение действий выполнения, как определено в файлах tlpsrc.
Документировано только для полноты, так как это полезно только при отладке.

--package-logfile файл
"tlmgr" регистрирует все действия пакета (установка, удаление, обновление, неудачные обновления, неудачные
восстанавливает) в отдельный файл журнала, по умолчанию "TEXMFSYSVAR / web2c / tlmgr.log". Этот
опция позволяет вам указать другой файл для журнала.

--Пауза
Эта опция заставляет tlmgr ждать ввода данных пользователем перед выходом. Полезно в Windows для
избегайте исчезновения командных окон.

--постоянные загрузки
--no-persistent-downloads
Для сетевых установок эта опция (по умолчанию включена) заставляет "tlmgr" пытаться установить
установить постоянное соединение (с помощью модуля Perl "LWP"). Идея в том, чтобы открыть и
повторно использовать только одно соединение за сеанс между вашим компьютером и сервером вместо
инициирование новой загрузки для каждого пакета.

Если это невозможно, tlmgr вернется к использованию wget. Чтобы отключить эти
постоянные соединения, используйте "--no-persistent-downloads".

--pin-файл
Измените расположение закрепляемого файла с «TEXMFLOCAL / tlpkg / pinning.txt» (см. «Закрепление»
ниже). Документировано только для полноты, так как это полезно только при отладке.

--usermode
Активирует пользовательский режим для этого запуска «tlmgr»; см. «РЕЖИМ ПОЛЬЗОВАТЕЛЯ» ниже.

--usertree директория
Пользы директория для дерева в пользовательском режиме; см. «РЕЖИМ ПОЛЬЗОВАТЕЛЯ» ниже.

Также принимаются стандартные опции для программ TeX Live: «--help / -h / -?», «--Version»,
«-q» (нет информационных сообщений), «-v» (отладочные сообщения, могут повторяться). Для
подробности об этом см. в документации «TeXLive :: TLUtils».

Параметр «--version» показывает информацию о версии TeX Live и о версии
Сам скрипт "tlmgr". Если также указан "-v", номер версии загруженного TeX Live.
Также показаны модули Perl.

Действия

помощь
Отобразите эту справочную информацию и выйдите (так же, как "--help" и в Интернете по адресу
<http://tug.org/texlive/doc/tlmgr.html>). Иногда программы "perldoc" и / или "PAGER"
в системе возникают проблемы, в результате которых буквально выводятся управляющие символы. Этот
не всегда может быть обнаружен, но вы можете установить переменную среды "NOPERLDOC" и
"perldoc" не будет использоваться.

версия
Предоставляет информацию о версии (аналогично "--version").

Если задано "-v", также сообщаются версии используемых модулей.

резервная копия [--clean [=N]] [-каталог резервной копии директория] [--все | упак] ...
Если опция "--clean" не указана, это действие создает резервную копию данного
пакеты или все пакеты с указанием "--all". Эти резервные копии сохраняются со значением
Параметр «--backupdir», если это существующий каталог, доступный для записи. Если "--backupdir"
не указан, используется параметр «backupdir» в TLPDB, если он присутствует. Если оба
отсутствует, резервные копии не создаются.

Если указан параметр «--clean», резервные копии удаляются (удаляются), а не сохраняются. В
необязательное целочисленное значение N можно указать, чтобы установить количество резервных копий, которые будут
сохраняется при чистке. Если «N» не указано, используется значение опции «autobackup».
Если оба отсутствуют, выдается ошибка. Дополнительные сведения об удалении резервных копий см. В
«опция» действие.

Опции:

--backupdir каталог
Переопределяет настройку параметра «backupdir» в TLPDB. В каталог аргумент
требуется и должен указывать существующий, доступный для записи каталог, в котором должны храниться резервные копии
размещены.

--все
Если "--clean" не указан, сделайте резервную копию всех пакетов в TeX Live.
установка; это займет довольно много места и времени. Если "--clean"
указано, все пакеты будут обрезаны.

--чистый[=N]
Вместо того, чтобы делать резервные копии, удалите каталог резервных копий старых резервных копий, как объяснено
выше. Необязательный целочисленный аргумент N отменяет параметр «автобэкап», установленный в
TLPDB. Вы должны использовать "--all" или список пакетов вместе с этой опцией, как
желательно.

--прогон, репетиция
На самом деле ничего не копируется и не удаляется; вместо этого действия, которые необходимо выполнить,
написано в терминал.

кандидатов упак
кандидатов упак
Показывает доступные репозитории кандидатов для пакета упак. См. "НЕСКОЛЬКО
ХРАНИЛИЩЕ »ниже.

проверка [вариант] ... [файлы | зависит | выполняет | файлы запуска | все]
Выполняет одну (или все) проверки согласованности установки.

файлов
Проверяет, что все файлы, перечисленные в локальной TLPDB ("texlive.tlpdb"), действительно
присутствует и перечисляет пропавших без вести.

зависит
Перечисляет те пакеты, которые встречаются как зависимости в установленных коллекциях, но являются
сами не устанавливаются, а те пакеты, которые не содержатся ни в одной коллекции.

Если вы вызовете "tlmgr check collections", этот тест будет выполняться вместо этого, поскольку
прежние версии для "tlmgr" называли это именно так.

исполняет
Убедитесь, что файлы, на которые ссылаются директивы "execute" в базе данных TeX Live, являются
настоящее время.

файлы запуска
Перечислите те имена файлов, которые встречаются в файлах выполнения более одного раза.

Опции:

--use-svn
Используйте вывод «svn status» вместо перечисления файлов; для проверки TL
репозиторий разработки.

конф [texmf | tlmgr | updmap [--conffile файл] [--удалять] [ключ [ценностное ]]]
Только с помощью "conf" показать общую информацию о конфигурации для TeX Live, включая активную
файлы конфигурации, параметры пути и многое другое. Это похоже на вызов "texconfig conf", но
работает на всех поддерживаемых платформах.

Если дополнительно указано "conf texmf", "conf tlmgr" или "conf updmap", отображаются все
пары ключ / значение (т.е. все настройки), сохраненные в "ROOT / texmf.cnf", конфигурация tlmgr
файл (см. ниже) или первый найденный (через kpsewhich) файл «updmap.cfg» соответственно.

If ключ дается дополнительно, показывает значение только того, что ключ в соответствующем файле. Если
вариант --удалять также дан, конфигурационный файл - он удален, а не просто прокомментирован
вне!

If ценностное дается дополнительно, ключ на ценностное в соответствующем файле. Нет ошибка
контроль is сделанный!

Во всех случаях используемый файл можно явно указать с помощью опции "--conffile файл",
на случай, если кто-то хочет работать с другим файлом.

Практическое применение: при выполнении (некоторых или всех) системных команд через "\ write18"
был оставлен включенным во время установки, вы можете отключить его позже:

tlmgr conf texmf Shell_escape 0

Более сложный пример: дерево "TEXMFHOME" (см. Основное руководство по TeX Live,
<http://tug.org/texlive/doc.html>) можно установить в несколько каталогов, но они должны быть
заключены в фигурные скобки и разделены запятыми, поэтому указание значения в оболочке является хорошим
идея. Таким образом:

tlmgr conf texmf TEXMFHOME "{~ / texmf,~ / texmfbis}"

Предупреждение: общие возможности здесь, но возиться с настройками таким образом очень сложно.
категорически не рекомендуется. Опять же, проверка ошибок ни для ключей, ни для значений не выполняется, поэтому любой
вроде возможна поломка.

дамп-tlpdb [--local | --remote]
Выгрузите полную локальную или удаленную TLPDB в стандартный вывод как есть. Вывод аналогичен
вывод "- машиночитаемый"; см. раздел «МАШИНОСЧИТЫВАЕМЫЙ ВЫХОД».

Опции:

--местный
Выгрузите локальный tlpdb.

--дистанционный пульт
Дамп удаленного tlpdb.

Должен быть указан ровно один из «--local» или «--remote».

В любом случае первая строка вывода указывает местоположение репозитория в этом
Формат:

"location-url" "\ t" местоположение

где "location-url" - это буквальное имя поля, за которым следует табуляция, и расположение это
файл или URL-адрес репозитория.

Окончание строк может быть LF или CRLF в зависимости от текущей платформы.

порождать [вариант] ... почему
порождать язык
порождать язык.дата
порождать язык.def
порождать язык.dat.lua

Действие "генерировать" перезаписывает любые ручные изменения, внесенные в соответствующие файлы:
воссоздает их с нуля на основе информации об установленных пакетах, а также локальных
адаптации. Установщик TeX Live и tlmgr обычно вызывают команду generate для всего этого.
файлы.

Для управления собственными шрифтами прочтите информацию «updmap --help» и / или
<http://tug.org/fonts/fontinstall.html>.

Для управления вашими собственными форматами, пожалуйста, прочтите информацию "fmtutil --help".

Более подробно: "generate" переделывает любой из конфигурационных файлов "language.dat",
"language.def" и "language.dat.lua" из информации, представленной в локальной TLPDB,
плюс файлы, обслуживаемые локально.

Локально обслуживаемые файлы: language-local.dat, language-local.def или
"language-local.dat.lua", поиск по которому выполняется в "TEXMFLOCAL" в соответствующих каталогах. Если
присутствуют локальные дополнения, финальный файл создается, начиная с основного файла,
исключение любых записей, которые локальный файл указывает на отключение, и, наконец, добавление
локальный файл.

(Историческая справка: ранее поддерживаемые «updmap-local.cfg» и «fmtutil-local.cnf» не
более длительное чтение, так как «updmap» и «fmtutil» теперь читают и поддерживают несколько конфигураций
файлы. Таким образом, локальные дополнения можно и нужно помещать в «updmap.cfg» из «fmtutil.cnf».
файл в "TEXMFLOCAL". Действия "сгенерировать карту обновления" и "сгенерировать fmtutil" больше не
существовать.)

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

%!НАЗВАНИЕ
--!НАЗВАНИЕ

где "language.dat" и "language.def" используют "%", а "language.dat.lua" используют "-". В целом
случаи, имя - соответствующее имя формата или идентификатор шаблона расстановки переносов.
Примеры:

%!Немецкий
-! usenglishmax

(Конечно, вы вряд ли захотите отключать именно эти элементы. Они
просто примеры.)

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

Форма "создать язык" воссоздает все три файла "language.dat", "language.def" и
"language.dat.lua", а формы с расширением воссоздают только этот язык
.

Опции:

- самый выходной файл
указывает выходной файл (по умолчанию соответствующее расположение в "TEXMFSYSVAR"). Если
"--dest" дается для "создания языка", он служит базовым именем, на котором ".dat"
будет добавлено к имени выходного файла "language.dat", ".def" будет
добавляется к значению имени выходного файла "language.def" и ".dat.lua"
к имени файла "language.dat.lua". (Это просто для того, чтобы избежать перезаписи; если
вам нужно конкретное имя для каждого выходного файла, мы рекомендуем дважды вызывать tlmgr.)

--localcfg local_conf_file
указывает (необязательно) локальные дополнения (по умолчанию в соответствующем месте в
«ТЕКСМФЛОКАЛЬНЫЙ»).

--rebuild-sys
указывает tlmgr запускать необходимые программы после регенерации файлов конфигурации. Эти
следующие: "fmtutil-sys --all" после "generate fmtutil", "fmtutil-sys --byhyphen
... / language.dat "после" сгенерировать language.dat "и" fmtutil-sys --byhyphen
... / language.def "после" сгенерировать language.def ".

Эти последующие вызовы заставляют вновь сгенерированные файлы фактически вступать в силу. Этот
не выполняется по умолчанию, так как эти вызовы являются длительными процессами, и можно захотеть
перед запуском этих программ последовательно внес несколько связанных изменений.

Соответствующие места следующие:

tex / generic / config / language.dat (и language-local.dat);
tex / generic / config / language.def (и language-local.def);
tex / generic / config / language.dat.lua (и language-local.dat.lua);

графический интерфейс пользователя
Запустите графический интерфейс пользователя. Видеть Графический интерфейс пользователя внизу.

info [вариант...] [коллекции | схемы |упак...]
Без аргументов перечисляет все пакеты, доступные в репозитории пакетов, с префиксом
уже установлен с "i".

С одним словом "коллекции" или "схемы" в качестве аргумента перечисляет тип запроса.
вместо всех пакетов.

С любыми другими аргументами отобразите информацию о упак: название, категория, краткое и
подробное описание, статус установки и номер версии TeX Live. Если упак Не
установлен локально, ищет в источнике удаленной установки.

If упак не найден локально или удаленно, используется действие поиска и перечисляет соответствующие
пакеты и файлы.

Он также отображает информацию, взятую из каталога TeX, а именно версию пакета,
дата и лицензия. Считайте их, особенно версию пакета, приблизительными.
только из-за временного сдвига обновлений разных частей. Напротив,
Значение "ревизии" исходит непосредственно от TL и является надежным.

Предыдущие действия "показать" и "список" объединены в это действие, но по-прежнему поддерживаются.
для обратной совместимости.

Опции:

--список
Если с пакетом задана опция "--list", список содержащихся файлов также
показаны, в том числе для зависимостей, зависящих от платформы. Когда дается со схемами
и коллекции, "--list" выводит их зависимости аналогичным образом.

--установлен только
Если задана эта опция, источник установки не будет использоваться; только локально
перечислены установленные пакеты, коллекции или схемы. (Не работает для перечисления
пакеты на данный момент)

дерево инициализации пользователя
Устанавливает дерево texmf для так называемого управления пользовательским режимом, либо дерево пользователей по умолчанию
("TEXMFHOME") или один, указанный в командной строке с помощью "--usertree". См. «РЕЖИМ ПОЛЬЗОВАТЕЛЯ»
внизу.

устанавливать [вариант] ... упак...
Установите каждый упак указывается в командной строке, если он еще не установлен. (Это не
прикоснуться к существующим пакетам; см. действие «обновить», чтобы узнать, как получить последнюю версию
упаковка.)

По умолчанию это также устанавливает все пакеты, в которых упакs зависимы.
Опции:

--прогон, репетиция
Фактически ничего не установлено; вместо этого действия, которые необходимо выполнить, записываются в
Терминал.

--файл
Вместо получения пакета из установочного репозитория используйте файлы пакета.
задано в командной строке. Эти файлы должны быть стандартными файлами пакета TeX Live (с
содержит файл tlpobj).

--сила
Если обновления для самого "tlmgr" (или других частей базовой инфраструктуры) присутствуют,
"tlmgr" выйдет из строя и не выполнит установку, если не задана эта опция.
Не рекомендуется.

- не зависит
Не устанавливайте зависимости. (По умолчанию установка пакета гарантирует, что все
зависимости этого пакета выполнены.)

- совсем не зависит
Обычно, когда вы устанавливаете пакет, который отправляет двоичные файлы, соответствующий двоичный файл
пакет также будет установлен. То есть для пакета "foo" пакет
«foo.i386-linux» также будет установлен в системе «i386-linux». Этот вариант
подавляет такое поведение, а также подразумевает "--no-depends". Не используйте его, если вы
уверены в том, что делаете.

--переустановить
Переустановите пакет (включая зависимости для коллекций), даже если он уже кажется
быть установленным (т.е. присутствует в TLPDB). Это полезно для восстановления после
случайное удаление файлов в иерархии.

При повторной установке учитываются только зависимости от обычных пакетов (т.е.
категории Схема или Коллекция).

--with-док
--with-источник
Хотя это и не рекомендуется, программа install-tl позволяет опускать
установка всей документации и / или исходных файлов. (По умолчанию все
установлен.) После такой установки вы можете обнаружить, что вам нужна документация
или исходные файлы для данного пакета в конце концов. Вы можете получить их, используя эти
параметры в сочетании с "--reinstall", как в (используя пакет "fontspec" в качестве
пример):

tlmgr install --reinstall --with-doc --with-src спецификация шрифтов

вариант
вариант [Показать]
вариант показать все
вариант ключ [ценностное ]

Первая форма показывает глобальные настройки TeX Live, сохраненные в данный момент в TLPDB с
краткое описание и «ключ» для его изменения в скобках.

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

В третьей форме, если ценностное не указан, настройка для ключ отображается. Если ценностное is
подарок, ключ на ценностное .

Возможные значения для ключ (для полного списка запустите команду tlmgr option showall):

репозиторий (репозиторий пакетов по умолчанию),
форматы (создавать форматы во время установки),
почтовый индекс (запустить blobs кода postinst)
docfiles (установить файлы документации),
srcfiles (установить исходные файлы),
backupdir (каталог по умолчанию для резервных копий),
autobackup (количество сохраняемых резервных копий).
sys_bin (каталог, к которому исполняемые файлы связаны действием path)
sys_man (каталог, к которому страницы руководства связаны действием path)
sys_info (каталог, с которым связаны файлы Info с помощью действия path)
desktop_integration (только для Windows: создание ярлыков в меню «Пуск»)
fileassocs (только для Windows: изменить ассоциации файлов)
многопользовательский (только для Windows: установка для всех пользователей)

Один из распространенных способов использования "option" - это навсегда изменить установку, чтобы продолжить
обновления из Интернета после первоначальной установки с DVD. Для этого можно запустить

репозиторий tlmgr option http://mirror.ctan.org/systems/texlive/tlnet

В документации по install-tl есть дополнительная информация о возможных значениях для
"хранилище". (Для обратной совместимости "местоположение" можно использовать как альтернативное название для
"хранилище".)

Если установлен "форматы" (это значение по умолчанию), то форматы восстанавливаются, когда либо
движок или файлы формата изменились. Отключите это, только если знаете, что вы
делает.

Параметр «почтовый индекс» управляет выполнением кода действия постустановки для каждого пакета. Это
установлен по умолчанию, и снова отключение, вероятно, не представляет интереса, за исключением, возможно,
Разработчики.

Параметры "docfiles" и "srcfiles" управляют установкой соответствующих файлов.
пакета. По умолчанию оба включены (1). Это можно отключить (установить на 0), если disk
пространство (очень) ограничено.

Параметры "autobackup" и "backupdir" определяют значения по умолчанию для действий "update",
"резервное копирование и восстановление". Этим трем действиям нужен каталог, в котором можно читать или писать.
резервные копии. Если "--backupdir" не указан в командной строке, "backupdir"
используется значение опции (если установлено).

Опция «autobackup» (де) активирует автоматическое создание резервных копий. Его ценность -
целое число. Если значение «autobackup» равно «-1», резервные копии не удаляются. Если "автобэкап" равен 0
или больше, он определяет количество сохраняемых резервных копий. Таким образом, резервное копирование отключено, если
значение равно 0. В режиме «--clean» действия «резервное копирование» эта опция также указывает
номер, который нужно сохранить.

Чтобы настроить «autobackup» на «-1» в командной строке, используйте:

Параметр tlmgr - автобэкап -1

Знак «-» позволяет избежать использования «-1» как опции. ("-" останавливает синтаксический анализ опций на
точка, в которой он появляется; это общая особенность большинства программ Unix.)

Параметры "sys_bin", "sys_man" и "sys_info" используются в Unix-подобных системах для управления
создание ссылок на исполняемые файлы, информационные файлы и страницы руководства. См. Действие "путь"
для получения информации.

Последние три параметра управляют поведением при установке Windows. Если
задано "desktop_integration", тогда некоторые пакеты будут устанавливать элементы в подпапку
Меню "Пуск" для "tlmgr gui", документации и т. Д. Если задано "fileassocs", файл Windows
создаются ассоциации (см. также действие "postaction"). Наконец, если установлен "многопользовательский",
затем выполняется адаптация к реестру и меню для всех пользователей системы.
только текущего пользователя. По умолчанию все три параметра включены.

статье
статье [a4 | письмо]
[xdvi | pdftex | dvips | dvipdfmx | context | psutils] статье [размер бумаги| --list]

Без аргументов («бумага tlmgr») показывает настройку размера бумаги по умолчанию для всех известных
программ.

С одним аргументом (например, "tlmgr paper a4") устанавливает значение по умолчанию для всех известных программ на
этот размер бумаги.

Если в качестве первого аргумента указана программа, а размер бумаги не указан (например, "tlmgr dvips
paper "), показывает размер бумаги по умолчанию для этой программы.

С программой, заданной в качестве первого аргумента, и размером бумаги в качестве последнего аргумента (например,
"tlmgr dvips paper a4") установите для этой программы размер бумаги по умолчанию.

С программой, заданной в качестве первого аргумента, и «--list» в качестве последнего аргумента (например,
"tlmgr dvips paper --list") показывает все допустимые размеры бумаги для этой программы. Первый размер
показано значение по умолчанию.

Между прочим, этот синтаксис наличия определенного имени программы перед ключевым словом paper выглядит так:
необычный. Он унаследован от давнего скрипта texconfig, который поддерживает другие
параметры конфигурации для некоторых программ, особенно "dvips". "tlmgr" не поддерживает эти
дополнительные настройки.

путь [--w32mode = пользователь | администратор] [добавить | удалить]
В Unix просто добавляет или удаляет символические ссылки для двоичных файлов, страниц руководства и информационных страниц в
системные каталоги, указанные в соответствующих опциях (см. описание «опции»
выше). Не меняет никаких файлов инициализации, ни системных, ни личных.

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

Если у пользователя есть права администратора, а параметр "--w32mode" не задан, параметр
w32_multi_user определяет местоположение (то есть, если он находится, то системный путь, в противном случае
путь пользователя изменен).

Если у пользователя есть права администратора и задана опция "--w32mode", эта опция определяет
путь, который нужно скорректировать.

Если у пользователя нет прав администратора, и опция "--w32mode" не указана, и
установка w32_multi_user выключен, путь пользователя изменяется, а если параметр
w32_multi_user горит, выдается предупреждение о том, что у вызывающего абонента недостаточно прав.

Если у пользователя нет прав администратора и задана опция "--w32mode", она должна быть
пользователь и путь пользователя будет скорректирован. Если пользователь без прав администратора использует опцию
«--w32mode admin» выдается предупреждение о том, что у вызывающего абонента недостаточно прав.

прикрепляя
Действие «закрепление» управляет закреплением файла, см. «Закрепление» ниже.

"булавочное шоу"
Показывает текущие данные закрепления.

"закрепление добавления" РЕПО pkgglob...
Закрепляет пакеты, соответствующие pkgglob(s) в репозиторий РЕПО.

"закрепление удалить" РЕПО pkgglob...
Любые пакеты, записанные в файле закрепления, соответствующие s для данного
хранилище РЕПО удалены.

"закрепление удалить РЕПО --все"
Удалить все закрепленные данные для репозитория РЕПО.

Платформа список | добавить | удалить Платформа...
Платформа набор Платформа
Платформа набор автоматический
"список платформ" перечисляет имена TeX Live всех платформ (также известных как архитектуры),
("i386-linux", ...) доступны в репозитории пакетов.

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

"платформа удалить" Платформа... удаляет исполняемые файлы для каждой данной платформы Платформа
из установки, но в любом случае сохраняет работающую платформу.

"платформенный набор" Платформа переключает TeX Live, чтобы всегда использовать данную платформу вместо авто
обнаружение.

"platform set auto" переключает TeX Live в режим автоматического определения платформы.

Определение платформы необходимо для выбора правильных двоичных файлов "xz", "xzdec" и "wget",
поставляются с TeX Live.

«арка» - синоним слова «платформа».

Опции:

--прогон, репетиция
Фактически ничего не установлено; вместо этого действия, которые необходимо выполнить, записываются в
Терминал.

постакция [--w32mode = пользователь | администратор] [--fileassocmode = 1 | 2] [--все] [установить | удалить]
[ярлык | fileassoc | скрипт] [упак] ...
Выполните пост-действие "ярлык", "fileassoc" или "скрипт", указанный в качестве второго необходимого
аргумент в режиме установки или удаления (который является первым обязательным аргументом) для любого
пакеты, указанные в командной строке, или для всех, если указано "--all".

Если параметру «--w32mode» присвоено значение «пользователь», все действия будут выполняться только
в доступных для пользователя частях реестра / файловой системы, а значение "admin" выбирает
общесистемные части реестра для файловых ассоциаций. Если у вас нет
достаточно разрешений, использование "--w32mode = admin" не даст результата.

«--fileassocmode» определяет действие для ассоциаций файлов. Если он установлен на 1 (
по умолчанию) добавляются только новые ассоциации; если установлено значение 2, все ассоциации устанавливаются на
программы TeX Live. (См. Также «option fileassocs».)

принт-платформа
Распечатайте идентификатор TeX Live для обнаруженной платформы (оборудование / операционная система)
комбинация со стандартным выводом и выход. «--принт-арка» - это синоним.

удаление [вариант] ... упак...
Удалить каждую упак указано. При удалении коллекции удаляются все зависимости пакетов (если только
"--no-plays" указан), но не какие-либо зависимости коллекции для этой коллекции.
Однако при удалении пакета зависимости никогда не удаляются. Опции:

- не зависит
Не удаляйте зависимые пакеты.

- совсем не зависит
Смотри выше под устанавливать (и будьте осторожны).

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

Пакет, который был удален с помощью параметра "--force", поскольку он все еще присутствует в списке.
в установленной коллекции или схеме не будут обновляться и будут отмечены как
принудительно удаленный на выходе тлмгр обновление --список.

--прогон, репетиция
Фактически ничего не удаляется; вместо этого действия, которые необходимо выполнить, записываются в
Терминал.

хранилище
хранилище список
хранилище список путь | тег
хранилище путь [день]
хранилище удаление путь | тег
хранилище набор путь[#день] [путь[#день] ...]
Это действие управляет списком репозиториев. См. Раздел «НЕСКОЛЬКО РЕПОЗИТОРИЙ» ниже.
подробные объяснения.

В первой форме («список») перечислены все настроенные репозитории и соответствующие теги, если
набор. Если после ключевого слова "список" указан путь, URL-адрес или тег, он интерпретируется как
источник, откуда следует инициализировать базу данных TeX Live, и перечисляет содержащиеся в ней пакеты.
Это также может быть неиспользуемый до сих пор репозиторий, как локальный, так и удаленный. Если один
передайте дополнительно "--with-platform", для каждого пакета доступные платформы (если есть)
тоже перечислены.

Третья форма («добавить») добавляет репозиторий (при желании добавляя тег) к списку
репозитории. Четвертая форма («удалить») удаляет репозиторий либо путем полного
путь / URL или по тегу. Последняя форма («набор») устанавливает список репозиториев для элементов
задано в командной строке, без сохранения предыдущих настроек

Во всех случаях один из репозиториев должен быть помечен как «основной»; в противном случае все
операции не пройдут!

восстановление [-каталог резервной копии директория] [--все | упак [оборот]]
Восстановите пакет из ранее сделанной резервной копии.

Если указан "--all", попробуйте восстановить последнюю версию всех резервных копий пакетов, найденных в
каталог резервных копий.

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

При перечислении доступных пакетов tlmgr показывает ревизию, а в скобках - создание
время, если доступно (в формате гггг-мм-дд чч: мм).

Если (и только если) оба упак и действующий номер редакции оборот указаны, попробуйте восстановить
пакет из указанной резервной копии.

Опции:

--все
Попробуйте восстановить последнюю версию всех резервных копий пакетов, найденных в резервной копии.
каталог. Дополнительные аргументы, не являющиеся опциями (например, упак) не допускаются.

--backupdir каталог
Укажите каталог, в котором должны быть найдены резервные копии. Если не дано, будет принято
из параметра конфигурации в TLPDB.

--прогон, репетиция
Фактически ничего не восстанавливается; вместо этого действия, которые необходимо выполнить, записываются в
Терминал.

--сила
Не задавай вопросов.

по области применения [вариант...] почему
по области применения [вариант...] --файл почему

по области применения [вариант...] --все почему

По умолчанию поиск по именам, кратким описаниям и длинным описаниям всех локально
установленные пакеты для аргумента почему, интерпретируется как регулярное выражение (Perl).

Опции:

--файл
Список всех имен файлов, содержащих почему.

--все
Искать все: имена пакетов, описания и имена файлов.

--Глобальный
Выполните поиск в базе данных TeX Live на установочном носителе, а не в локальном
установка.

--слово
Ограничьте поиск имен пакетов и описаний (но не имен файлов), чтобы они соответствовали
только полные слова. Например, поиск по запросу «таблица» с этой опцией не приведет к выводу
пакеты, содержащие слово "таблицы" (если они также не содержат слово "таблица" на
свой собственный).

Удалить
Удаляет всю установку TeX Live. Опции:

--сила
Подтверждения не просите, сразу удалите.

обновление [вариант] ... [упак] ...
Обновляет пакеты, указанные в качестве аргументов, до последней версии, доступной на
источник установки. Либо "--all", либо хотя бы один упак имя необходимо указать. Опции:

--все
Обновите все установленные пакеты, кроме самого "tlmgr". Таким образом, если обновления до "tlmgr"
присутствуют сами по себе, это просто выдаст ошибку, если также не указан параметр "--force"
или дается "--self". (Увидеть ниже.)

Помимо обновления установленных пакетов, при обновлении коллекции
локальная установка (по умолчанию) синхронизируется со статусом коллекции на
сервер, как для добавления, так и для удаления.

Это означает, что если пакет был удален на сервере (и, следовательно, также был
удален из соответствующей коллекции), "tlmgr" удалит пакет в локальном
установка. Это называется `` автоматическое удаление '' и объявляется как таковое при использовании
опция "--list". Это автоматическое удаление можно подавить с помощью параметра
«--no-auto-remove» (не рекомендуется, см. описание опции).

Аналогично, если пакет был добавлен в коллекцию на сервере, который также
установленный локально, он будет добавлен в локальную установку. Это называется
«автоматическая установка» и объявляется как таковая при использовании опции «--list». Этот авто-
установка может быть подавлена ​​с помощью опции "--no-auto-install".

Исключение из проверок зависимостей коллекции (включая автоматическую установку
только что упомянутые пакеты) - это те, которые были удалены вами `` принудительно '',
то есть, вы назвали их "tlmgr remove --force". (См. Действие "удалить"
документации.) Чтобы переустановить любые такие принудительно удаленные пакеты, используйте
"--reinstall-принудительно-удалено".

Если вы хотите исключить некоторые пакеты из текущего запуска обновления (например, из-за медленного
ссылка), см. параметр "--exclude" ниже.

--себя
Обновите сам "tlmgr" (то есть пакеты инфраструктуры), если обновления для него
настоящее время. В Windows это включает обновления поставляемого частного интерпретатора Perl.
внутри TeX Live.

Если этот параметр указан вместе с "--all" или списком пакетов, то
"tlmgr" будет обновлен первым, и, если это обновление завершится успешно, новая версия будет
перезапущен для завершения остальных обновлений.

Вкратце:

tlmgr update --self # обновить только инфраструктуру
tlmgr update --self --all # обновить инфраструктуру и все пакеты
tlmgr update --force --all # обновить все пакеты, но * не * инфраструктуру
# ... это последнее на ваш страх и риск, не рекомендуется!

--прогон, репетиция
Фактически ничего не установлено; вместо этого действия, которые необходимо выполнить, записываются в
Терминал. Это более подробный отчет, чем "--list".

--список [упак]
Кратко перечислите пакеты, которые будут обновлены, недавно установлены или удалены,
фактически ничего не меняя. Если также указан "--all", все доступные обновления
перечислены. Если указано «--self», а не «--all», будут обновляться только критические
перечислены пакеты (tlmgr, инфраструктура texlive, Perl для Windows и т. д.). Если
ни "--all", ни "--self" не указываются, и, кроме того, нет упак дается, то "--all"
предполагается (таким образом, «tlmgr update --list» совпадает с «tlmgr update --list --all»).
Если ни «--all», ни «--self» не указаны, но указаны конкретные имена пакетов, эти
пакеты проверяются на наличие обновлений.

--исключать упак
Исключать упак из процесса обновления. Если этот вариант указан более одного раза, его
аргументы накапливаются.

Аргумент упак исключает как пакет упак сама и вся связанная с ней платформа-
специальные пакеты уп.ARCH, Например,

обновление tlmgr --all --exclude a2ping

не будет обновлять "a2ping", "a2ping.i386-linux" или любой другой "a2ping".ARCH пакет.

Если этот параметр указывает пакет, который в противном случае мог бы быть кандидатом на автоматическое
установка, автоматическое удаление или повторная установка принудительно удаленного пакета "tlmgr"
завершает работу с сообщением об ошибке. В этих обстоятельствах исключения не поддерживаются.

--no-автоматическое удаление [упак] ...
По умолчанию "tlmgr" пытается удалить пакеты, которые исчезли на сервере, поскольку
описано выше в разделе «--all». Эта опция предотвращает такое удаление для всех
пакеты (с "--all") или только для заданного упак имена. Это может привести к
непоследовательная установка TeX, поскольку пакеты нередко переименовываются или заменяются
их авторами. Поэтому это не рекомендуется.

--нет автоматической установки [упак] ...
Обычно tlmgr устанавливает новые пакеты на сервере,
как описано выше в разделе «--all». Эта опция предотвращает любые такие автоматические
установка либо для всех пакетов (с "--all"), либо для данного упак имена.

Кроме того, после того, как "tlmgr" будет запущен с его использованием, пакеты, которые будут
были установлены автоматически предусматривает be считается as принудительно удаленный. Итак, если "foobar"
единственный новый пакет на сервере, затем

обновление tlmgr --all --no-auto-install

эквивалентна

tlmgr update - все
tlmgr удалить --force foobar

--reinstall-принудительно-удалено
В обычных условиях tlmgr не устанавливает пакеты, которые были принудительно
удалено пользователем; то есть удален с помощью "remove --force" или чья установка была
запрещено "--no-auto-install" во время более раннего обновления.

Эта опция заставляет tlmgr игнорировать принудительное удаление и переустанавливать все такие
пакеты. Это можно использовать для полной синхронизации установки с сервером.
представление о том, что есть в наличии:

tlmgr update --reinstall-принудительно-удалено --all

--резервное копирование и --backupdir каталог
Эти две опции управляют созданием резервных копий пакетов. до обновление; тот
есть резервная копия установленных пакетов. Если ни один из этих вариантов не указан,
пакет резервного копирования не будет сохранен. Если указан "--backupdir" и указывает доступный для записи
каталог, то в этом месте будет сделана резервная копия. Если задано только "--backup",
тогда резервная копия будет сделана в каталог, ранее установленный с помощью действия "option"
(увидеть ниже). Если даны оба, то резервная копия будет сделана на указанный каталог.

Вы можете установить параметры с помощью действия "option" для автоматического создания резервных копий для всех
пакеты и / или хранить только определенное количество резервных копий. Пожалуйста, посмотрите "вариант"
действие для подробностей.

"tlmgr" всегда делает временную резервную копию при обновлении пакетов, в случае загрузки или
другой сбой во время обновления. Напротив, цель этой опции "--backup" -
чтобы вы могли сохранить постоянную резервную копию на случай, если содержание обновления
вызывает проблемы, например, несовместимость.

Действие «восстановление» объясняет, как выполнить восстановление из резервной копии.

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

- совсем не зависит
Смотри выше под устанавливать (и будьте осторожны).

--сила
Принудительное обновление обычных пакетов без обновления самого "tlmgr" (если только "--self"
вариант тоже дан). Не рекомендуется.

Кроме того, «update --list» по-прежнему выполняется независимо от этой опции.

Если пакет на сервере старше, чем уже установленный пакет (например, если
выбранное зеркало устарело) "tlmgr" не понижает версию. Также пакеты для
неустановленные платформы не устанавливаются.

"tlmgr" сохраняет копию файла "texlive.tlpdb", используемого для обновления, с суффиксом.
представляющий URL-адрес репозитория, например "tlpkg / texlive.tlpdb".длинная хеш-строка, Эти могут
быть полезными для резервной информации, но если вам не нравится, что они накапливаются (например, на каждом
запуск "mirror.ctan.org" может разрешить новый хост, что приведет к другому хешу), это
безобидно их удалять.

USER РЕЖИМ

"tlmgr" предоставляет ограниченный способ, называемый "пользовательским режимом", для управления произвольными деревьями texmf.
так же, как и основная установка. Например, это позволяет людям без записи
разрешения в месте установки для обновления / установки пакетов в дерево их
своя.

«tlmgr» переключается в пользовательский режим с параметром командной строки «--usermode». Это не
переключается автоматически, и для него нет никаких настроек файла конфигурации. Таким образом, это
опция должна быть явно указана каждый раз, когда должен быть активирован пользовательский режим.

Этот режим "tlmgr" работает с деревом пользователей, по умолчанию значение "TEXMFHOME"
Переменная. Это можно изменить с помощью параметра командной строки --usertree. в
далее, когда мы говорим о дереве пользователей, мы имеем в виду либо "TEXMFHOME", либо тот, который указан на
командная строка.

Не все действия разрешены в пользовательском режиме; "tlmgr" предупредит вас и не выполнит никаких
проблемные действия. В настоящее время не поддерживается (и, вероятно, никогда не будет)
«платформенное» действие. Действие "gui" в настоящее время не поддерживается, но может появиться в будущем.
отпустить.

Некоторым действиям "tlmgr" не нужны права на запись, поэтому они работают одинаково в пользовательском режиме.
и нормальный режим. В настоящее время это: «проверка», «помощь», «список», «платформа для печати»,
«поиск», «показать», «версия».

С другой стороны, большинство действий, связанных с управлением пакетами, действительно требует написания
разрешения, и, следовательно, вести себя по-разному в пользовательском режиме, как описано ниже: «установить»,
«обновить», «удалить», «вариант», «бумажный», «создать», «сделать резервную копию», «восстановить», «удалить»,
"символические ссылки".

Перед использованием "tlmgr" в пользовательском режиме вы должны настроить дерево пользователей с
Действие "init-usertree". Это создает дерево пользователя"/ web2c" и дерево пользователя"/ tlpkg / tlpobj" и
минимальный дерево пользователя"/tlpkg/texlive.tlpdb". В этот момент вы можете сказать "tlmgr" выполнить
(поддерживаемые) действия путем добавления параметра командной строки "--usermode".

В пользовательском режиме файл дерево пользователя"/tlpkg/texlive.tlpdb" содержит только пакеты с
был установлен в дерево пользователей с помощью "tlmgr", плюс дополнительные параметры из
«виртуальный» пакет «00texlive.installation» (похож на основной установочный пакет).
"texlive.tlpdb").

Все действия с пакетами в пользовательском режиме могут выполняться только с пакетами, которые известны как
"перемещаемый". Это исключает все пакеты, содержащие исполняемые файлы и несколько других ядер.
пакеты. Из примерно 2500 пакетов, имеющихся в настоящее время в TeX Live, подавляющее большинство являются
перемещаемый и может быть установлен в дерево пользователей.

Описание изменений действий в пользовательском режиме:

Информация о пользователе Режим устанавливать
В пользовательском режиме действие "install" проверяет, что пакет и все зависимости все
либо перемещен, либо уже установлен в установке системы. Если это так, то
распаковывает все контейнеры для установки в дерево пользователей (повторюсь, либо
«TEXMFHOME» или значение «--usertree») и добавьте соответствующие пакеты пользователю
"texlive.tlpdb" дерева (при необходимости создавая его).

В настоящее время при установке коллекции в пользовательском режиме устанавливаются все зависимые пакеты, но в
в отличие от нормального режима, не установить зависимые коллекции. Например, в нормальном
режим "tlmgr install collection-context" установит "collection-basic" и другие
коллекции, находясь в пользовательском режиме, Важно пакеты, упомянутые в "контексте-коллекции", являются
установлен.

Информация о пользователе Режим резервное копирование восстановить, Удалить, обновление
В пользовательском режиме эти действия проверяют, что все пакеты, над которыми нужно действовать, установлены в
дерево пользователей перед продолжением; в остальном они ведут себя так же, как в обычном режиме.

Информация о пользователе Режим генерировать вариант, статье
В пользовательском режиме эти действия работают только с файлами конфигурации дерева пользователей и / или
"texlive.tlpdb". создает файлы конфигурации в дереве пользователей

КОНФИГУРАЦИЯ ФАЙЛОВ Для ТЛМГР

Небольшое подмножество параметров командной строки можно установить в файле конфигурации для "tlmgr", который
находится в «TEXMFCONFIG / tlmgr / config». По умолчанию файл конфигурации находится в
"~ / .texliveYYYY / texmf-config / tlmgr / config"(заменив" YYYY "на год вашего TeX
Живая установка). Это "TEXMFSYSVAR", чтобы файл относился к одному
пользователь.

В этом файле пустые строки и строки, начинающиеся с символа #, игнорируются. Все остальные строки должны
выглядит как

ключ = значение

где допустимые ключи: "gui-expertmode" (значение 0 или 1), "persistent-downloads" (значение
0 или 1), «auto-remove» (значение 0 или 1) и «gui-lang» (значение, подобное в командной строке
опция).

"persistent-downloads", "gui-lang" и "auto-remove" соответствуют соответствующей команде.
одноименные варианты линии. "gui-expertmode" переключает между полным графическим интерфейсом и
упрощенный графический интерфейс с только важными и наиболее часто используемыми настройками.

НЕСКОЛЬКО РЕПОЗИТОРИИ

Главный репозиторий TeX Live содержит огромное количество пакетов. Тем не менее, дополнительные
локальные репозитории могут быть полезны для предоставления локально установленных ресурсов, таких как
фирменные шрифты и домашние стили. Также альтернативные репозитории пакетов распространяют
пакеты, которые не могут или не должны быть включены в TeX Live по какой-либо причине.

Самый простой и надежный способ - временно установить источник установки на любой
репозиторий (с параметрами командной строки "-repository" или "option repository") и
выполнять свои операции.

Однако, когда вы используете несколько репозиториев в течение длительного времени, явно
переключаться между ними становится неудобно. Таким образом, можно сказать "tlmgr" о
дополнительные репозитории, которые вы хотите использовать. Основная команда - «добавить репозиторий tlmgr».
Остальная часть этого раздела объясняет более подробно.

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

По умолчанию, даже если настроено несколько репозиториев, пакеты все еще Важно
устанавливается из основного репозитория. Таким образом, простое добавление второго репозитория не
фактически разрешить установку чего-либо оттуда. Вы также должны указать, какие
пакеты следует брать из нового репозитория, указав так называемое `` закрепление ''
правила, описанные далее.

Закрепление
Когда пакет «foo» закреплен в репозитории, пакет «foo» в любом другом репозитории,
даже если он имеет более высокий номер ревизии, не будет считаться кандидатом для установки.

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

Во-первых, убедитесь, что у нас есть поддержка нескольких репозиториев и включен только один (как
по умолчанию):

Список репозиториев $ tlmgr
Список репозиториев (с тегами, если они установлены):
/ вар / www / норберт / tlnet

В порядке. Добавим репозиторий "tlcontrib" (это настоящий репозиторий, размещенный на
<http://tlcontrib.metatex.org>, поддерживается Taco Hoekwater et al.) с тегом
"tlcontrib":

Репозиторий $ tlmgr добавить http://tlcontrib.metatex.org/2012 tlcontrib

Еще раз проверьте список репозиториев:

Список репозиториев $ tlmgr
Список репозиториев (с тегами, если они установлены):
http://tlcontrib.metatex.org/2012 (tlcontrib)
/ var / www / norbert / tlnet (основной)

Теперь мы указываем запись закрепления, чтобы получить пакет "context" от "tlcontrib":

$ tlmgr закрепление добавить контекст tlcontrib

Убедитесь, что мы можем найти «контекст»:

$ tlmgr показать контекст
tlmgr: репозитории пакетов:
...
пакет: контекст
репозиторий: tlcontrib / 26867
...

- установить «контекст»:

Контекст установки $ tlmgr
tlmgr: репозитории пакетов:
...
[1/1, ??: ?? / ??: ??] install: context @tlcontrib [

В выходных данных вы можете видеть, что "контекстный" пакет был установлен из
Репозиторий "tlcontrib" (@tlcontrib).

Наконец, tlmgr pinning также поддерживает удаление некоторых или всех пакетов из заданного
репозиторий:

$ tlmgr закрепление удалить tlcontrib context # удалить только контекст
$ tlmgr pinning remove tlcontrib --all # ничего не брать от tlcontrib

Сводка действий по закреплению tlmgr приведена выше.

Графический интерфейс пользователя Для ТЛМГР

Для графического пользовательского интерфейса «tlmgr» необходимо установить Perl / Tk. Для Windows
необходимые модули поставляются в TeX Live, для всех остальных (например, Unix-систем)
Perl / Tk (и, конечно, Perl) должен быть установлен.
<http://tug.org/texlive/distro.html#perltk> содержит список вызовов для некоторых дистрибутивов.

При запуске с «tlmgr gui» будет показан графический интерфейс пользователя. Главное окно
содержит строку меню, основной дисплей и область состояния, где сообщения обычно отображаются на
консоль отображается.

Основной дисплей состоит из трех основных частей: области «Конфигурация дисплея»,
список пакетов и кнопки действий.

Кроме того, в правом верхнем углу отображается текущий загруженный репозиторий; это также действует как
и при нажатии попытается загрузить репозиторий по умолчанию. Чтобы загрузить другой
репозиторий, см. пункт меню «tlmgr».

Наконец, в области состояния в нижней части окна отображается дополнительная информация о
что происходит.

Главная дисплей
Дисплей конфигурация область

Первая часть основного экрана позволяет вам указать (отфильтровать), какие пакеты
показано. По умолчанию отображаются все. Изменения здесь отражаются сразу.

Статус:
Выберите, следует ли отображать все пакеты (по умолчанию), только установленные, только те
установлены или только те, для которых доступно обновление.

Категория
Выберите, какие категории будут отображаться: пакеты, коллекции и / или схемы. Эти
кратко объяснено в разделе «ОПИСАНИЕ» выше.

Совпадение
Выберите пакеты, соответствующие определенному шаблону. По умолчанию поиск выполняется как
описания и имена файлов. Вы также можете выбрать подмножество для поиска.

Выбор
Выберите пакеты для выбранных, не выбранных или всех. Здесь `` выбранный ''
означает, что установлен флажок в начале строки пакета.

Кнопки настройки дисплея
Справа есть три кнопки: выбрать все пакеты, не выбрать ни одного (он же
снимите выделение со всех) и сбросьте все эти фильтры на значения по умолчанию, т. е. покажите все доступные.

Упаковка список область

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

Двойной щелчок по строке пакета вызывает информационное окно с более подробной информацией:
подробное описание, включенные файлы и т. д.

Каждая строка списка пакетов состоит из следующих пунктов:

флажок
Используется для выбора определенных пакетов; некоторые из кнопок действий (см. ниже) работают только
по выбранным пакетам.

имя пакета
Имя (идентификатор) пакета, как указано в базе данных.

местная ревизия (и версия)
Если пакет установлен, номер версии TeX Live для установленного пакета
будет показано. Если в базе данных есть версия каталога для этого
пакет, он будет показан в скобках. Однако версия каталога, в отличие от
Версия TL не обязательно отражает то, что на самом деле установлено.

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

Краткое описание
Краткое описание пакета.

Главная дисплей действие кнопки

Под списком пакетов есть несколько кнопок:

Обновить все установлено
Это вызывает «tlmgr update --all», т.е. пытается обновить все доступные пакеты. Ниже
эта кнопка является переключателем, позволяющим переустановить ранее удаленные пакеты как часть
этого действия.

Остальные четыре кнопки работают только с выбранными пакетами, т.е.
установлен флажок в начале строки пакета.

Обновление ПО
Обновить только выбранные пакеты.

Установите
Установить выбранные пакеты; действует как "tlmgr install", т. е. также устанавливает
зависимости. Таким образом, при установке коллекции устанавливаются все составляющие ее пакеты.

Удалить
Удаляет выбранные пакеты; действует как "tlmgr remove", т. е. также удаляет
зависимости коллекций (но не зависимости обычных пакетов).

Восстановление
Делает резервную копию выбранных пакетов; действует как «резервное копирование tlmgr». Это действие требует
установить опцию "backupdir" (см. "Параметры -" Общие>).

Меню бар
В строке меню можно найти следующие записи:

меню "tlmgr"
Элементы здесь загружают различные репозитории: по умолчанию, как указано в TeX Live.
база данных, сетевой репозиторий по умолчанию, репозиторий, указанный в командной строке
(если есть), и произвольно введенный вручную. Также есть так необходимое «бросить».
операции.

«Меню опций»
Предоставляет доступ к нескольким группам опций: «Бумага» (конфигурация бумаги по умолчанию.
размеров), «Платформы» (только на Unix, конфигурация поддерживаемых / установленных
платформы), «Язык графического интерфейса» (выберите язык, используемый в интерфейсе графического интерфейса) и «Общие»
(все остальное).

Также здесь есть несколько переключателей. Первый - «Экспертные параметры», который задается
дефолт. Если вы отключите это, при следующем запуске графического интерфейса появится упрощенный экран.
будут показаны только самые важные функции. Этот параметр
сохраняется в конфигурационном файле «tlmgr»; см. "КОНФИГУРАЦИОННЫЙ ФАЙЛ ДЛЯ TLMGR" для


Все остальные переключатели по умолчанию отключены: для вывода отладки, чтобы отключить
автоматическая установка новых пакетов и отключение автоматического удаления
пакеты удалены с сервера. Играя с выбором того, что есть, а что нет
установка может привести к некорректной установке TeX Live; например, когда пакет
переименован.

«Меню действий»
Предоставляет доступ к нескольким действиям: обновлять базу данных имен файлов (также известную как «ls-R»,
«mktexlsr», «texhash»), пересобрать все форматы («fmtutil-sys --all»), обновить карту шрифтов
база данных ("updmap-sys"), восстановление из резервной копии пакета и использование символических ссылок
в системных каталогах (не в Windows).

Последнее действие - удалить всю установку TeX Live (также не в Windows).

«Меню помощи»
Предоставляет доступ к руководству TeX Live (также в Интернете по адресу
<http://tug.org/texlive/doc.html>) и обычное окошко `` О программе ''.

МАШИНОЧИТАЕМЫЙ ВЫВОД

С параметром «--machine-readable» «tlmgr» записывает в стандартный вывод в фиксированной строке с ориентацией.
формат, описанный здесь, и обычные информационные сообщения для потребления людьми
записываются в stderr (обычно они записываются в stdout). Идея в том, что программа может
получить всю необходимую информацию, прочитав stdout.

В настоящее время эта опция применяется только к действиям обновления, установки и «опции».

Машиночитаемый "Обновить" и "установить" выходной
Формат вывода следующий:

fieldname "\ t" значение
...
"конец заголовка"
pkgname статус localrev serverrev размер время выполнения esttot
...
"конец обновлений"
другой вывод из пост-действий, не в машиночитаемой форме

Раздел заголовка в настоящее время имеет два поля: "адрес-адрес" (источник репозитория из
какие обновления рисуются) и "total-bytes" (общее количество байтов, которые должны быть
скачал).

Команда местная версия и серверная версия поля для каждого пакета - это номера ревизий в локальном
установка и репозиторий сервера соответственно. В размер поле - количество байтов
для загрузки, то есть размер сжатого tar-файла для сетевой установки,
не распакованный размер. Поля runtime и esttot присутствуют только для обновленных и
пакеты автоматической установки и содержат время, прошедшее с начала
установка / обновления и примерное общее время.

Окончание строк может быть LF или CRLF в зависимости от текущей платформы.

"URL-адрес" расположение
Команда расположение может быть URL-адрес (включая "file: /// foo / bar / ...") или имя каталога
("/ foo / bar"). Это репозиторий пакетов, из которого была получена информация о новом пакете.
нарисован.

"всего-байтов" считать
Команда считать это просто десятичное число, сумма размеров всех пакетов, которые
требуется обновление или установка (перечисленные ниже).

Затем идет строка, содержащая только буквальную строку «конец заголовка».

Каждая следующая строка до строки с буквальной строкой «end-of-updates» сообщает об одном
упаковка. Поля в каждой строке разделены табуляцией. Вот поля.

имя_пакета
Идентификатор пакета TeX Live с возможным суффиксом платформы для исполняемых файлов. За
например, "pdftex" и "pdftex.i386-linux" представлены как два отдельных пакета, один на
каждая строка.

статус
Статус обновления пакета. Один персонаж, такой как:

"d" Пакет был удален с сервера.

"f" Пакет был удален при локальной установке, хотя коллекция
зависело от этого. (Например, пользователь запустил «tlmgr remove --force».)

"u" Требуется обычное обновление.

"r" Обратное отсутствие обновления: локально установленная версия новее, чем версия.
на сервере.

"a" Автоматически определяемая потребность в установке, пакет новый на
server и (скорее всего) является частью установленной коллекции.

Будет установлен пакет "i", которого нет в локальной установке (действие
установить).

Пакет «I» уже присутствует, но будет переустановлен (действие установить).

местная версия
Номер версии установленного пакета или «-», если он отсутствует локально.

серверная версия
Номер версии пакета на сервере или "-", если его нет на
сервера.

размер
Размер пакета на сервере в байтах. Сумма всех размеров упаковки составляет
дается в поле заголовка «total-bytes», упомянутом выше.

время выполнения
Время выполнения с момента начала установки или обновления.

Esttot
Расчетное общее время.

Машиночитаемый "вариант" выходной
Формат вывода следующий:

ключ "\ t" значение

Если значение не сохранено в базе данных, отображается строка «(не задано)».

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

АВТОРЫ И АВТОРСКИЕ ПРАВА

Этот скрипт и его документация написаны для дистрибутива TeX Live.
(<http://tug.org/texlive>), и оба находятся под лицензией GNU General Public License.
Версия 2 или более поздняя.

Используйте tlmgr онлайн с помощью сервисов onworks.net