tlmgr — online w chmurze

PROGRAM:

IMIĘ

tlmgr — menedżer TeX-a na żywo

STRESZCZENIE

tlmgr [opcja] ... akcja [opcja]... [operand] ...

OPIS

tlmgr zarządza istniejącą instalacją TeX Live, zarówno pakietami, jak i opcjami konfiguracji.
Aby uzyskać informacje na temat początkowego pobierania i instalowania TeX Live, zobacz
<http://tug.org/texlive/acquire.html>.

Najbardziej aktualna wersja tej dokumentacji (aktualizowana co noc od wersji development
źródła) jest dostępny pod adresemhttp://tug.org/texlive/tlmgr.html> wraz z procedurami dot
aktualizowanie samego „tlmgr” oraz informacji o wersjach testowych.

OSTRZEŻENIE: tlmgr w Debianie działa zawsze w trybie użytkownika

TeX Live jest podzielony na kilka najwyższych poziomów systemy, z których każdy jest określony jako a
inny zestaw kolekcje oraz Pakiety, gdzie kolekcja jest zbiorem pakietów, a a
pakiet zawiera rzeczywiste pliki. Schematy zazwyczaj zawierają mieszankę kolekcji i
pakiety, ale każdy pakiet jest zawarty w dokładnie jednej kolekcji, nie więcej i nie mniej. A
Instalacja TeX Live może być dostosowywana i zarządzana na dowolnym poziomie.

Widziećhttp://tug.org/texlive/doc> dla całej dostępnej dokumentacji TeX Live.

PRZYKŁADY

Po pomyślnym zainstalowaniu TeX Live, oto kilka typowych operacji z „tlmgr”:

„Repozytorium opcji tlmgr http://mirror.ctan.org/systems/texlive/tlnet"
Powiedz „tlmgr”, aby używał pobliskiego serwera lustrzanego CTAN do przyszłych aktualizacji; przydatne, jeśli zainstalowałeś
TeX Live z obrazu DVD i chcesz ciągłych aktualizacji.

"aktualizacja tlmgr -- lista"
Zgłoś, co zostałoby zaktualizowane bez faktycznej aktualizacji czegokolwiek.

„Aktualizacja tlmgr --wszystko”
Spraw, aby lokalna instalacja TeX-a była zgodna z tym, co znajduje się w repozytorium pakietów
(zwykle przydatne podczas aktualizacji z CTAN).

"informacje tlmgr" co
Wyświetl szczegółowe informacje o paczce co, takie jak stan instalacji i
opis wyszukiwania dla co we wszystkich pakietach.

Aby zapoznać się ze wszystkimi możliwościami i szczegółami „tlmgr”, przeczytaj poniższą obszerną
informacje.

OPCJE

Następujące opcje „tlmgr” są opcjami globalnymi, które nie są specyficzne dla żadnej akcji. Wszystko
opcje, zarówno globalne, jak i specyficzne dla akcji, można podać w dowolnym miejscu w wierszu poleceń, oraz
w dowolnej kolejności. Pierwszym argumentem niebędącym opcją będzie akcja główna. we wszystkich przypadkach
„-”opcja I "-"opcja są równoważne, a „=” jest opcjonalne między nazwą opcji a
jego wartość.

--magazyn URL|ścieżka
Określa repozytorium pakietów, z którego mają być instalowane lub aktualizowane pakiety,
zastąpienie domyślnego repozytorium pakietów znalezionego w pakiecie TeX Live Package instalacji
Baza danych (inaczej TLPDB, zdefiniowana w całości w pliku „tlpkg/texlive.tlpdb”). The
dokumentacja dla „install-tl” zawiera więcej szczegółów na ten temat
(<http://tug.org/texlive/doc/install-tl.html>).

„--repository” zmienia lokalizację repozytorium tylko dla bieżącego przebiegu; zrobić
trwałej zmiany, skorzystaj z „repozytorium opcji” (patrz akcja „opcja”).

Ze względu na kompatybilność wsteczną i wygodę, "--location" i "--repo" są akceptowane jako
aliasy dla tej opcji.

--gui [akcja]
„tlmgr” ma interfejs graficzny, a także interfejs wiersza poleceń. Możesz dać
ta opcja, „--gui”, wraz z akcją, która ma zostać przeniesiona bezpośrednio do
odpowiedni ekran GUI. Na przykład bieganie

tlmgr --aktualizacja gui

uruchamia Cię bezpośrednio na ekranie aktualizacji. Jeśli nie zostanie podana żadna akcja, GUI będzie
uruchomione na ekranie głównym.

--gui-lang llkod
Domyślnie GUI próbuje wywnioskować twój język ze środowiska (w Windows przez
w rejestrze w systemie Unix przez „LC_MESSAGES”). Jeśli to się nie powiedzie, możesz wybrać inny
język poprzez nadanie tej opcji kodu języka (na podstawie ISO 639-1). Obecnie
obsługiwane (ale niekoniecznie w pełni przetłumaczone) to: angielski (en, default),
Czeski (cs), niemiecki (de), francuski (fr), włoski (it), japoński (ja), holenderski (nl), polski
(pl), brazylijski portugalski (pt_BR), rosyjski (ru), słowacki (sk), słoweński (sl), serbski
(sr), ukraiński (uk), wietnamski (vi), chiński uproszczony (zh_CN) i tradycyjny
chiński (zh_TW).

--debug-tłumaczenie
W trybie GUI ten przełącznik mówi „tlmgr”, aby zgłaszał wszelkie nieprzetłumaczone (lub brakujące)
komunikaty do błędu standardowego. Może to pomóc tłumaczom zorientować się, co pozostaje do zrobienia.

--do odczytu maszynowego
Zamiast normalnej produkcji przeznaczonej do spożycia przez ludzi, napisz (do standard
output) stały format bardziej odpowiedni do parsowania maszynowego. Zobacz „CZYTEL MASZYNOWY
WYJŚCIE” poniżej.

--nie-wykonaj-akcji
Wstrzymaj wykonywanie akcji wykonywania zgodnie z definicją w plikach tlpsrc.
Udokumentowane tylko dla kompletności, ponieważ jest to przydatne tylko podczas debugowania.

--plik-logu pakietu filet
„tlmgr” rejestruje wszystkie działania pakietu (instalacja, usuwanie, aktualizacja, nieudane aktualizacje, nieudane
przywraca) do osobnego pliku dziennika, domyślnie „TEXMFSYSVAR/web2c/tlmgr.log”. Ten
opcja pozwala określić inny plik dla dziennika.

--pauza
Ta opcja powoduje, że „tlmgr” czeka na wprowadzenie danych przez użytkownika przed wyjściem. Przydatne w systemie Windows do
uniknąć znikania okien poleceń.

--trwałe-pobrania
--no-persistent-downloads
W przypadku instalacji opartych na sieci ta opcja (domyślnie włączona) powoduje próbę ustawienia „tlmgr”.
ustanowić trwałe połączenie (przy użyciu modułu Perla „LWP”). Chodzi o to, aby otworzyć i
ponownie używaj tylko jednego połączenia na sesję między komputerem a serwerem zamiast
inicjowanie nowego pobierania dla każdego pakietu.

Jeśli nie jest to możliwe, „tlmgr” powróci do używania „wget”. Aby je wyłączyć
trwałych połączeń, użyj „--no-persistent-downloads”.

--pin-plik
Zmień lokalizację pliku przypinania z „TEXMFLOCAL/tlpkg/pinning.txt” (patrz „Przypinanie”
poniżej). Udokumentowane tylko dla kompletności, ponieważ jest to przydatne tylko podczas debugowania.

--tryb użytkownika
Aktywuje tryb użytkownika dla tego uruchomienia „tlmgr”; patrz „TRYB UŻYTKOWNIKA” poniżej.

--drzewo użytkowników reż
Używa reż dla drzewa w trybie użytkownika; patrz „TRYB UŻYTKOWNIKA” poniżej.

Akceptowane są również standardowe opcje programów TeX Live: "--help/-h/-?", "--version",
„-q” (brak komunikatów informacyjnych), „-v” (komunikaty debugowania, mogą być powtarzane). Dla
szczegółowe informacje na ten temat można znaleźć w dokumentacji „TeXLive::TLUtils”.

Opcja „--version” pokazuje informacje o wersji TeX Live oraz o
sam skrypt „tlmgr”. Jeśli podano również "-v", numer wersji załadowanego TeX Live
Pokazane są również moduły Perla.

DZIAŁANIA

pomoc
Wyświetl te informacje pomocy i wyjdź (tak samo jak „--help” oraz w Internecie pod adresem
<http://tug.org/texlive/doc/tlmgr.html>). Czasami programy „perldoc” i/lub „PAGER”.
w systemie mają problemy, w wyniku czego znaki kontrolne są dosłownie wyprowadzane. Ten
nie zawsze można wykryć, ale można ustawić zmienną środowiskową „NOPERLDOC” i
„perldoc” nie będzie używany.

wersja
Podaje informacje o wersji (tak samo jak „--version”).

Jeśli podano "-v", raportowane są również wersje używanych modułów.

backup [--wyczyść[=N]] [--kat.kopii reż] [--Wszystko | Pkg] ...
Jeśli opcja „--clean” nie jest określona, ​​ta akcja tworzy kopię zapasową podanego
pakiety lub wszystkie pakiety z podanym „--all”. Te kopie zapasowe są zapisywane do wartości
Opcja „--backupdir”, jeśli jest to katalog istniejący i zapisywalny. Jeśli "--backupdir" jest
nie podano, używane jest ustawienie opcji „backupdir” w TLPDB, jeśli jest obecne. Jeśli oba są
brak, kopie zapasowe nie są tworzone.

Jeśli określono opcję „--clean”, kopie zapasowe są oczyszczane (usuwane) zamiast zapisywane. The
opcjonalna wartość całkowita N można określić, aby ustawić liczbę kopii zapasowych, które będą
zachowane podczas czyszczenia. Jeśli nie podano „N”, używana jest wartość opcji „autobackup”.
Jeśli brakuje obu, generowany jest błąd. Aby uzyskać więcej informacji na temat czyszczenia kopii zapasowych, zobacz
akcja „opcja”.

Opcje:

--katalog_zapasowy katalog
Zastępuje ustawienie opcji „backupdir” w TLPDB. The katalog argumentem jest
wymagane i musi określać istniejący, zapisywalny katalog, w którym mają być przechowywane kopie zapasowe
umieszczony.

--wszystko
Jeśli nie podano opcji „--clean”, wykonaj kopię zapasową wszystkich pakietów w TeX Live
instalacja; zajmie to sporo miejsca i czasu. Jeśli "--clean" jest
określony, wszystkie pakiety są usuwane.

--czysty[=N]
Zamiast tworzyć kopie zapasowe, oczyść katalog kopii zapasowych starych kopii zapasowych, jak wyjaśniono
powyżej. Opcjonalny argument typu liczba całkowita N zastępuje opcję „automatycznej kopii zapasowej” ustawioną w pliku
TLPDB. Musisz użyć "--all" lub listy pakietów razem z tą opcją, as
pożądany.

--próba
W rzeczywistości nic nie jest archiwizowane ani usuwane; zamiast tego są działania, które należy wykonać
napisane do terminala.

kandydatów Pkg
kandydatów Pkg
Pokazuje dostępne repozytoria kandydujące dla pakietu Pkg. Zobacz „WIELE
REPOZYTORIA” poniżej.

ZOBACZ [opcja] ... [pliki|zależy|wykonuje|pliki uruchomieniowe|wszystkie]
Wykonuje jedną (lub wszystkie) kontrolę spójności instalacji.

pliki
Sprawdza, czy wszystkie pliki wymienione w lokalnym TLPDB („texlive.tlpdb”) są rzeczywiście
obecnych i wymienia tych, których brakuje.

zależy
Wyświetla listę tych pakietów, które występują jako zależności w zainstalowanych kolekcjach, ale są
same nie są zainstalowane, a te pakiety, które nie są zawarte w żadnej kolekcji.

Jeśli wywołasz „tlmgr check collections”, ten test zostanie przeprowadzony zamiast tego
poprzednie wersje „tlmgr” nazywały to w ten sposób.

stracony
Sprawdź, czy pliki, do których odnoszą się dyrektywy „execute” w TeX Live Database, są
prezent.

pliki wykonawcze
Wypisz te nazwy plików, które występują więcej niż jeden raz w plikach wykonawczych.

Opcje:

--use-svn
Użyj wyjścia „svn status” zamiast listy plików; do sprawdzenia TL
repozytorium rozwoju.

conf [texmf|tlmgr|updmap [--konfig filet] [--usuwać] [klucz [wartość]]]
Tylko z „conf”, pokaż ogólne informacje o konfiguracji TeX Live, w tym aktywne
pliki konfiguracyjne, ustawienia ścieżek i inne. To jest jak wywołanie „texconfig conf”, ale
działa na wszystkich obsługiwanych platformach.

Z dodatkowym "conf texmf", "conf tlmgr" lub "conf updmap" pokazuje wszystkie
pary klucz/wartość (tj. wszystkie ustawienia) zapisane w „ROOT/texmf.cnf”, konfiguracja tlmgr
(patrz poniżej) lub odpowiednio pierwszego znalezionego (poprzez kpse Which) pliku „updmap.cfg”.

If klucz jest podany dodatkowo, pokazuje wartość tylko tego klucz w odpowiednim pliku. Jeśli
opcja --kasować podany jest również plik konfiguracyjny - jest usuwany, a nie tylko komentowany
na zewnątrz!

If wartość podaje się dodatkowo, klucz jest ustawione na wartość w odpowiednim pliku. Nie błąd
kontrola is Gotowe!

We wszystkich przypadkach używany plik można jawnie określić za pomocą opcji „--conffile plik",
na wypadek, gdyby ktoś chciał operować na innym pliku.

Praktyczne zastosowanie: jeśli wykonanie (niektórych lub wszystkich) poleceń systemowych za pośrednictwem „\write18”
pozostawiono włączone podczas instalacji, możesz je później wyłączyć:

tlmgr conf texmf powłoka_escape 0

Bardziej skomplikowany przykład: drzewo „TEXMFHOME” (patrz główny przewodnik TeX Live,
<http://tug.org/texlive/doc.html>) można ustawić na wiele katalogów, ale muszą być
ujęte w nawiasy klamrowe i oddzielone przecinkami, więc podanie wartości do powłoki jest dobre
pomysł. Zatem:

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

Ostrzeżenie: Ogólna funkcja jest tutaj, ale majstrowanie przy ustawieniach w ten sposób jest bardzo trudne
mocno zniechęcony. Ponownie, żadne sprawdzanie błędów w kluczach lub wartościach nie jest wykonywane, więc dowolne
możliwe jest pęknięcie.

dump-tlpdb [--lokalny|--zdalny]
Zrzuć całą lokalną lub zdalną bazę danych TLPDB na standardowe wyjście, tak jak jest. Wyjście jest analogiczne do
wyjście „--do odczytu maszynowego”; patrz rozdział „WYJŚCIE DO ODCZYTU MASZYNOWEGO”.

Opcje:

--lokalny
Zrzuć lokalny plik tlpdb.

--zdalny
Zrzuć zdalny plik tlpdb.

Należy podać dokładnie jedno z "--local" i "--remote".

W obu przypadkach pierwszy wiersz danych wyjściowych określa lokalizację repozytorium, w this
format:

"URL-lokacji" Lokalizacja "\t".

gdzie „adres URL lokalizacji” to dosłowna nazwa pola, po której następuje karta i lokalizacja jest
plik lub adres URL do repozytorium.

W zależności od aktualnej platformy, zakończenia linii mogą być LF lub CRLF.

Generować [opcja] ... co
Generować język
Generować język.dat
Generować język.def
Generować język.dat.lua

Akcja „generuj” zastępuje wszelkie ręczne zmiany wprowadzone w odpowiednich plikach: it
odtwarza je od zera w oparciu o informacje o zainstalowanych pakietach oraz lokalne
adaptacje. Instalator TeX Live i „tlmgr” rutynowo wywołują „generate” dla wszystkich z nich
akta.

Aby zarządzać własnymi czcionkami, przeczytaj informacje „updmap --help” i/lub
<http://tug.org/fonts/fontinstall.html>.

Aby zarządzać własnymi formatami, przeczytaj informacje "fmtutil --help".

Bardziej szczegółowo: „generate” przerabia dowolny plik konfiguracyjny „language.dat”,
„language.def” i „language.dat.lua” z informacji znajdujących się w lokalnym TLPDB,
plus lokalnie utrzymywane pliki.

Lokalnie obsługiwane pliki to „language-local.dat”, „language-local.def” lub
„language-local.dat.lua”, wyszukiwane w „TEXMFLOCAL” w odpowiednich katalogach. Jeśli
występują lokalne dodatki, plik końcowy tworzony jest zaczynając od pliku głównego,
pomijając wszelkie wpisy, które lokalny plik określa jako wyłączone, a na końcu dołączając
plik lokalny.

(Uwaga historyczna: poprzednio obsługiwane „updmap-local.cfg” i „fmtutil-local.cnf” nie są
dłużej czytane, ponieważ „updmap” i „fmtutil” teraz czytają i obsługują wiele konfiguracji
akta. Dlatego lokalne dodatki mogą i powinny być umieszczane w pliku „updmap.cfg” pliku „fmtutil.cnf”
plik w „TEXMFLOCAL”. Nie działają już akcje „generate updmap” i „generate fmtutil”.
istnieć.)

Pliki lokalne określają wpisy, które mają być wyłączone, za pomocą wiersza komentarza, a mianowicie jednego z poniższych:

%!NAZWA
--!NAZWA

gdzie „language.dat” i „language.def” używają „%”, a „language.dat.lua” używają „--”. We wszystkim
przypadki, te Nazwa jest odpowiednią nazwą formatu lub identyfikatorem wzorca dzielenia wyrazów.
Przykłady:

%!Niemiecki
--!użyj angielskiegomax

(Oczywiście prawdopodobnie nie będziesz chciał wyłączyć tych konkretnych elementów. Są
tylko przykłady.)

Po takiej linii wyłączającej plik lokalny może zawierać kolejny wpis dla tej samej pozycji,
jeśli wymagana jest inna definicja. Ogólnie rzecz biorąc, z wyjątkiem specjalnych linii wyłączających,
pliki lokalne mają taką samą składnię jak pliki główne.

Formularz „generuj język” odtwarza wszystkie trzy pliki „language.dat”, „language.def” i
„language.dat.lua”, podczas gdy formularze z rozszerzeniem odtwarzają tylko ten dany język
plik.

Opcje:

--cel plik wyjściowy
określa plik wyjściowy (domyślnie odpowiednia lokalizacja w "TEXMFSYSVAR"). Jeśli
„--dest” służy do „generowania języka”, służy jako nazwa bazowa, do której „.dat”
zostanie dodany do nazwy pliku wyjściowego „language.dat”, „.def” będzie
dołączony do wartości nazwy pliku wyjściowego „language.def” i „.dat.lua”
do nazwy pliku „language.dat.lua”. (Ma to na celu uniknięcie nadpisywania; if
chcesz mieć określoną nazwę dla każdego pliku wyjściowego, zalecamy dwukrotne wywołanie „tlmgr”).

--localcfg lokalny_plik_konf
określa (opcjonalne) lokalne dodatki (domyślnie do odpowiedniej lokalizacji w
„TEXMFLOKALNY”).

--rebuild-sys
mówi tlmgr, aby uruchomił niezbędne programy po ponownym wygenerowaniu plików konfiguracyjnych. Te
to: "fmtutil-sys --all" po "generate fmtutil", "fmtutil-sys --byhyphen
.../language.dat” po „generate language.dat” i „fmtutil-sys --byhyphen
.../język.def” po „wygeneruj język.def”.

Te kolejne wywołania powodują, że nowo wygenerowane pliki faktycznie zaczynają obowiązywać. Ten
nie jest wykonywane domyślnie, ponieważ te wywołania są długimi procesami i można chcieć
dokonał kilku powiązanych zmian kolejno przed wywołaniem tych programów.

Odpowiednie lokalizacje są następujące:

tex/generic/config/language.dat (i język-local.dat);
tex/generic/config/language.def (i language-local.def);
tex/generic/config/language.dat.lua (i język-local.dat.lua);

gui
Uruchom graficzny interfejs użytkownika. Widzieć GUI poniżej.

Informacje [opcja...] [kolekcje|schematy|Pkg...]
Bez argumentu wyświetla listę wszystkich pakietów dostępnych w repozytorium pakietów, poprzedzając je prefiksem
już zainstalowany z „i”.

Z jednym słowem „kolekcje” lub „schematy” jako argumentem, wyświetla typ żądania
zamiast wszystkich pakietów.

W przypadku innych argumentów wyświetl informacje o Pkg: nazwa, kategoria, skrót i
długi opis, status instalacji i numer wersji TeX Live. Jeśli Pkg nie jest
zainstalowany lokalnie, wyszukuje w źródle instalacji zdalnej.

If Pkg nie zostanie znaleziony lokalnie ani zdalnie, zostanie użyta akcja wyszukiwania i zostaną wyświetlone pasujące listy
pakiety i pliki.

Wyświetla również informacje zaczerpnięte z Katalogu TeX, a mianowicie wersję pakietu,
datę i licencję. Rozważ je, zwłaszcza wersję pakietu, jako przybliżenia
tylko z powodu przesunięcia czasowego aktualizacji różnych elementów. Dla kontrastu,
wartość „weryfikacji” pochodzi bezpośrednio z TL i jest wiarygodna.

Poprzednie akcje „pokaż” i „lista” są scalane w tę akcję, ale nadal są obsługiwane
dla kompatybilności wstecznej.

Opcje:

--lista
Jeśli z pakietem podana jest opcja "--list", lista zawartych w nim plików również jest
pokazane, w tym dla zależności specyficznych dla platformy. Gdy podano ze schematami
i kolekcje, „--list” wyświetla ich zależności w podobny sposób.

--tylko-zainstalowane
Jeśli ta opcja jest podana, źródło instalacji nie zostanie użyte; tylko lokalnie
zainstalowane pakiety, kolekcje lub schematy są wymienione. (Nie działa w przypadku listy
pakiety na razie)

init-usertree
Ustawia drzewo texmf dla tak zwanego zarządzania trybem użytkownika, albo domyślne drzewo użytkownika
(„TEXMFHOME”) lub określony w wierszu poleceń za pomocą „--usertree”. Patrz „TRYB UŻYTKOWNIKA”
poniżej.

zainstalować [opcja] ... Pkg...
Zainstaluj każdy Pkg podany w wierszu poleceń, jeśli nie jest jeszcze zainstalowany. (To nie
dotknij istniejących pakietów; zobacz akcję „aktualizacja”, aby dowiedzieć się, jak uzyskać najnowszą wersję pliku a
pakiet.)

Domyślnie instaluje to również wszystkie pakiety, na których podano Pkgsą zależne.
Opcje:

--próba
W rzeczywistości nic nie jest zainstalowane; zamiast tego akcje do wykonania są zapisywane w pliku
terminal.

--plik
Zamiast pobierać pakiet z repozytorium instalacji, użyj plików pakietu
podane w wierszu poleceń. Te pliki muszą być standardowymi plikami pakietu TeX Live (z
zawierał plik tlpobj).

--siła
Jeśli obecne są aktualizacje samego „tlmgr” (lub innych części podstawowej infrastruktury),
„tlmgr” wyskoczy i nie przeprowadzi instalacji, chyba że ta opcja zostanie podana.
Niepolecane.

--nie-zależy
Nie instaluj zależności. (Domyślnie zainstalowanie pakietu gwarantuje, że all
zależności tego pakietu są spełnione.)

--w ogóle nie zależy
Zwykle podczas instalowania pakietu, który dostarcza pliki binarne, odpowiedni plik binarny
pakiet zostanie również zainstalowany. Oznacza to, że dla pakietu „foo” pakiet
„foo.i386-linux” zostanie również zainstalowany w systemie „i386-linux”. Ta opcja
tłumi to zachowanie, a także implikuje „--no-depends”. Nie używaj go, chyba że ty
jesteś pewien tego, co robisz.

--ponowna instalacja
Ponownie zainstaluj pakiet (w tym zależności dla kolekcji), nawet jeśli już się wydaje
do zainstalowania (tj. jest obecny w TLPDB). Jest to przydatne do wyzdrowienia
przypadkowe usunięcie plików w hierarchii.

Podczas ponownej instalacji przestrzegane są tylko zależności od normalnych pakietów (tzn
kategorii Schemat lub Kolekcja).

--z-dokumentem
--z-src
Chociaż nie jest to zalecane, program „install-tl” zapewnia opcję pominięcia
instalacja całej dokumentacji i/lub plików źródłowych. (Domyślnie wszystko jest
zainstalowany.) Po takiej instalacji może się okazać, że potrzebujesz dokumentacji
lub pliki źródłowe dla danego pakietu mimo wszystko. Możesz je zdobyć, korzystając z nich
opcje w połączeniu z „--reinstall”, jak w (przy użyciu pakietu „fontspec” jako pliku
przykład):

tlmgr install --reinstall --with-doc --with-src specyfikacja czcionek

opcja
opcja [pokazywać]
opcja Pokaż wszystko
opcja klucz [wartość]

Pierwszy formularz pokazuje globalne ustawienia TeX Live aktualnie zapisane w TLPDB z a
krótki opis i "klucz" służący do jego zmiany w nawiasach.

Drugi formularz jest podobny, ale pokazuje również opcje, które można zdefiniować, ale nie są
aktualnie ustawione na dowolną wartość.

W trzeciej formie, jeśli wartość nie podano ustawienia dla klucz jest wyświetlany. Gdyby wartość is
obecny, klucz jest ustawione na wartość.

Możliwe wartości dla klucz are (uruchom „tlmgr option showall”, aby uzyskać ostateczną listę):

repozytorium (domyślne repozytorium pakietów),
formaty (tworzenie formatów w czasie instalacji),
kod pocztowy (uruchom blob kodu postinst)
docfiles (instalacja plików dokumentacji),
srcfiles (instalacja plików źródłowych),
backupdir (domyślny katalog dla kopii zapasowych),
autobackup (liczba kopii zapasowych do zachowania).
sys_bin (katalog, do którego pliki wykonywalne są łączone przez akcję path)
sys_man (katalog, do którego strony podręcznika są połączone przez akcję path)
sys_info (katalog, do którego pliki Info są połączone przez akcję path)
desktop_integration (tylko Windows: utwórz skróty do menu Start)
fileassocs (tylko Windows: zmień powiązania plików)
wielu użytkowników (tylko Windows: zainstaluj dla wszystkich użytkowników)

Jednym z powszechnych zastosowań „opcji” jest trwała zmiana instalacji, aby uzyskać więcej
aktualizacje z Internetu, po oryginalnej instalacji z DVD. Aby to zrobić, możesz biegać

Repozytorium opcji tlmgr http://mirror.ctan.org/systems/texlive/tlnet

Dokumentacja „install-tl” zawiera więcej informacji o możliwych wartościach dla
"magazyn". (W celu zapewnienia zgodności wstecznej „lokalizacja” może być używana jako alternatywna nazwa dla
"magazyn".)

Jeśli ustawiona jest opcja „formaty” (jest to ustawienie domyślne), formaty są ponownie generowane, gdy plik
silnik lub pliki formatu uległy zmianie. Wyłącz to tylko wtedy, gdy wiesz, kim jesteś
robić.

Opcja „kod pocztowy” steruje wykonaniem kodu akcji poinstalacyjnej dla każdego pakietu. To
jest ustawiony domyślnie, a wyłączenie prawdopodobnie nie będzie interesujące, z wyjątkiem być może
programistów.

Opcje „docfiles” i „srcfiles” sterują instalacją odpowiednich plików
paczki. Domyślnie oba są włączone (1). Można to wyłączyć (ustawić na 0), jeśli disk
przestrzeń jest (bardzo) ograniczona.

Opcje „autobackup” i „backupdir” określają wartości domyślne akcji „update”,
"kopia zapasowa i przywracanie". Te trzy akcje wymagają katalogu, w którym można je odczytywać lub zapisywać
kopie zapasowe. Jeśli „--backupdir” nie zostanie określone w wierszu poleceń, „backupdir”
używana jest wartość opcji (jeśli jest ustawiona).

Opcja „autobackup” (de)aktywuje automatyczne generowanie kopii zapasowych. Jego wartość to A
liczba całkowita. Jeśli wartość „autobackup” wynosi „-1”, żadne kopie zapasowe nie są usuwane. Jeśli „automatyczna kopia zapasowa” wynosi 0
lub więcej, określa liczbę przechowywanych kopii zapasowych. Dlatego kopie zapasowe są wyłączone, jeśli plik
wartość wynosi 0. W trybie „--clean” akcji „backup” ta opcja określa również
numer do zachowania.

Aby ustawić „autobackup” na „-1” w wierszu poleceń, użyj:

opcja tlmgr -- automatyczna kopia zapasowa -1

„--” pozwala uniknąć traktowania „-1” jako opcji. („--” zatrzymuje analizowanie opcji w
punkt, w którym się pojawia; jest to ogólna cecha większości programów uniksowych).

Opcje „sys_bin”, „sys_man” i „sys_info” są używane w systemach uniksopodobnych do sterowania
generowanie linków do plików wykonywalnych, plików informacyjnych i stron man. Zobacz akcję „ścieżka”.
.

Ostatnie trzy opcje kontrolują zachowanie w instalacjach systemu Windows. Jeśli
„desktop_integration” jest ustawione, to niektóre pakiety będą instalować elementy w podfolderze pliku
Menu Start dla „tlmgr gui”, dokumentacji itp. Jeśli ustawione jest „fileassocs”, plik Windows
tworzone są skojarzenia (patrz także akcja „postaction”). Wreszcie, jeśli ustawiona jest opcja „wielu użytkowników”,
zamiast tego dokonywane są adaptacje rejestru i menu dla wszystkich użytkowników w systemie
tylko bieżącego użytkownika. Wszystkie trzy opcje są domyślnie włączone.

papier
papier [a4|litera]
[xdvi|pdftex|dvips|dvipdfmx|kontekst|psutils] papier [rozmiar papieru|--lista]

Bez argumentów („papier tlmgr”) pokazuje domyślne ustawienie rozmiaru papieru dla wszystkich znanych
programy.

Z jednym argumentem (np. "tlmgr papier a4") ustawia wartość domyślną dla wszystkich znanych programów na
ten rozmiar papieru.

Z programem podanym jako pierwszy argument i bez określonego rozmiaru papieru (np. "tlmgr dvips
papier"), pokazuje domyślny rozmiar papieru dla tego programu.

Z programem podanym jako pierwszy argument i rozmiarem papieru jako ostatnim argumentem (np.
„tlmgr dvips paper a4”), ustaw domyślny dla tego programu na ten rozmiar papieru.

Z programem podanym jako pierwszy argument i "--list" jako ostatnim argumentem (np.
„tlmgr dvips paper --list”) pokazuje wszystkie prawidłowe rozmiary papieru dla tego programu. Pierwszy rozmiar
pokazany jest domyślny.

Nawiasem mówiąc, ta składnia posiadania określonej nazwy programu przed słowem kluczowym „papier” jest
niezwykłe. Jest odziedziczony po długoletnim skrypcie „texconfig”, który obsługuje inne
ustawienia konfiguracyjne niektórych programów, w szczególności „dvips”. „tlmgr” ich nie obsługuje
dodatkowe ustawienia.

ścieżka [--w32mode=użytkownik|administrator] [dodaj|usuń]
W systemie Unix po prostu dodaje lub usuwa dowiązania symboliczne dla plików binarnych, stron man i stron informacyjnych w
katalogi systemowe określone przez odpowiednie opcje (patrz opis „opcji”.
powyżej). Nie zmienia żadnych plików inicjalizacyjnych, zarówno systemowych, jak i osobistych.

W systemie Windows określana jest część rejestru, w której katalog binarny jest dodawany lub usuwany
w następujący sposób:

Jeśli użytkownik ma uprawnienia administratora, a opcja „--w32mode” nie jest podana, ustawienie
w32_multi_user określa lokalizację (tj. jeśli jest na ścieżce systemowej, w przeciwnym razie
ścieżka użytkownika zostanie zmieniona).

Jeśli użytkownik ma uprawnienia administratora i podana jest opcja „--w32mode”, ta opcja decyduje
ścieżkę do regulacji.

Jeśli użytkownik nie ma uprawnień administratora, a opcja „--w32mode” nie jest podana, a plik
ustawienie w32_multi_user jest wyłączona, ścieżka użytkownika jest zmieniana, a jeśli ustawienie
w32_multi_user jest włączony, zostanie wyświetlone ostrzeżenie, że dzwoniący nie ma wystarczających uprawnień.

Jeśli użytkownik nie ma uprawnień administratora, a podano opcję „--w32mode”, tak musi być
użytkownik a ścieżka użytkownika zostanie dostosowana. Jeśli użytkownik bez uprawnień administratora użyje tej opcji
„--w32mode admin” zostanie wyświetlone ostrzeżenie, że osoba dzwoniąca nie ma wystarczających uprawnień.

przypinanie
Akcja „przypinania” zarządza plikiem przypinania, patrz „Przypinanie” poniżej.

„pokaz przypinania”
Pokazuje aktualne dane przypinania.

„przypinanie dodatku” repo pakietglob...
Przypina pakiety pasujące do pakietglob(s) do repozytorium repo.

„przypinanie usuwania” repo pakietglob...
Wszelkie pakiety zarejestrowane w pliku przypinania pasujące do s za dane
składnica repo są usunięte.

„przypinanie usunąć repo --Wszystko"
Usuń wszystkie przypinane dane dla repozytorium repo.

Platforma lista|dodaj|usuń Platforma...
Platforma zestaw Platforma
Platforma zestaw samochód
„lista platform” zawiera listę nazw TeX Live wszystkich platform (inaczej architektur),
(„i386-linux”, ...) dostępne w repozytorium pakietów.

„Dodaj platformę” Platforma... dodaje pliki wykonywalne dla każdej danej platformy Platforma do
instalacja z repozytorium.

„Usuń platformę” Platforma... usuwa pliki wykonywalne dla każdej danej platformy Platforma
z instalacji, ale w każdym przypadku zachowuje aktualnie działającą platformę.

"zestaw platformowy" Platforma przełącza TeX Live, aby zawsze używał podanej platformy zamiast auto
wykrycie.

„platform set auto” przełącza TeX Live w tryb automatycznego wykrywania platformy.

Wykrywanie platformy jest potrzebne do wybrania odpowiednich plików binarnych „xz”, „xzdec” i „wget”.
są dostarczane z TeX Live.

„arch” jest synonimem „platformy”.

Opcje:

--próba
W rzeczywistości nic nie jest zainstalowane; zamiast tego akcje do wykonania są zapisywane w pliku
terminal.

poczta [--w32mode=użytkownik|administrator] [--fileassomode=1|2] [--wszystko] [zainstaluj|usuń]
[skrót|plik|skrypt] [Pkg] ...
Wykonaj akcję pocztową „skrót”, „plikeassoc” lub „skrypt” podany jako drugi wymagany
argument w trybie instalacji lub usuwania (który jest pierwszym wymaganym argumentem), albo dla
pakiety podane w wierszu poleceń lub dla wszystkich, jeśli podano "--all".

Jeśli opcji „--w32mode” zostanie nadana wartość „user”, wszystkie akcje zostaną tylko wykonane
w dostępnych dla użytkownika częściach rejestru/systemu plików, podczas gdy wartość „admin” wybiera
ogólnosystemowe części rejestru dla powiązań plików. Jeśli nie masz
wystarczających uprawnień, użycie „--w32mode=admin” nie powiedzie się.

„--fileassocmode” określa akcję dla powiązań plików. Jeśli jest ustawiony na 1 (tzw
domyślnie), dodawane są tylko nowe powiązania; jeśli jest ustawiony na 2, wszystkie skojarzenia są ustawione na
programów TeX Live. (Zobacz także „opcje fileassocs”.)

platforma do drukowania
Wydrukuj identyfikator TeX Live dla wykrytej platformy (sprzętu/systemu operacyjnego)
kombinację na standardowe wyjście i wyjdź. „--print-arch” jest synonimem.

usunąć [opcja] ... Pkg...
Usuń każdy Pkg określony. Usunięcie kolekcji usuwa wszystkie zależności pakietu (chyba że
Określono „--no-depends”), ale nie określono żadnych zależności kolekcji tej kolekcji.
Jednak podczas usuwania pakietu zależności nigdy nie są usuwane. Opcje:

--nie-zależy
Nie usuwaj zależnych pakietów.

--w ogóle nie zależy
Patrz powyżej pod zainstalować (i uważaj).

--siła
Domyślnie usunięcie pakietu lub kolekcji, która jest zależna od innego
gromadzenie lub schemat jest niedozwolone. Dzięki tej opcji pakiet zostanie usunięty
bezwarunkowo. Używaj ostrożnie.

Pakiet, który został usunięty przy użyciu opcji „--force”, ponieważ nadal znajduje się na liście
w zainstalowanej kolekcji lub schemacie nie zostaną zaktualizowane i zostaną wymienione jako
siłą usunięte na wyjściu tlmgr aktualizacja --lista.

--próba
W rzeczywistości nic nie jest usuwane; zamiast tego akcje do wykonania są zapisywane w pliku
terminal.

składnica
składnica podstęp
składnica podstęp ścieżka|znacznik
składnica Dodaj ścieżka [etykieta]
składnica usunąć ścieżka|znacznik
składnica zestaw ścieżka[#etykieta] [ścieżka[#etykieta] ...]
Ta akcja zarządza listą repozytoriów. Zobacz „WIELE REPOZYTORIÓW” poniżej
szczegółowe wyjaśnienia.

Pierwszy formularz („lista”) zawiera listę wszystkich skonfigurowanych repozytoriów i odpowiednich znaczników if
ustawić. Jeśli po słowie kluczowym „list” zostanie podana ścieżka, adres URL lub znacznik, zostanie to zinterpretowane jako
źródło, z którego należy zainicjować bazę danych TeX Live i wyświetla listę zawartych pakietów.
Może to być również repozytorium do tej pory nieużywane, zarówno lokalnie, jak i zdalnie. Gdyby jeden
przekaż dodatkowo „--with-platforms”, dla każdego pakietu dostępne platformy (jeśli istnieją)
też są wymienione.

Trzeci formularz („add”) dodaje repozytorium (opcjonalnie z dołączonym znacznikiem) do listy
repozytoria. Czwarty formularz („usuń”) usuwa repozytorium, albo przez pełne
ścieżka/adres URL lub według tagu. Ostatni formularz („zestaw”) ustawia listę repozytoriów na pozycje
podane w wierszu poleceń, nie zachowując poprzednich ustawień

We wszystkich przypadkach jedno z repozytoriów musi być oznaczone jako „główne”; inaczej wszystko
operacje zakończą się niepowodzeniem!

przywracać [--kat.kopii reż] [--Wszystko | Pkg [obrót silnika]]
Przywróć pakiet z wcześniej wykonanej kopii zapasowej.

Jeśli podano „--all”, spróbuj przywrócić najnowszą wersję wszystkich znalezionych kopii zapasowych pakietów
katalog kopii zapasowych.

W przeciwnym razie, jeśli nie Pkg ani obrót silnika są podane, wypisz dostępne wersje kopii zapasowych dla wszystkich
paczki. Z Pkg podane, ale nie obrót silnika, wyświetl listę wszystkich dostępnych wersji kopii zapasowych programu Pkg.

Podczas wyświetlania dostępnych pakietów tlmgr pokazuje wersję, aw nawiasach tworzenie
godzina, jeśli jest dostępna (w formacie rrrr-mm-dd hh:mm).

Jeśli (i tylko jeśli) oba Pkg i ważny numer wersji obrót silnika są określone, spróbuj przywrócić
pakiet z określonej kopii zapasowej.

Opcje:

--wszystko
Spróbuj przywrócić najnowszą wersję wszystkich kopii zapasowych pakietów znalezionych w kopii zapasowej
informator. Dodatkowe argumenty niebędące opcjami (np Pkg) niedozwolone.

--katalog_zapasowy katalog
Określ katalog, w którym mają znajdować się kopie zapasowe. Jeśli nie zostanie podana, zostanie odebrana
z ustawienia konfiguracji w TLPDB.

--próba
W rzeczywistości nic nie jest przywracane; zamiast tego akcje do wykonania są zapisywane w pliku
terminal.

--siła
Nie zadawaj pytań.

szukanie [opcja...] co
szukanie [opcja...] --plik co

szukanie [opcja...] --wszystko co

Domyślnie wyszukuj nazwy, krótkie opisy i długie opisy wszystkich lokalnie
zainstalowane pakiety dla argumentu co, interpretowane jako wyrażenie regularne (Perla).

Opcje:

--plik
Wyświetl wszystkie nazwy plików zawierające co.

--wszystko
Przeszukuj wszystko: nazwy pakietów, opisy i nazwy plików.

--światowy
Przeszukaj bazę danych TeX Live na nośniku instalacyjnym, zamiast lokalnego
instalacja.

--słowo
Ogranicz wyszukiwanie nazw pakietów i opisów (ale nie nazw plików), aby dopasować
tylko pełne słowa. Na przykład wyszukiwanie „tabeli” z tą opcją nie wyświetli wyników
pakiety zawierające słowo „tables” (chyba że zawierają również słowo „table” na
jego).

Odinstaluj
Odinstalowuje całą instalację TeX Live. Opcje:

--siła
Nie proś o potwierdzenie, usuń natychmiast.

aktualizacja [opcja] ... [Pkg] ...
Aktualizuje pakiety podane jako argumenty do najnowszej wersji dostępnej pod adresem
źródło instalacji. Albo „--all” albo przynajmniej jeden Pkg należy podać nazwę. Opcje:

--wszystko
Zaktualizuj wszystkie zainstalowane pakiety z wyjątkiem samego „tlmgr”. Tak więc, jeśli aktualizacje „tlmgr”
same są obecne, spowoduje to po prostu błąd, chyba że opcja „--force”
lub podano „--self”. (Patrz poniżej).

Oprócz aktualizacji zainstalowanych pakietów, podczas aktualizacji kolekcji
instalacja lokalna jest (domyślnie) zsynchronizowana ze stanem kolekcji na serwerze
serwer, zarówno w przypadku dodawania, jak i usuwania.

Oznacza to, że jeśli pakiet został usunięty z serwera (a więc również został
usunięty z odpowiedniej kolekcji), „tlmgr” usunie pakiet z lokalnego
instalacja. Nazywa się to ``auto-remove'' i jako takie jest ogłaszane podczas używania
opcja „--lista”. To automatyczne usuwanie można wyłączyć za pomocą opcji
"--no-auto-remove" (niezalecane, patrz opis opcji).

Analogicznie, jeśli pakiet został dodany do kolekcji na serwerze, to również
zainstalowany lokalnie, zostanie dodany do instalacji lokalnej. To się nazywa
``auto-install'' i jako takie jest ogłaszane przy użyciu opcji "--list". ten auto-
instalację można pominąć za pomocą opcji „--no-auto-install”.

Wyjątek od sprawdzania zależności kolekcji (w tym automatycznej instalacji
właśnie wspomniane pakiety) to te, które zostały ``usunięte na siłę'' przez ciebie
to nazwałeś na nich „tlmgr remove --force”. (Zobacz akcję „usuń”.
dokumentacji.) Aby ponownie zainstalować takie przymusowo usunięte pakiety, użyj
„--reinstall-wymuszone-usunięto”.

Jeśli chcesz wykluczyć niektóre pakiety z bieżącej aktualizacji, uruchom (np
link), zobacz opcję „--exclude” poniżej.

--samego siebie
Zaktualizuj sam „tlmgr” (czyli pakiety infrastruktury), jeśli są aktualizacje
obecny. W systemie Windows obejmuje to aktualizacje dostarczonego prywatnego interpretera Perla
wewnątrz TeX Live.

Jeśli ta opcja jest podana razem z "--all" lub listą pakietów, to
„tlmgr” zostanie zaktualizowany jako pierwszy, a jeśli ta aktualizacja się powiedzie, zostanie zaktualizowana nowa wersja
ponownie uruchomiony, aby dokończyć pozostałe aktualizacje.

W skrócie:

tlmgr update --self # aktualizacja tylko infrastruktury
tlmgr update --self --all # zaktualizuj infrastrukturę i wszystkie pakiety
tlmgr update --force --all # aktualizuje wszystkie pakiety, ale *nie* infrastrukturę
# ... to ostatnie na własne ryzyko, niezalecane!

--próba
W rzeczywistości nic nie jest zainstalowane; zamiast tego akcje do wykonania są zapisywane w pliku
terminal. To jest bardziej szczegółowy raport niż „--list”.

--lista [Pkg]
Zwięźle wypisz pakiety, które zostaną zaktualizowane, nowo zainstalowane lub usunięte,
właściwie niczego nie zmieniając. Jeśli podano również „--all”, wszystkie dostępne aktualizacje
są wymienione. Jeśli podano „--self”, ale nie „--all”, aktualizowane są tylko wartości krytyczne
wymienione są pakiety (tlmgr, infrastruktura texlive, perl w systemie Windows itp.). Jeśli
nie jest podane ani „--all”, ani „--self”, a ponadto nie Pkg jest podane, to „--wszystko”
zakłada się (dlatego "tlmgr update --list" jest tym samym co "tlmgr update --list --all").
Jeśli nie podano ani „--all”, ani „--self”, ale podane są określone nazwy pakietów, to te
pakiety są sprawdzane pod kątem aktualizacji.

--wykluczać Pkg
Wykluczać Pkg z procesu aktualizacji. Jeśli ta opcja zostanie podana więcej niż raz, jej
gromadzą się argumenty.

Kłótnia Pkg wyklucza zarówno pakiet Pkg sam i cała powiązana z nim platforma-
konkretne pakiety paczka.ARCH, Na przykład,

aktualizacja tlmgr --all --exclude a2ping

nie zaktualizuje „a2ping”, „a2ping.i386-linux” ani żadnego innego „a2ping”.ŁUK pakiet.

Jeśli ta opcja określa pakiet, który w innym przypadku byłby kandydatem do automatycznego
instalacja, automatyczne usuwanie lub ponowna instalacja wymuszonego usunięcia pakietu „tlmgr”
kończy pracę z komunikatem o błędzie. Wykluczenia nie są obsługiwane w takich okolicznościach.

--nie-automatyczne usuwanie [Pkg] ...
Domyślnie „tlmgr” próbuje usunąć pakiety, które zniknęły z serwera, np
opisane powyżej w punkcie „--all”. Ta opcja zapobiega takim usunięciom dla wszystkich
packages (z „--all”) lub po prostu podane Pkg nazwy. Może to prowadzić do
niespójna instalacja TeX-a, ponieważ nazwy pakietów nierzadko są zmieniane lub zastępowane
przez ich autorów. Dlatego nie jest to zalecane.

--bez automatycznej instalacji [Pkg] ...
W normalnych okolicznościach „tlmgr” zainstaluje nowe pakiety na serwerze,
jak opisano powyżej w punkcie „--all”. Ta opcja zapobiega wszelkim takim automatycznym
instalacji, albo dla wszystkich pakietów (z "--all"), albo dla danego Pkg nazwy.

Co więcej, po zakończeniu działania „tlmgr” przy użyciu this, pakiety, które by to zrobiły
zostały automatycznie zainstalowane będzie be za as siłą usunięte. Więc jeśli „foobar” jest
w takim razie jedyny nowy pakiet na serwerze

aktualizacja tlmgr --all --no-auto-install

odpowiada

aktualizacja tlmgr --wszystko
tlmgr usuń --force foobar

--reinstall-wymuszone-usunięto
W normalnych okolicznościach „tlmgr” nie zainstaluje pakietów, które zostały wymuszone
usunięte przez użytkownika; to znaczy usunięty za pomocą „remove --force” lub którego instalacja była
zabronione przez „--no-auto-install” podczas wcześniejszej aktualizacji.

Ta opcja powoduje, że „tlmgr” ignoruje wymuszone usunięcia i ponownie je instaluje
paczki. Można to wykorzystać do pełnej synchronizacji instalacji z serwerem
wyobrażenie o tym, co jest dostępne:

tlmgr update --reinstall-force-removed --all

--utworzyć kopię zapasową oraz --katalog_zapasowy katalog
Te dwie opcje kontrolują tworzenie kopii zapasowych pakietów zanim aktualizacja; To
jest kopia zapasowa pakietów aktualnie zainstalowanych. Jeśli nie podano żadnej z tych opcji,
żaden pakiet kopii zapasowej nie zostanie zapisany. Jeśli podano „--backupdir” i określa zapisywalny
katalogu, wówczas w tej lokalizacji zostanie utworzona kopia zapasowa. Jeśli podano tylko „--backup”,
następnie zostanie wykonana kopia zapasowa do katalogu ustawionego wcześniej za pomocą akcji „opcja”.
(patrz poniżej). Jeśli podano oba, zostanie utworzona kopia zapasowa do określonego katalog.

Możesz ustawić opcje za pomocą akcji „opcja”, aby automatycznie tworzyć kopie zapasowe dla wszystkich
pakietów i/lub przechowywać tylko określoną liczbę kopii zapasowych. Proszę zobaczyć "opcja"
akcja o szczegóły.

„tlmgr” zawsze tworzy tymczasową kopię zapasową podczas aktualizacji pakietów, w przypadku pobierania lub
inny błąd podczas aktualizacji. Natomiast celem tej opcji „--backup” jest
aby umożliwić zapisanie trwałej kopii zapasowej w przypadku rzeczywistej zawartość aktualizacji
powoduje problemy, np. wprowadza niezgodność.

Akcja „przywróć” wyjaśnia, jak przywrócić z kopii zapasowej.

--nie-zależy
Jeśli wywołasz aktualizację pakietu, normalnie wszystkie zależne pakiety również będą
sprawdzane pod kątem aktualizacji i aktualizowane w razie potrzeby. Ten przełącznik wyłącza to zachowanie.

--w ogóle nie zależy
Patrz powyżej pod zainstalować (i uważaj).

--siła
Wymuś aktualizację normalnych pakietów, bez aktualizacji samego „tlmgr” (chyba że „--self”
podana jest również opcja). Niepolecane.

Ponadto, niezależnie od tej opcji, nadal wykonywane jest polecenie „update --list”.

Jeśli pakiet na serwerze jest starszy niż pakiet już zainstalowany (np
wybrany serwer lustrzany jest nieaktualny), „tlmgr” nie obniża wersji. Również pakiety dot
odinstalowane platformy nie są instalowane.

„tlmgr” zapisuje kopię pliku „texlive.tlpdb” używanego do aktualizacji z przyrostkiem
reprezentujący adres URL repozytorium, jak w „tlpkg/texlive.tlpdb”.długi-ciąg-hash. Te mogą
być przydatne dla informacji rezerwowych, ale jeśli nie lubisz ich gromadzić (np
run „mirror.ctan.org” może zostać rozwiązany do nowego hosta, co spowoduje inny skrót), to jest
nieszkodliwe, aby je usunąć.

USER TRYB

„tlmgr” zapewnia ograniczony sposób, zwany „trybem użytkownika”, do zarządzania dowolnymi drzewami texmf
w taki sam sposób jak instalacja główna. Na przykład pozwala to ludziom bez zapisu
uprawnienia do lokalizacji instalacji, aby aktualizować/instalować pakiety w ich drzewie
posiadać.

„tlmgr” jest przełączany w tryb użytkownika za pomocą opcji wiersza poleceń „--usermode”. To nie
przełącza się automatycznie, ani nie ma dla niego żadnych ustawień w pliku konfiguracyjnym. Zatem to
opcja musi być jawnie podana za każdym razem, gdy tryb użytkownika ma być aktywowany.

Ten tryb „tlmgr” działa na drzewie użytkowników, domyślnie wartość „TEXMFHOME”
zmienny. Można to zmienić za pomocą opcji wiersza poleceń „--usertree”. w
dalej, kiedy mówimy o drzewie użytkowników, mamy na myśli albo „TEXMFHOME”, albo to, które zostało podane
wiersz poleceń.

Nie wszystkie akcje są dozwolone w trybie użytkownika; „tlmgr” ostrzeże Cię i nie wykona żadnego
problematyczne działania. Obecnie nieobsługiwany (i prawdopodobnie nigdy nie będzie) jest
akcja „platformowa”. Akcja „gui” nie jest obecnie obsługiwana, ale może być w przyszłości
zwolnić.

Niektóre akcje „tlmgr” nie wymagają żadnych uprawnień do zapisu i dlatego działają tak samo w trybie użytkownika
i tryb normalny. Obecnie są to: "check", "help", "list", "print-platform",
„szukaj”, „pokaż”, „wersja”.

Z drugiej strony większość działań związanych z zarządzaniem pakietami wymaga zapisu
uprawnień, a tym samym zachowywać się inaczej w trybie użytkownika, jak opisano poniżej: „zainstaluj”,
„aktualizuj”, „usuń”, „opcja”, „papier”, „generuj”, „kopia zapasowa”, „przywróć”, „odinstaluj”,
„dowiązania symboliczne”.

Przed użyciem „tlmgr” w trybie użytkownika musisz skonfigurować drzewo użytkowników za pomocą
akcja „init-usertree”. To tworzy drzewo użytkowników"/web2c" i drzewo użytkowników"/tlpkg/tlpobj" i a
minimalny drzewo użytkowników"/tlpkg/texlive.tlpdb". W tym momencie możesz powiedzieć „tlmgr”, aby zrobił
(obsługiwane) akcje, dodając opcję wiersza poleceń „--usermode”.

W trybie użytkownika plik drzewo użytkowników„/tlpkg/texlive.tlpdb” zawiera tylko te pakiety, które mają
został zainstalowany w drzewie użytkowników za pomocą „tlmgr” oraz dodatkowe opcje z
Pakiet ``virtual'' "00texlive.installation" (podobny do głównego pakietu instalacyjnego
"texlive.tlpdb").

Wszystkie akcje na pakietach w trybie użytkownika można wykonać tylko na pakietach, które są znane jako
„przemieszczalny”. Wyklucza to wszystkie pakiety zawierające pliki wykonywalne i kilka innych rdzeni
paczki. Z około 2500 pakietów znajdujących się obecnie w TeX Live zdecydowana większość to pakiety
relokowalny i może być zainstalowany w drzewie użytkowników.

Opis zmian akcji w trybie użytkownika:

Użytkownik tryb zainstalować
W trybie użytkownika akcja „instaluj” sprawdza, czy pakiet i wszystkie zależności są poprawne
przeniesiony lub już zainstalowany w instalacji systemu. Jeśli tak jest, to
rozpakowuje wszystkie kontenery do zainstalowania w drzewie użytkowników (powtarzając, to albo
„TEXMFHOME” lub wartość „--usertree”) i dodaj odpowiednie pakiety do użytkownika
„texlive.tlpdb” drzewa (tworząc go w razie potrzeby).

Obecnie instalacja kolekcji w trybie użytkownika powoduje zainstalowanie wszystkich zależnych pakietów, ale w
w przeciwieństwie do trybu normalnego, tak nie zainstalować zależne kolekcje. Na przykład w normalnym
tryb „tlmgr install collection-context” zainstalowałby „collection-basic” i inne
kolekcje w trybie użytkownika, tylko pakiety wymienione w „kolekcji-kontekst” są
zainstalowany.

Użytkownik tryb utworzyć kopię zapasową przywracać, usunąć, aktualizacja
W trybie użytkownika te akcje sprawdzają, czy wszystkie pakiety, na których mają być wykonywane działania, są zainstalowane w
drzewo użytkowników przed kontynuowaniem; w przeciwnym razie zachowują się tak samo jak w trybie normalnym.

Użytkownik tryb Generować, opcja, papier
W trybie użytkownika akcje te działają tylko na plikach konfiguracyjnych drzewa użytkowników i/lub
"texlive.tlpdb". tworzy pliki konfiguracyjne w drzewie użytkowników

KONFIGURACJA FILE DLA TLMGR

Mały podzbiór opcji wiersza poleceń można ustawić w pliku konfiguracyjnym dla „tlmgr”, który
znajduje się w „TEXMFCONFIG/tlmgr/config”. Domyślnie plik konfiguracyjny znajduje się w
"~/.texliveYYYY/texmf-config/tlmgr/config" (zastępując "RRRR" rokiem twojego TeX-a
instalacja na żywo). To jest nie „TEXMFSYSVAR”, tak aby plik był specyficzny dla jednego
użytkownika.

W tym pliku puste linie i linie zaczynające się od # są ignorowane. Wszystkie inne linie muszą
wygląda jak

klucz = wartość

gdzie dozwolone klucze to „gui-expertmode” (wartość 0 lub 1), „persistent-downloads” (wartość
0 lub 1), „auto-remove” (wartość 0 lub 1) i „gui-lang” (wartość jak w wierszu poleceń
opcja).

„persistent-downloads”, „gui-lang” i „auto-remove” odpowiadają odpowiedniemu poleceniu
opcje linii o tej samej nazwie. „gui-expertmode” przełącza między pełnym GUI i a
uproszczony GUI z tylko ważnymi i najczęściej używanymi ustawieniami.

WIELOKROTNOŚĆ REPOZYTORIA

Główne repozytorium TeX Live zawiera szeroką gamę pakietów. Niemniej dodatkowe
lokalne repozytoria mogą być przydatne do udostępniania lokalnie zainstalowanych zasobów, takich jak
zastrzeżone czcionki i style własne. Dystrybuowane są również alternatywne repozytoria pakietów
pakiety, które z jakiegokolwiek powodu nie mogą lub nie powinny być zawarte w TeX Live.

Najprostszą i najbardziej niezawodną metodą jest tymczasowe ustawienie źródła instalacji na dowolne
repozytorium (z opcjami wiersza poleceń „-repository” lub „option repozytorium”) i
wykonywać swoje operacje.

Gdy używasz wielu repozytoriów przez dłuższy czas, jednak jawnie
przełączanie się między nimi staje się niewygodne. W ten sposób można powiedzieć „tlmgr” o
dodatkowe repozytoria, których chcesz użyć. Podstawowym poleceniem jest „dodanie repozytorium tlmgr”.
Pozostała część tej sekcji wyjaśnia dalej.

W przypadku korzystania z wielu repozytoriów jedno z nich musi być ustawione jako repozytorium główne, które
dystrybuuje większość zainstalowanych pakietów. Kiedy przełączasz się z jednego repozytorium
instalacji do instalacji z wieloma repozytoriami, poprzednie jedyne repozytorium będzie
ustawić jako główne repozytorium.

Domyślnie, nawet jeśli skonfigurowanych jest wiele repozytoriów, pakiety są nadal tylko
instalowane z głównego repozytorium. Tak więc samo dodanie drugiego repozytorium nie
faktycznie umożliwiają instalację czegokolwiek z tego miejsca. Musisz też określić jakie
pakiety należy pobrać z nowego repozytorium, określając tzw.
zasady opisane dalej.

Przypinanie
Gdy pakiet „foo” jest przypięty do repozytorium, pakiet „foo” w dowolnym innym repozytorium,
nawet jeśli ma wyższy numer wersji, nie zostanie uznany za kandydata do zainstalowania.

Jak wspomniano powyżej, domyślnie wszystko jest przypięte do głównego repozytorium. Chodźmy teraz
poprzez przykład założenia drugiego repozytorium i włączenia aktualizacji pakietu
z tego.

Najpierw sprawdź, czy mamy obsługę wielu repozytoriów i czy tylko jedno jest włączone (jako
tak jest domyślnie):

Lista repozytoriów $ tlmgr
Lista repozytoriów (z tagami, jeśli są ustawione):
/var/www/norbert/tlnet

OK. Dodajmy repozytorium „tlcontrib” (jest to prawdziwe repozytorium, hostowane pod adresem
<http://tlcontrib.metatex.org>, utrzymywane przez Taco Hoekwater i in.), z tagiem
"tlcontrib":

Dodaj repozytorium $ tlmgr http://tlcontrib.metatex.org/2012 tlcontrib

Sprawdź ponownie listę repozytoriów:

Lista repozytoriów $ tlmgr
Lista repozytoriów (z tagami, jeśli są ustawione):
http://tlcontrib.metatex.org/2012 (tlcontrib)
/var/www/norbert/tlnet (główny)

Teraz określamy wpis przypinania, aby pobrać „kontekst” pakietu z „tlcontrib”:

$ tlmgr przypinanie dodaje kontekst tlcontrib

Sprawdź, czy możemy znaleźć „kontekst”:

$ tlmgr pokaż kontekst
tlmgr: repozytoria pakietów:
...
pakiet: kontekst
repozytorium: tlcontrib/26867
...

- zainstaluj „kontekst”:

Kontekst instalacyjny $ tlmgr
tlmgr: repozytoria pakietów:
...
[1/1, ??:??/??:??] instalacja: kontekst @tlcontrib [

W wynikach tutaj widać, że pakiet „context” został zainstalowany z pliku
Repozytorium „tlcontrib” (@tlcontrib).

Wreszcie, „przypinanie tlmgr” obsługuje również usuwanie niektórych lub wszystkich pakietów z danego
magazyn:

$ tlmgr przypinanie usuwa kontekst tlcontrib # usuwa tylko kontekst
$ tlmgr przypinanie usuń tlcontrib --all # nic nie zabieraj z tlcontrib

Podsumowanie akcji „przypinania tlmgr” podano powyżej.

GUI DLA TLMGR

Graficzny interfejs użytkownika dla „tlmgr” wymaga zainstalowania Perl/Tk. Dla systemu Windows
niezbędne moduły są dostarczane z TeX Live dla wszystkich innych systemów (tj. opartych na Uniksie).
Perl/Tk (jak również Perl oczywiście) musi być zainstalowany.
<http://tug.org/texlive/distro.html#perltk> zawiera listę wywołań dla niektórych dystrybucji.

Po uruchomieniu z „tlmgr gui” zostanie wyświetlony graficzny interfejs użytkownika. Główne okno
zawiera pasek menu, ekran główny i obszar stanu, na którym normalnie wyświetlane są komunikaty
wyświetlana jest konsola.

W obrębie głównego wyświetlacza znajdują się trzy główne części: obszar „Konfiguracja wyświetlacza”,
listę pakietów i przyciski akcji.

Ponadto w prawym górnym rogu pokazane jest aktualnie załadowane repozytorium; działa to również jako
przycisk i po kliknięciu spróbuje załadować domyślne repozytorium. Aby załadować inny
repozytorium, zobacz element menu „tlmgr”.

Wreszcie, obszar stanu u dołu okna zawiera dodatkowe informacje o
co się dzieje.

Główny pokaz
Wyświetlacz konfiguracja obszar

Pierwsza część głównego ekranu pozwala określić (filtrować), które pakiety są
pokazane. Domyślnie wyświetlane są wszystkie. Zmiany tutaj są odzwierciedlane od razu.

Status
Wybierz, czy chcesz pokazać wszystkie pakiety (domyślnie), tylko te zainstalowane, tylko te
nie zainstalowane lub tylko te z dostępnymi aktualizacjami.

Kategoria
Wybierz, które kategorie mają być wyświetlane: pakiety, kolekcje i/lub schematy. To są
krótko wyjaśnione w sekcji „OPIS” powyżej.

Mecz
Wybierz opakowania pasujące do określonego wzorca. Domyślnie przeszukuje oba
opisy i nazwy plików. Możesz także wybrać podzbiór do wyszukiwania.

Wybór
Wybierz pakiety do wybranych, niewybranych lub wszystkich. Tutaj, ``wybrany''
oznacza, że ​​checkbox na początku wiersza paczki jest zaznaczony.

Wyświetl przyciski konfiguracji
Po prawej stronie znajdują się trzy przyciski: wybierz wszystkie pakiety, wybierz żaden (aka
odznacz wszystko) i zresetuj wszystkie te filtry do wartości domyślnych, tj. pokaż wszystkie dostępne.

Pakiet podstęp obszar

Drugi z głównych ekranów zawiera listę wszystkich zainstalowanych pakietów. Jeśli jest repozytorium
załadowane, wymienione są również te, które są dostępne, ale nie są zainstalowane.

Podwójne kliknięcie linii paczki powoduje wyświetlenie okna informacyjnego z dalszymi szczegółami:
długi opis, dołączone pliki itp.

Każdy wiersz listy pakietów składa się z następujących elementów:

pole wyboru
Służy do wybierania poszczególnych pakietów; działają tylko niektóre przyciski akcji (patrz poniżej).
na wybrane pakiety.

nazwa pakietu
Nazwa (identyfikator) paczki taka, jak podana w bazie danych.

wersja lokalna (i wersja)
Jeśli pakiet jest zainstalowany, numer wersji TeX Live zainstalowanego pakietu
będzie pokazane. Jeśli w bazie danych jest do tego podana wersja katalogu
pakietu, zostanie to pokazane w nawiasach. Jednak wersja katalogowa, w przeciwieństwie do
Wersja TL nie gwarantuje odzwierciedlenia faktycznej instalacji.

wersja zdalna (i wersja)
Jeśli repozytorium zostało załadowane, wersja pakietu w repozytorium (if
obecny) jest pokazany. Podobnie jak w przypadku kolumny lokalnej, jeśli dostarczona jest wersja katalogu
zostanie wyświetlone. Podobnie jak w przypadku lokalnej kolumny, wersja katalogu może być
nieświeży.

krótki opis
Krótki opis pakietu.

Główny pokaz akcja guziki

Poniżej listy pakietów znajduje się kilka przycisków:

Zaktualizuj wszystkie zainstalowane
To wywołuje "tlmgr update --all", tzn. próbuje zaktualizować wszystkie dostępne pakiety. Poniżej
ten przycisk jest przełącznikiem umożliwiającym ponowną instalację wcześniej usuniętych pakietów w ramach części
tej akcji.

Pozostałe cztery przyciski działają tylko na wybranych pakietach, tj. takich, w których
pole wyboru na początku wiersza paczki jest zaznaczone.

Aktualizacja
Aktualizuj tylko wybrane pakiety.

Zainstalować
Zainstaluj wybrane pakiety; działa jak „tlmgr install”, tj. również instaluje
zależności. W ten sposób instalacja kolekcji powoduje zainstalowanie wszystkich jej pakietów składowych.

Usunąć
Usuwa wybrane pakiety; działa jak „tlmgr remove”, tj. również usunie
zależności kolekcji (ale nie zależności zwykłych pakietów).

backup
Tworzy kopię zapasową wybranych pakietów; działa jak „kopia zapasowa tlmgr”. Ta akcja wymaga
ustaw opcję "backupdir" (patrz "Opcje -" Ogólne>).

Menu bar
Na pasku menu można znaleźć następujące pozycje:

menu „tlmgr”.
Elementy tutaj ładują różne repozytoria: domyślne, jak określono w TeX Live
baza danych, domyślne repozytorium sieciowe, repozytorium określone w wierszu poleceń
(jeśli istnieje) i arbitralnie wprowadzony ręcznie. Ma również tak niezbędne „wyjdź”
operacji.

„menu opcji”
Zapewnia dostęp do kilku grup opcji: „Papier” (konfiguracja domyślnego papieru
rozmiary), „Platformy” (tylko w systemie Unix, konfiguracja obsługiwanych/zainstalowanych
platformy), „Język GUI” (wybierz język używany w interfejsie GUI) i „Ogólne”
(wszystko inne).

Znajduje się tu również kilka przełączników. Pierwszym z nich są „Opcje eksperta”, które są ustawiane przez
domyślny. Jeśli to wyłączysz, przy następnym uruchomieniu GUI pojawi się uproszczony ekran
zostaną pokazane, które wyświetlają tylko najważniejsze funkcje. To ustawienie jest
zapisane w pliku konfiguracyjnym „tlmgr”; patrz „PLIK KONFIGURACYJNY DLA TLMGR”.
detale.

Pozostałe przełączniki są domyślnie wyłączone: do debugowania danych wyjściowych, aby wyłączyć
automatyczną instalację nowych pakietów oraz wyłączenie automatycznego usuwania
pakiety usunięte z serwera. Zabawa wyborem tego, co jest, a co nie
zainstalowany może prowadzić do niespójnej instalacji TeX Live; np. gdy pakiet jest
zmieniono nazwę.

„Menu działań”
Zapewnia dostęp do kilku akcji: aktualizacja bazy danych nazw plików (inaczej „ls-R”,
„mktexlsr”, „texhash”), odbuduj wszystkie formaty („fmtutil-sys --all”), zaktualizuj mapę czcionek
bazy danych („updmap-sys”), przywracanie z kopii zapasowej pakietu i korzystanie z dowiązań symbolicznych
w katalogach systemowych (nie w systemie Windows).

Ostatnią czynnością jest usunięcie całej instalacji TeX Live (również nie w systemie Windows).

„Menu pomocy”
Zapewnia dostęp do podręcznika TeX Live (również w Internecie pod adresem
<http://tug.org/texlive/doc.html>) i zwykłe pole ``Informacje''.

DO ODCZYTU MASZYNOWEGO WYDAJNOŚĆ

Z opcją „--machine-readable”, „tlmgr” zapisuje na standardowe wyjście w trybie zorientowanym na linię stałą
opisanym tutaj formacie oraz zwykłymi komunikatami informacyjnymi do spożycia przez ludzi
zapisywane na stderr (zwykle są zapisywane na stdout). Chodzi o to, że program może
uzyskaj wszystkie potrzebne informacje, czytając stdout.

Obecnie ta opcja dotyczy tylko akcji aktualizacji, instalacji i opcji.

Do odczytu maszynowego "aktualizacja" oraz "zainstalować" wydajność
Format wyjściowy jest następujący:

nazwa pola Wartość „\t”.
...
„koniec nagłówka”
pkgname status localrev serverrev rozmiar środowiska uruchomieniowego esttot
...
„koniec aktualizacji”
inne dane wyjściowe z akcji pocztowych, które nie są w formie czytelnej dla komputera

Sekcja nagłówka ma obecnie dwa pola: „location-url” (źródło repozytorium z
które aktualizacje są pobierane) i „total-bytes” (całkowita liczba bajtów do pobrania
pobrane).

wersja lokalna oraz serwerrev pola dla każdego pakietu to numery wersji w pliku local
odpowiednio repozytorium instalacji i serwera. The rozmiar pole to liczba bajtów
do pobrania, czyli rozmiar skompresowanego pliku tar dla instalacji sieciowej,
nie rozpakowany rozmiar. Pola runtime i esttot są obecne tylko dla zaktualizowanych i
pakiety automatycznej instalacji i zawierają czas, który upłynął od rozpoczęcia
instalacji/aktualizacji oraz szacowany całkowity czas.

W zależności od aktualnej platformy, zakończenia linii mogą być LF lub CRLF.

"url lokalizacji" lokalizacja
lokalizacja może być adresem URL (w tym „file:///foo/bar/…”) lub nazwą katalogu
("/foo/bar"). Jest to repozytorium pakietów, z którego pochodzą informacje o nowych pakietach
pociągnięty.

„całkowita liczba bajtów” liczyć
liczyć to po prostu liczba dziesiętna, suma rozmiarów wszystkich pakietów
wymagają aktualizacji lub instalacji (które są wymienione poniżej).

Następnie pojawia się linia zawierająca tylko dosłowny ciąg „end-of-header”.

Każda następna linia, aż do linii z dosłownym ciągiem „end-of-updates” informuje o jednym
pakiet. Pola w każdym wierszu są oddzielone tabulatorem. Oto pola.

nazwapakietu
Identyfikator pakietu TeX Live z możliwym sufiksem platformy dla plików wykonywalnych. Dla
na przykład „pdftex” i „pdftex.i386-linux” są dostarczane jako dwa oddzielne pakiety, jeden na
każda linia.

status
Stan aktualizacji pakietu. Jeden znak, jak następuje:

„d” Pakiet został usunięty z serwera.

„f” Pakiet został usunięty z instalacji lokalnej, mimo że jest to kolekcja
zależało od tego. (Np. użytkownik uruchomił „tlmgr remove --force”.)

„u” Potrzebna jest normalna aktualizacja.

„r” Odwrócony brak aktualizacji: wersja zainstalowana lokalnie jest nowsza niż wersja
na serwerze.

"a" Automatycznie określona potrzeba instalacji, pakiet jest nowy na
server i jest (najprawdopodobniej) częścią zainstalowanej kolekcji.

Pakiet „i” zostanie zainstalowany i nie jest obecny w instalacji lokalnej (action
zainstalować).

Pakiet „I” jest już obecny, ale zostanie ponownie zainstalowany (akcja instalacji).

wersja lokalna
Numer wersji zainstalowanego pakietu lub „-”, jeśli nie jest obecny lokalnie.

serwerrev
Numer wersji pakietu na serwerze lub „-”, jeśli go nie ma na serwerze
serwer.

rozmiar
Rozmiar w bajtach pakietu na serwerze. Suma wszystkich rozmiarów opakowań wynosi
podany we wspomnianym powyżej polu nagłówka „total-bytes”.

Czas
Czas działania od rozpoczęcia instalacji lub aktualizacji.

estot
Szacowany całkowity czas.

Do odczytu maszynowego "opcja" wydajność
Format wyjściowy jest następujący:

wartość klucza „\t”.

Jeśli wartość nie jest zapisana w bazie danych, wyświetlany jest napis „(not set)”.

Jeśli tworzysz program korzystający z tego wyjścia i stwierdzisz, że zmiany będą
pomocny, nie wahaj się napisać listy mailingowej.

AUTORSKI ROLNICZE PRAWA AUTORSKIE

Ten skrypt i jego dokumentacja zostały napisane dla dystrybucji TeX Live
(<http://tug.org/texlive>) i oba są objęte licencją GNU General Public License
Wersja 2 lub nowsza.

Korzystaj z tlmgr online, korzystając z usług onworks.net