## TeX Live 2024
Příručka TeX Live, CS verze 1.73

Karl Berry, editor
https://tug.org/texlive/
24. března 2024

Překlad 2004–2024 Ján Buša, 2001 Janka Chlebíková, 2003–2024 Petr Sojka a 2003 Petra Sojková je šířen pod GNU FDL licencí.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.

### Obsah

1 Úvodem
1.1 TeX Live a kolekce TeXu
1.2 Podpora operačních systémů
1.3 Základní instalace TeX Live
1.4 Úvahy o bezpečnosti
1.5 Nápověda
2 Přehled TeXLive
2.1 Kolekce TeXu: TeX Live, MacTeX, MikTeX, CTAN
2.2 Popis kořenových adresářů TeX Live
2.3 Přehled předdeﬁnovaných stromů texmf
2.4 Rozšíření TeXu
2.5 Další za zmínku stojící programy na TeX Live
3 Instalace
3.1 Spuštění instalačního programu
3.2 Spuštění instalačního programu
3.3 Volby příkazového řádku pro install-tl
3.4 Poinstalační činnosti
3.5 Testování instalace
3.6 Odinstalování TeX Live
3.7 Odkazy na doplňkový software s možností stažení z internetu
4 Specializované instalace
4.1 Instalace sdílené uživateli
4.2 Mobilní USB instalace
5 tlmgr: správa vaší instalace
5.1 Rozhraní GUI pro tlmgr
5.2 Vzorové realizace tlmgr z příkazového řádku
6 Poznámky k Windows
6.1 Vlastnosti typické pro Windows
6.2 Dodatečný obsažený software pod Windows
6.3 Použití externích instalací Perlu, Tcl/Tk a Ghostscriptu
6.4 User Proﬁle je Home
6.5 Registry Windows
6.6 Oprávnění Windows
6.7 Zvětšení maxima paměti pod Windows a Cygwin
7 Používateľská príručka ku systému Web2C
7.1 Vyhľadávanie ciest knižnicou Kpathsea
7.2 Databázy názvov súborov
7.3 Možnosti nastavenia za behu programu
7.4 $TEXMFDOTDIR
8 Poděkování
9 Historie vydání
9.1 Minulost
9.2 2020
9.3 Současnost: 2024
9.4 Budoucnost

### 1 Úvodem

#### 1.1 TeX Live a kolekce TeXu

Tento dokument popisuje základní vlastnosti distribuce TeX Live 2024, což je instalace TeXu a příbuzných programů pro GNU/Linux a další unixové systémy, macOS a systémy Windows.

TeX Live můžete získat stažením z internetu nebo na TeX-kolekce DVD. Některé skupiny uživatelů TeXu distribuují DVD svým členům. Obsah DVD je stručně popsán v oddíle 2.1. TeX Live a TeX-kolekce spolu jsou výsledkem společného úsilí skupin uživatelů TeXu. Tento dokument popisuje převážně samotný TeX Live.

TeX Live obsahuje .exe soubory pro TeX, LaTeX2e, ConTeXt, Metafont, MetaPost, BibTeX a mnoho dalších programů včetně obsáhlého seznamu maker, fontů a dokumentace spolu s podporou sazby v mnoha různých světových jazycích.

Krátký seznam hlavních změn v této verzi TeX Live najdete na konci tohoto dokumentu, v oddílu 9.

#### 1.2 Podpora operačních systémů

TeX Live obsahuje binárky pro mnohé unixové platformy včetně GNU/Linux, macOS a Cygwin. Obsažené zdrojové texty mohou být zkompilovány pro platformy, pro které neposkytujeme binárky.

Co se týče Windows: podporovány jsou Windows 7 a pozdější verze. Windows Vista a 2000 ještě bude pravděpodobně z větší části fungovat, ale TeX Live se dokonce nenainstaluje pod Windows XP a dřívějšími. TeX Live zahrnuje 64bitové binárky pro Windows.

Alternativní řešení pro Windows a macOS najdete v oddíle 2.1.

#### 1.3 Základní instalace TeX Live

TeX Live můžete nainstalovat buď z DVD nebo z internetu ( https://tug.org/texlive/acquire.html). Samotný síťový instalační program je malý a vše požadované stáhne z internetu.

Instalační program na DVD vám umožní instalaci na lokálním disku, ale TeX Live nemůžete spustit přímo z TeX Collection DVD (nebo z TeX Collection nebo TeX Live .iso obrazů), avšak můžete připravit spustitelnou instalaci, například na klíči USB (viz oddíl 4.2). Instalace je popsána v následujících sekcích (na stránce 14), zde jen souhrn:

- Instalační dávka pro Unix se jmenuje install-tl; na Windows byste místo toho měli vyvolat install-tl-windows. Instalační program bude pracovat v graﬁckém režimu při volbě -gui (výchozí pro Windows) nebo v textovém režimu při zadání volby -gui=text (výchozí pro všechny ostatní).

- Součástí instalace je program ,TeX Live Manager‘, nazvaný tlmgr. Podobně jako instalační program může být použit v režimu GUI nebo v textovém režimu. Můžete ho použít k nainstalování nebo odinstalování balíků a na různé konﬁgurační činnosti.

#### 1.4 Úvahy o bezpečnosti

Pokud je nám známo, hlavní programy TeXu jsou (a vždy byly) extrémně robustní. Nicméně programy dodané v rámci TeX Live nemusí dosahovat stejné úrovně, navzdory nejlepšímu úsilí všech. Jako vždy při použití programů pro nedůvěryhodný vstup musíte být opatrní; pro zvýšení bezpečnosti použijte nový podadresář nebo ,chroot‘.

Tato potřeba opatrnosti je zvláště naléhavá pro Windows, protože Windows obvykle najdou programy v aktuálním adresáři před jinými, bez ohledu na cestu vyhledávaní. To otevírá široké varianty možných útoků. Zavřeli jsme mnoho děr, ale nepochybně některé zůstaly, obzvláště pro programy pocházející odjinud. Proto doporučujeme zkontrolovat podezřelé programy v aktuálním adresáři, zvláště ty spustitelné (binárky nebo skripty). Běžně by neměly být přítomny a rozhodně nemohou být normálně vytvořeny při zpracování dokumentů.

TeX (a jeho doprovodné programy) jsou schopny při běhu zapisovat do souborů. Tato schopnost může rovněž být zneužita mnohými způsoby. Zpracování neznámých dokumentů v novém podadresáři je nejbezpečnější tip.

Dalším aspektem zabezpečení je zajištění toho, že stažený materiál nebyl od vytvoření změněn. Program tlmgr (sekce 5) automaticky provede kryptograﬁcké ověření stahování, pokud je program gpg (GNU Privacy Guard) k dispozici. Není distribuován jako součást TeX Live, ale vizte https://texlive.info/tlgpg/ pro informace o gpg, pokud je potřebný.

#### 1.5 Nápověda

TeXovská komunita je aktivní, vstřícná a většina seriózních otázek je obvykle zodpovězena. Podpora je neformální, je prováděna příležitostnými uživateli a dobrovolníky, a proto je důležité, abyste odpověď na svůj dotaz hledali nejdříve sami než ho vznesete na fóru. Pokud toužíte po garantované komerční podpoře, můžete na TeX Live zapomenout a zakoupit si komerční distribuci od prodejců na https://tug.org/interest.html#vendors.

Níže je uveden seznam informačních zdrojů, přibližně v pořadí, ve kterém ho doporučujeme k použití:

první kroky

  Pokud jste TeXovský nováček, na stránce https://tug.org/begin.html najdete krátký úvod do systému.

CTAN

  Pokud hledáte konkrétní balík, font, program ap., CTAN je místo, kde začít. Je to obsáhlá sbírka všech TeXových položek. Katalogové záznamy vám také říkají, zda je balíček dostupný pro TeX Live nebo MiKTeX. Viz https://ctan.org.

TeX FAQ

  TeX FAQ je studnice znalostí obsahující všechny druhy otázek, od těch základních až po ty nejobskurnější. Dokument najdete na stránce https://texfaq.org.

TeXové odkazy na Webu

  Na https://tug.org/interest.html najdete mnoho relevantních odkazů na různé příručky, knihy, manuály a články o všech aspektech systému TeX.

archivy diskusních skupin

  Obecné vyhledávání na webu nikdy neuškodí. Základní fóra pro hledání řešení problémů TeXu zahrnují stránku LaTeXovské komunity https://latex.org, stránku kolektivně editovaných dotazů a odpovědí https://tex.stackexchange.com, a e-mailovou diskusní skupinu texhax@tug. org. V archivech těchto zdrojů najdete tisíce předchozích dotazů a odpovědí z minulých let pro vaše potěšení z hledání. Pro speciﬁka češtiny a slovenštiny najdete další zdroje odkazované na http://www.cstug.cz/.

kladení dotazů

  Pokud nemůžete najít odpověď na svou otázku, můžete ji položit na http://latex.org/ a https://tex.stackexchange.com/ prostřednictvím jejich webových rozhraní, nebo e-mailem na texhax@tug.org (k odeslání není nutné se přihlásit). Ale dříve, než tak učiníte, prosím, přečtěte si toto heslo FAQ, abyste maximalizovali vyhlídky na získání užitečné odpovědi: https://texfaq.org/FAQ-askquestion.

podpora TeX Live

  Pokud chcete poslat chybové hlášení, připomínku nebo poznámku k distribuci TeX Live, její instalaci nebo dokumentaci, diskusní skupina k tomu určená je tex-live@tug.org. Pokud však je vaše otázka speciﬁcká pro program na TeX Live umístěný, napište prosím přímo autorovi nebo do diskusní skupiny určené pro tento program. Spuštění programu s volbou --help nezřídka poskytuje adresu pro zasílání chybových hlášení.

Druhou stranou mince je odpovídání na dotazy těch, kteří kladou otázky. Všechny výše uvedené zdroje jsou otevřeny pro kohokoliv. Přihlaste se, čtěte a začněte odpovídat tam, kde můžete.

### 2 Přehled TeXLive

Tento oddíl popisuje obsah TeX Live stejně jako TeX-kolekce, jejíž je částí.

#### 2.1 Kolekce TeXu: TeX Live, MacTeX, MikTeX, CTAN

DVD TeX-kolekce zahrnuje následující:

TeX Live

  Obsáhlý multiplatformní systém TeX, k nainstalování na disk. Domovská stránka: https://tug.org/texlive/.

MacTeX

  pro macOS, přidává nativní instalační program macOS a jiné aplikace Mac k TeX Live. Domovská stránka: https://tug.org/mactex/.

MiKTeX

  Další obsáhlá multiplatformní distribuce TeXu pro Windows, GNU/Linux a macOS (ale pouze binární soubory Windows jsou zahrnuty na DVD). Má integrovaného správce balíčků, který podle potřeby nainstaluje chybějící součásti z internetu. Domovská stránka: https://miktex.org/.

CTAN

  Výpis obrazovky archivu CTAN ( https://ctan.org). CTAN nemá stejné podmínky pro kopírování jako TeX Live, proto buďte pozorní při šíření nebo modiﬁkaci.

#### 2.2 Popis kořenových adresářů TeX Live

Zde uvádíme stručný seznam a popis kořenových adresářů instalace TeX Live.

bin

  Binárky systému TeX, s podadresáři dle platforem.

readme-*.dir

  Stručný přehled a užitečné odkazy na TeX Live, v různých jazycích, ve formátu HTML a textovém.

source

  Zdrojové kódy všech programů, včetně základní distribuce TeXu založené na Web2C.

texmf-dist

  Hlavní strom, viz TEXMFDIST níže.

tlpkg

  Skripty, programy a údaje pro správu instalace a přídavnou podporu pro Windows.

Co se týče dokumentace, užitečné mohou být obsáhlé odkazy v kořenovém souboru doc.html. Dokumentace téměř všeho (balíků, formátů, manuálů, man-stránek, info-souborů) je v texmf-dist/doc. K vyhledání dokumentace na libovolném místě můžete použít programy texdoc nebo texdoctk.

Samotná tato příručka TeX Live je k dispozici v několika jazycích v adresáři texmf-dist/doc/texlive:

- anglická: texmf-dist/doc/texlive/texlive-en

- česko-slovenská: texmf-dist/doc/texlive/texlive-cz

- francouzská: texmf-dist/doc/texlive/texlive-fr

- italská: texmf-dist/doc/texlive/texlive-it

- japonská: texmf-dist/doc/texlive/texlive-ja

- německá: texmf-dist/doc/texlive/texlive-de

- polská: texmf-dist/doc/texlive/texlive-pl

- ruská: texmf-dist/doc/texlive/texlive-ru

- srbská: texmf-dist/doc/texlive/texlive-sr

- španělská: texmf-dist/doc/texlive/texlive-es

- zjednodušená čínština: texmf-dist/doc/texlive/texlive-zh-cn

#### 2.3 Přehled předdeﬁnovaných stromů texmf

Tento oddíl uvádí seznam předdeﬁnovaných proměnných určujících texmf stromy používané systémem, a jejich zamýšlený účel ve standardním uspořádání systému TeX Live. Povel tlmgr conf ukáže hodnoty těchto proměnných. Můžete tak jednoduše zjistit zda a jak tyto hodnoty odpovídají nastavení jednotlivých adresářů ve vaší instalaci.

Všechny stromy, včetně osobních, musí dodržovat strukturu adresářů TeX Directory Structure (TDS, https://tug.org/tds), s jejími nesčetnými podadresáři, jinak soubory nebudou k nalezení. Podrobněji je to popsáno v oddíle 3.4.6 (na straně 49). Pořadí zde je opačné vůči pořadí, ve kterém se stromy prohledávají, tj. pozdější stromy v seznamu přepíšou předcházející.

TEXMFDIST

  Strom obsahující téměř všechny soubory původní distribuce – konﬁgurační soubory, pomocné skripty, balíky maker, fonty atd. Hlavní výjimky tvoří binárky závislé na platformách, které jsou uloženy v sourozeneckém adresáři bin/ .

TEXMFSYSVAR

  Strom (uživateli v instalaci sdílený) používaný programy texconfig-sys, updmap-sys, fmtutil-sys a tlmgr, na (cache) uložení runtime údajů, jako jsou soubory formátů a generované .map soubory.

TEXMFSYSCONFIG

  Strom (uživateli v instalaci sdílený) používaný texconfig-sys, updmap-sys a fmtutil-sys na uložení modiﬁkovaných konﬁguračních údajů.

TEXMFLOCAL

  Strom, který mohou použít administrátoři na instalaci doplňkových nebo upravených maker, fontů atd. pro celý systém.

TEXMFHOME

  Strom, který mohou použít uživatelé na svoje osobní doplňková nebo upravená makra, fonty atd. Tato proměnná pro každého uživatele ukazuje na jeho vlastní osobní adresář.

TEXMFVAR

  Strom (soukromý) používaný programy texconfig, updmap-user a fmtutil-user na (cache) uložení runtime údajů, jako jsou soubory formátů a generované .map soubory.

TEXMFCONFIG

  Strom (soukromý) používaný nástroji texconfig, updmap-sys a fmtutil-sys na uložení modiﬁkovaných konﬁguračních údajů.

TEXMFCACHE

  Strom(y) používaný ConTeXtextem MkIV a LuaLaTeXem na uložení (cache) runtime údajů; implicitně do TEXMFSYSVAR, nebo (pokud tento neumožňuje zápis) TEXMFVAR.

Standardní struktura je:

system-wide root

  může obsáhnout vícenásobné vydání TeX Live (/usr/local/texlive ve výchozím nastavení pro Unix):

  2023

    Předchozí vydání.

  2024

    Aktuální vydání.

    bin

      i386-linux

        binárky systému GNU/Linux (32-bitové)

      ...

      x86_64-darwin

        binárky systému macOS

      x86_64-linux

        binárky systému GNU/Linux (64-bitové)

      windows

        binárky systému Windows (64bitové)

    texmf-dist

      TEXMFDIST a TEXMFMAIN

    texmf-var

      TEXMFSYSVAR, TEXMFCACHE

    texmf-config

      TEXMFSYSCONFIG

  texmf-local

    TEXMFLOCAL, zamýšlený k zachování od vydání k vydání.

domovský adresář uživatele

  ($HOME nebo %USERPROFILE%)

  .texlive2023

    Soukromě generované a konﬁgurační údaje předchozího vydání.

  .texlive2024

    Soukromě generované a konﬁgurační údaje aktuálního vydání.

    texmf-var

      TEXMFVAR, TEXMFCACHE

    texmf-config

      TEXMFCONFIG

  texmf

    TEXMFHOME Osobní makra atd.

#### 2.4 Rozšíření TeXu

Samotný Knuthův původní TeX je zmrazený, kromě ojedinělých oprav chyb. Je v TeX Live přítomen jako program tex a tak to zůstane v dohledné budoucnosti. TeX Live obsahuje též několik rozšířených verzí TeXu (známé také jako TeXovské stroje):

e-TeX

  přidává množinu nových příkazů (nazývaných TeXové primitivy). Nové příkazy se týkají například makroexpanze, načítání znaků, tříd značek (marks), rozšířených ladicích možností a rozšíření TeX--XE T pro obousměrnou sazbu. Implicitně je e-TeX 100% kompatibilní se standardním TeXem. Viz texmf-dist/doc/etex/base/etex_man.pdf.

pdfTeX

  vybudován na rozšířeních e-TeXu přidává podporu zápisu ve formátu PDF stejně jako v DVI a četná rozšíření netýkající se výstupu. Tento program je používán pro mnoho běžných formátů, například, etex, latex, pdﬂatex. Jeho stránka je https://www.pdftex.org/. Viz návod texmf-dist/doc/pdftex/manual/pdftex-a.pdf a texmf-dist/doc/pdftex/samplepdftex/samplepdf.tex pro vzorové použití některých jeho vlastností.

LuaTeX

  přidává podporu pro vstup Unicode a OpenType/TrueType a systémová písma. Zahrnuje také interpret Lua ( https://lua.org/), umožňujícího řešení mnoha ožehavých TeXovských problémů. Volaný povelem texlua funguje jako samostatný interpret Lua. Jeho web je http://www.luatex.org/ a referenční příručka je texmf-dist/doc/luatex/base/luatex.pdf.

(e)(u)pTeX

  má nativní podporu pro požadavky japonské sazby; pTeX je základní sázecí program, zatímco e- varianty přidávají funkce e-TeX a u- přidává podporu Unicode.

XeTeX

  přidává podporu vstupního kódování Unicode a OpenType/TrueType a systémových fontů, implementovaných zejména použitím knihoven třetích stran, srv. https://tug.org/xetex.

Omega (Omega)

  je založena na Unicode. Umožňuje sázet v téměř všech světových jazycích zároveň. Dociluje toho tzv. překladovými procesy (Omega Translation Processes, OTP) pro realizaci složitých transformací na jakémkoliv vstupu. Omega už není součástí TeX Live jako samostatný program; poskytnutý je jenom Aleph:

Aleph

  kombinuje rozšíření Omega a e-TeX. Viz texmf-dist/doc/aleph/base.

#### 2.5 Další za zmínku stojící programy na TeX Live

Na TeX Live najdete několik často používaných programů:

bibtex, biber

  podpora práce se seznamem literatury.

makeindex, upmendex, xindex, xindy

  vytváření rejstříku. Pro češtinu a slovenštinu však potřebujete verzi programu s názvem csindex. Program zatím není součástí distribuce, je potřeba instalovat zvlášť z https://www.ctan.org/pkg/csindex.

dvips

  pro konverzi DVI do PostScript.

dvipdfmx

  konvertor DVI do PDF, alternativní přístup vedle pdfTeXu zmíněného výše.

xdvi

  prohlížeč DVI pro systém X Window.

dviconcat, dviselect

  pro kopii a vkládání stránek do/z DVI souborů.

psselect, psnup, …

  programy pro práci s PostScriptem.

pdfjam, pdfjoin, …

  pomůcky pro PDF.

context, mtxrun

  ConTeXt a PDF procesor.

htlatex, …

  tex4ht: konvertor (LA )TeX do HTML (a XML, DocX a dalších formátů).

### 3 Instalace

#### 3.1 Spuštění instalačního programu

Pro začátek si obstarejte TeX Collection DVD nebo si stáhněte síťový instalační program TeX Live. Na https://tug.org/texlive/acquire.html najdete více informací a další způsoby získání softwaru.

Síťový instalátor, .zip nebo .tar.gz:

  stáhněte si archiv z CTANu, z adresáře systems/texlive/tlnet; url https://mirror.ctan.org/systems/texlive/tlnet by Vás měl přesměrovat na blízký, aktuální mirror. Můžete získat install-tl.zip, který může být použit pod Unixem a Windows, nebo jenom pro Unix podstatně menší install-unx.tar.gz. Po rozbalení se install-tl a install-tl-windows.bat objeví v podadresáři install-tl.

Síťový .exe instalátor pod Windows:

  stáhněte z CTANu, jak uvedeno výše. Dvojklikem spustíte prvotní instalátor a rozbalovač, jak vidíte na obrázku 1. Objeví se dvě volby: „Install“ a „Unpack only“.

DVD TeX kolekce:

  vejděte do podadresáře DVD texlive. Pod Windows by se instalátor mohl spustit automaticky po vložení DVD, pokud to není z bezpečnostních důvodů zakázané, jinak musíte instalaci spustit ručně. DVD můžete získat, když se stanete členem skupiny uživatelů TeXu (vřele doporučujeme CS TUG, https://tug.org/usergroups.html), nebo si ho zvlášť zakoupíte ( https://tug.org/store). Můžete si vypálit svoje vlastní DVD z ISO obrazu staženého z CTANu, https://tug.org/texlive/acquire.html. Ve většině systémů můžete ISO namontovat přímo. Jestliže máte po instalaci z DVD nebo ISO zájem o pokračující aktualizace z Internetu, nahlédněte, prosím, do oddílu 3.4.3.

Obrázek 1: První fáze instalátoru .exe pod Windows. Stisknutím tlačítka Instalovat získáte okno zobrazené na obrázku 3.

Nezávisle na zdroji se spouští tentýž instalátor. Nejvíc znatelný rozdíl mezi oběma možnostmi je ten, že po skončení instalace z Internetu získáte balíky, které jsou v současné době k dispozici. To je v protikladu k DVD a ISO obrazům, které se mezi významnějšími vydáními neaktualizují.

Pokud potřebujete stahovat přes proxy server, použijte soubor ~/.wgetrc nebo proměnné prostředí s nastavením proxy pro Wget ( https://www.gnu.org/software/wget/manual/html_node/Proxies.html), nebo ekvivalent za cokoli, stáhněte program, který používáte. Samozřejmě se to netýká instalace z DVD nebo z ISO obrazu.

Následující oddíly vysvětlují spuštění instalátoru podrobněji.

##### 3.1.1 Unix

Dále > označuje výzvu (prompt shellu); vstup uživatele je zvýrazněn. Program install-tl je skript v jazyce Perl. Nejjednodušší způsob jeho spuštění v unixovém systému je následující:

> perl /path/to/installer/install-tl
(Nebo můžete vyvolat /path/to/installer/install-tl, když je spustitelný, nebo nejdříve použijte cd do adresáře atd.; nechceme opakovat všechny tyto variace.) Možná zvětšíte okno terminálu tak, aby ukazovalo celou obrazovku textového instalátoru (obr. 2).

K instalaci v režimu GUI (obr. 4) budete potřebovat nainstalovaný Tcl/Tk. Pak můžete spustit:

> perl install-tl -gui

Staré volby -wizard a -perltk/-expert nyní dělají tytéž věci jako -gui. Úplný seznam různých voleb získáte povelem:

> perl install-tl -help

O oprávněních Unixu: Vaše nastavení umask v čase instalace bude respektováno instalačním programem TeX Live. Proto když chcete, aby byla Vaše instalace použitelná i jinými uživateli než Vámi, ujistěte se, že jsou Vaše nastavení dostatečně tolerantní, například, umask 002. Další informace o nastavení umask hledejte v dokumentaci k Vašemu systému.

Zvláštní vysvětlivky pro Cygwin: Na rozdíl od jiných unixových systémů Cygwin implicitně neobsahuje všechny nezbytné programy, které instalátor TeX Live potřebuje. Viz sekci 3.1.4.

##### 3.1.2 macOS

Jak již bylo zmíněno v sekci 2.1, pro macOS je připravena samostatná distribuce, nazvaná MacTeX ( https://tug.org/mactex). Doporučujeme použít původní instalační program MacTeXu namísto instalátoru TeX Live pod macOS, protože původní (nativní) instalátor provede několik nastavení speciﬁckých pro Mac, zejména umožňuje snadné přepínání mezi různými vydáními TeX Live na počítačích Mac, pomocí datové struktury TeXDist.

MacTeX je silně založen na TeX Live a hlavní TeXovská stromová struktura a binárky jsou identické. Přidává několik dalších adresářů s dokumentací a aplikacemi speciﬁckými pro Mac.

##### 3.1.3 Windows

Jestliže používáte nerozbalený stažený .zip soubor nebo pokud se instalační program DVD nespustí automaticky, klikněte dvakrát na soubor install-tl-windows.bat.

Můžete také spustit instalační program z příkazového řádku. Dále > označuje prompt shellu; vstup uživatele je polotučný. Pokud jste v adresáři instalačního programu, jenom spusťte:

> install-tl-windows

Můžete také zadat absolutní cestu, jako například:

> D:\texlive\install-tl-windows
pro TeX-kolekce DVD, za předpokladu, že D: je optický disk. Obr. 3 zobrazuje základní obrazovku průvodcovského instalátoru, který je pro Windows implicitní.

Pro instalaci v textovém režimu použijte:

> install-tl-windows -no-gui

Pro úplný seznam různých voleb zadejte:

> install-tl-windows -help

Poznámka. Pokud stejný adresář obsahuje také install-tl-windows.exe, přidejte příponu .bat. Obvykle tomu tak nebude (pokud jste nezrcadlili adresář tlnet lokálně).

V cestě pro instalaci TeX Live je třeba se vyhnout jiným znakům než ASCII. To může být problém zejména pod Windows 11, kde uživatelé jsou nuceni používat síťový účet Microsoft. Viz https://tug.org/texlive/windows.html\#nonascii pro některé řešení.

    Installing TeX Live 2024 from: ...
    Platform: x86_64-linux => ’GNU/Linux on x86_64’
    Distribution: inst (compressed)
    Directory for temporary files: /tmp
    ...
    Detected platform: GNU/Linux on Intel x86_64

    <B> binary platforms: 1 out of 16

    <S> set installation scheme: scheme-full

    <C> customizing installation collections
        40 collections out of 41, disk space required: 8296 MB (free: 138718 MB)

    <D> directories:
        TEXDIR (the main TeX directory):
        /usr/local/texlive/2024
       ...

     <O> options:
       [ ] use letter size instead of A4 by default
       ...

     <V> set up for portable installation

    Actions:

     <I> start installation to hard disk
     <P> save installation profile to ’texlive.profile’ and exit
     <H> help
     <Q> quit

Obrázek 2: Hlavní obrazovka textového instalačního programu (GNU/Linux)

Obrázek 3: Základní obrazovka instalátoru (Windows); tlačítko ,Advanced‘ způsobí něco jako na obr. 4

Obrázek 4: Obrazovka pokročilého GUI instalátoru (GNU/Linux)

##### 3.1.4 Cygwin

Před začátkem instalace použijte program Cygwinu setup.exe k instalaci programů perl a wget, pokud jste tak ještě neudělali. Doporučené jsou následující doplňkové balíky:

- fontconfig [potřebný pro XeTeXa LuaTeX]

- ghostscript [potřebný pro různé pomůcky]

- libXaw7 [potřebný pro xdvi]

- ncurses [umožní příkaz clear používaný instalátorem]

##### 3.1.5 Textový instalační program

Obrázek 2 ukazuje základní obrazovku textového režimu pod Unixem. Pro Unix je textový instalační program nastaven implicitně.

Je to instalátor jenom s příkazovým řádkem; vůbec nemá kurzorovou podporu. Nemůžete se například pohybovat v zatrhávacích rámečcích nebo vstupních polích. Jenom něco napíšete (s rozlišováním velikosti písma) na příkazovém řádku a stlačíte klávesu Enter, poté se celá obrazovka přepíše s přizpůsobeným obsahem.

Rozhraní textového instalátoru je tak primitivní z prostého důvodu: je navržené tak, aby se dalo spustit na tolika platformách, jak je to jen možné, dokonce i s minimálním Perlem.

##### 3.1.6 Graﬁcký instalační program

Implicitní graﬁcký instalátor začíná jednoduše, pouze s několika volbami; viz obr. 3. Může být vyvolán pomocí

> install-tl -gui
Tlačidlo ,Advanced‘ dává přístup ke většině voleb textového instalátoru; viz obr. 4.

##### 3.1.7 Starší instalátory

Režimy perltk/expert a wizard jsou ještě pořád k dispozici pro systémy s nainstalovaným Perl/Tk. Můžou být speciﬁkované pomocí argumentů -gui=perltk resp. -gui=wizard.

##### 3.1.8 Jednoduchý průvodce instalací

Pod Windows je implicitně nastaveno spuštění nejjednoduššího instalačního způsobu, který můžeme doporučit, nazvaného „průvodce“ instalací. Nainstaluje všechno a nezadává skoro žádné otázky. Pokud si chcete veškeré nastavení upravit, musíte spustit některý z dalších instalátorů.

Pro jiné platformy může být tento režim vyvolán explicitně povelem

> install-tl -gui=wizard

#### 3.2 Spuštění instalačního programu

Instalátor je zamýšlený jako co nejvíce samovysvětlující. Nicméně nyní následuje několik poznámek o jednotlivých volbách a dílčích nabídkách:

##### 3.2.1 Nabídka binárních systémů (pouze Unix)

    Available platforms:
    ===============================================================================
    a [ ] Cygwin on x86_64 (x86_64-cygwin)
    b [ ] MacOSX current (10.14-) on ARM/x86_64 (universal-darwin)
    c [ ] MacOSX legacy (10.6-) on x86_64 (x86_64-darwinlegacy)
    d [ ] FreeBSD on x86_64 (amd64-freebsd)
    e [ ] FreeBSD on Intel x86 (i386-freebsd)
    f [ ] GNU/Linux on ARM64 (aarch64-linux)
    g [ ] GNU/Linux on RPi(32-bit) and ARMv7 (armhf-linux)
    h [ ] GNU/Linux on Intel x86 (i386-linux)
    i [X] GNU/Linux on x86_64 (x86_64-linux)
    j [ ] GNU/Linux on x86_64 with musl (x86_64-linuxmusl)
    k [ ] NetBSD on x86_64 (amd64-netbsd)
    l [ ] NetBSD on Intel x86 (i386-netbsd)
    m [ ] Solaris on Intel x86 (i386-solaris)
    o [ ] Solaris on x86_64 (x86_64-solaris)
    p [ ] Windows (64-bit) (windows)

Obrázek 5: Nabídka binárek

Obrázek 5 ukazuje nabídku binárek textového režimu. Standardně budou nainstalovány jenom binárky vaší aktuální platformy. Z této nabídky si rovněž můžete vybrat instalaci binárek pro jiné platformy. Toto může být užitečné, pokud sdílíte TeXovský strom v síti heterogenních strojů, nebo na systému s dvojitým zaváděcím procesem.

##### 3.2.2 Volba obsahu instalace

    Select a scheme:
    ====================================================================
    a [X] full scheme (everything)
    b [ ] medium scheme (small + more packages and languages)
    c [ ] small scheme (basic + xetex, metapost, a few languages)
    d [ ] basic scheme (plain and latex)
    e [ ] minimal scheme (plain only)
    f [ ] infrastructure-only scheme (no TeX at all)
    g [ ] book publishing scheme (core LaTeX and add-ons)
    h [ ] ConTeXt scheme
    i [ ] GUST TeX Live scheme
    j [ ] teTeX scheme (more than medium, but nowhere near full)
    k [ ] custom selection of collections

Obrázek 6: Nabídka schémat

Obrázek 6 ukazuje nabídku schémat TeX Live; tady vybíráte „schéma“, což je souhrn kolekcí balíků. Předvolené schéma full nainstaluje vše, co je k dispozici. To doporučujeme, avšak můžete také zvolit schéma basic pro pouze plain a LaTeX, small pro několik málo dalších programů (ekvivalentní s takzvanou instalací BasicTeX MacTeXu), minimal pro účely testování, a schéma medium nebo teTeX pro získání něčeho mezi tím. K dispozici jsou také různá specializovaná schémata a schémata speciﬁcká pro některé země.

Obrázek 7: Nabídka kolekcí

Svůj výběr schématu můžete upřesnit pomocí nabídky ,collections‘ (obrázek 7, ukázáno pro změnu v režimu GUI).

Kolekce jsou o jednu úroveň podrobnější než schémata – v podstatě je schéma tvořeno několika kolekcemi, kolekci tvoří jeden nebo více balíků, a balík (nejnižší úroveň seskupování v TeX Live) obsahuje vlastní soubory TeXovských maker, soubory fontů atd.

Pokud chcete získat větší kontrolu, než jakou poskytuje nabídka kolekcí, po instalaci můžete použít program TeX Live Manager (tlmgr) (viz sekci 5); jeho použitím můžete řídit instalaci na úrovni balíků.

##### 3.2.3 Adresáře

Standardní uspořádání je popsáno v sekci 2.3, na straně 10.

Standardní umístění instalačního adresáře je /usr/local/texlive/2024 pro Unix a C:\texlive\2024 pod Windows. Toto uspořádání umožňuje mít mnoho paralelních instalací TeX Live, jednu pro každé vydání (typicky podle roku, jako tady), a můžete mezi nimi přepínat pouhou změnou vyhledávací cesty.

Tento instalační adresář může být přepsán nastavením proměnné TEXDIR v instalátoru. Obrazovka GUI pro toto a další nastavení je ukázána na obrázku 4. Hlavní důvod pro změnu této předvolby je nedostatek diskového prostoru v této části (úplný TeX Live potřebuje několik gigabytů) nebo nedostatek práv na zápis pro standardní umístění. Nemusíte být zrovna rootem nebo administrátorem, když instalujete TeX Live, ale potřebujete oprávnění na zápis do cílového adresáře.

V systému Windows obvykle nemusíte být správcem na vytvoření C:\texlive\2024 (nebo obecněji, %SystemDrive%\texlive\2024).

Instalační adresáře mohou být také změněny nastavením různých proměnných prostředí před spuštěním instalátoru (pravděpodobně TEXLIVE_INSTALL_PREFIX nebo TEXLIVE_INSTALL_TEXDIR); viz dokumentaci z install-tl --help (dostupná online na https://tug.org/texlive/doc/install-tl.html) k získání úplného seznamu nebo dalších detailů.

Rozumnou alternativou je adresář uvnitř vašeho domovského adresáře, zvlášť když chcete být výhradním uživatelem. K označení domovského adresáře použijte vlnku, ‘~’, například ‘~/texlive/2024’.

Doporučujeme do názvu začlenit rok, což umožní paralelní společné zachování různých vydání TeX Live vedle sebe. Můžete také chtít udržovat název nezávislý na verzi, například /usr/local/texlive-cur pomocí symbolického odkazu, který může být později přepsán po přezkoušení nového vydání.

Změna TEXDIR v instalačním programu vyvolá také změny TEXMFLOCAL, TEXMFSYSVAR a TEXMFSYSCONFIG.

TEXMFHOME je doporučené umístění osobních souborů maker nebo balíků. Předvolená hodnota je ~/texmf (~/Library/texmf na Macs). Na rozdíl od TEXDIR je nyní ~ uchována v nově vytvořených konﬁguračních souborech, protože to užitečně odkazuje na domovský adresář kteréhokoliv uživatele TeXu. Expanduje se na $HOME pod Unixem a %USERPROFILE% pod Windows. Zvláštní poznámka: TEXMFHOME, jako všechny stromy, musí být uspořádaný v souladu s TDS, jinak nemusí být soubory k nalezení.

TEXMFVAR je umístění pro uložení většiny průběžně generovaných dočasných dat speciﬁckých pro každého uživatele. TEXMFCACHE je název proměnné, která se používá pro tento účel LuaLaTeXem a ConTeXtem MkIV (viz oddíl 3.4.5, na straně 49); její implicitní hodnota je TEXMFSYSVAR, nebo (pokud tato neumožňuje zápis) TEXMFVAR.

##### 3.2.4 Volby

    Options customization:
    ===============================================================================
     <P> use letter size instead of A4 by default: [ ]
     <E> execution of restricted list of programs: [X]
     <F> create all format files:                  [X]
     <D> install font/macro doc tree:              [X]
     <S> install font/macro source tree:           [X]
     <L> create symlinks in standard directories:  [ ]
                binaries to:
                manpages to:
                    info to:
     <Y> after install, set CTAN as source for package updates: [X]

Obrázek 8: Nabídka voleb (Unix)

Obrázek 8 ukazuje nabídku voleb textového režimu. Další informace o každé volbě:

use letter size instead of A4 by default:

  Výběr standardní velikosti papíru. Jednotlivé dokumenty mohou a měly by deklarovat zvláštní rozměr papíru, pokud je to žádoucí.

execution of restricted list of programs:

  Od TeX Live 2010 je implicitně povoleno vykonávání několika externích programů. Velmi neúplný seznam povolených programů je uveden v souboru texmf.cnf. Pro další podrobnosti viz novinky 2010 (oddíl 9.1.7).

create all format ﬁles:

  Doporučujeme ponechat tuto možnost zaškrtnutou, abyste předešli zbytečným problémům při dynamickém vytváření formátů. Další podrobnosti najdete v dokumentaci fmtutil.

install font/macro … tree:

  Stahování/instalace dokumentace a zdrojových souborů ve většine balíků. Nedoporučuje se vypustit.

create symlinks in standard directories:

  Tato volba (pouze Unix) obchází potřebu změny proměnných prostředí. Bez této volby je obvykle potřebné přidat adresáře TeX Live do proměnných PATH, MANPATH a INFOPATH. Budete muset přidělit práva na zápis cílovým adresářům. Tato volba je určena pro zpřístupnění systému TeX pomocí adresářů, které již uživatelé znají, jako například /usr/local/bin, které neobsahují žádné TeXovské soubory. Důrazně doporučujeme nepřepsat stávající soubory vašeho TeXovského systému, který přišel s touto volbou, tj. speciﬁkací systémových adresářů. Nejbezpečnější a doporučený přístup je ponechat volbu neoznačenou.

after install, set CTAN as source for package updates:

  Pro instalaci z DVD nebo obrazu ISO je tato volba implicitně umožněna, protože uživatel obvykle chce uskutečnit následné aktualizace balíků z archivu CTAN, kde jsou průběžně aktualizovány po celý rok. Jediný důvod pro jejich potlačení přichází v úvahu, pokud instalujete jenom část z DVD a plánujete rozšířit instalaci později. V každém případě úložiště balíku pro instalátor a pro poinstalační aktualizace mohou být nastaveny nezávisle podle potřeby; viz oddíl 3.3.1 a oddíl 3.4.3.

Volby pro Windows, zobrazené v graﬁckém instalátoru GUI pro znalce:

adjust searchpath

  Tohle zabezpečí, že všechny programy uvidí binární adresář TeX Live v seznamu cest spustitelných programů.

add menu shortcuts

  V případě nastavení vznikne ve Start menu další položka TeX Live podmenu. Kromě ‘TeX Live menu’a ‘No shortcuts’zde bude třetí volba ‘Launcher entry’. Tato volba je popsána v oddíle 4.1.

File associations

  Volby jsou ‘Only new’(vytvoření pouze nových souborových asociací, bez přepsání stávajících), ‘All’a ‘None’.

install TeXworks front end

Když jsou všechna nastavení podle vašich preferencí, stačí napsat ,I‘ v textovém okně, nebo stisknout tlačítko ‘Install’v GUI a spustit instalační proces. Po dokončení přeskočte na sekci 3.4, kde se dozvíte, co se případně má udělat nakonec.

#### 3.3 Volby příkazového řádku pro install-tl

K zobrazení voleb příkazového řádku napište

> install-tl -help
K uvedení názvu volby mohou být použity - nebo také --. Následují nejběžnější volby:

-gui

  Použijte GUI instalátor pokud je to možné. Toto si vyžaduje Tcl/Tk ve verzi 8.5 nebo vyšší. Toto bylo distribuováno se starším macOS; pro Big Sur a pozdější budete muset nainstalovat Tcl/Tk sami, pokud nezvolíte použití instalačního programu MacTeXṪcl/Tk je distribuován s TeX Live pod Windows. Starší volby -gui=perltk a -gui=wizard jsou stále ještě k dispozici, ale vyvolají stejné GUI rozhraní; pokud Tcl/Tk a Perl/Tk nejsou k dispozici, pokračuje instalace v textovém režimu.

  with older macOS; for Big Sur and later

-no-gui

  Vynutí si použití instalátoru v textovém režimu.

-lang LL

  Speciﬁkuje jazyk instalačního rozhraní jako jeho standardní, obvykle dvoupísmenný, kód. Instalátor se pokusí automaticky určit správný jazyk, ale když selže nebo když správný jazyk není k dispozici, použije angličtinu jako nouzové řešení. Pro získání seznamu všech podporovaných jazyků spusťte install-tl --help.

-portable

  Instalace pro přenosné použití, například na klíč USB. Dá se zvolit rovněž v textovém instalátoru pomocí příkazu V a z instalátoru GUI. Viz oddíl 4.2.

-profile soubor

  Načtěte instalační proﬁlový soubor a proveďte instalaci bez interakce s uživatelem. Instalační program vždy uloží soubor texlive.profile do podadresáře tlpkg vaší instalace. Tento soubor může být zadán jako argument například pro znovuvytvoření identické instalace na jiném systému. Nebo můžete použít uživatelský proﬁl, který nejjednodušeji vytvoříte změnou hodnot vygenerovaného souboru, nebo odstartováním s prázdným souborem, který převezme všechny předvolby.

-repository soubor-nebo-adresář

  Určuje repozitář balíků, z kterého se má instalovat; viz následující oddíl.

-in-place

  (Dokumentováno pouze pro úplnost: nepoužívejte, pokud si nejste jisti tím, co děláte!) Pokud již máte rsync, svn nebo jinou kopii TeX Live (viz https://tug.org/texlive/acquire-mirror.html) tehdy tato volba použije ta data, která již máte stažena, a vykoná pouze nezbytné činnosti po instalaci. Upozorňujeme, že soubor tlpkg/texlive.tlpdb může být přepsán; jeho uložení zůstává na vaší odpovědnosti. Také odstranění balíku se musí vykonat ručně. Tato volba nemůže být zapnuta pomocí rozhraní instalátoru.

##### 3.3.1 Volba -repository

Implicitní síťový repozitář balíků je zrcadlo CTAN zvolené automaticky použitím https://mirror.ctan.org.

Pokud ho chcete přepsat, může být hodnotou umístění adresa url s ftp:, http:, https:, file:/ na začátku nebo jednoduchá cesta k adresáři. (Při zadání umístění http:, https: nebo ftp: jsou koncové znaky ,/‘ a/nebo koncová složka ,/tlpkg‘ ignorovány.)

Kupříkladu můžete zvolit určité zrcadlo CTAN něčím jako: http://ctan.example.org/tex-archive/systems/texlive/tlnet/, s nahrazením ctan.example.org/tex-archive skutečným hostitelským jménem (hostname) a jeho konkrétní kořenovou cestou k CTAN (jako třeba ftp.cstug.cz/pub/CTAN). Seznam zrcadel CTAN je udržován na https://ctan.org/mirrors.

Pokud je zadaný argument lokální (buď cesta nebo file:/ url), jsou použity komprimované soubory v podadresáři archive cesty repozitáře (i kdyby byly rovněž k dispozici nekomprimované soubory).

#### 3.4 Poinstalační činnosti

Po instalaci mohou být požadovány některé další instalace.

##### 3.4.1 Proměnné prostředí pro Unix

Pokud se rozhodnete vytvořit symbolické odkazy v standardních adresářích (popsaných v oddíle 3.2.4), pak není nutná editace proměnných prostředí. Jinak v systémech Unix musí být adresář binárek pro vaši platformu přidán k prohledávaným cestám. (Ve Windows se o to postará instalátor.)

Každá podporovaná platforma má svůj vlastní podadresář pod TEXDIR/bin. Seznam podadresářů a odpovídajících platforem je na obrázku 5.

Nepovinně můžete rovněž přidat dokumentační manuálové stránky (man pages) a adresáře Info k jejich příslušejícím vyhledávacím cestám, pokud chcete, aby je našly systémové nástroje. Dokumentační stránky mohou být automaticky nalezeny po přidání do proměnné PATH.

For Bourne-compatible shells such as bash, and using Intel x86 GNU/Linux and the TeX Live default directory setup as an example, the ﬁle to edit might be $HOME/.profile (or another ﬁle sourced by .profile), and the lines to add would look like this:

Pro shelly kompatibilní s Bourneshell, jako je bash, použijíc jako příklad Intel x86 GNU/Linux se standardním nastavením adresářů TeX Live, může být vhodné editovat soubor $HOME/.profile a řádky, které je potřeba přidat, budou vypadat následovně:

    PATH=/usr/local/texlive/2024/bin/x86_64-linux:$PATH; export PATH
    MANPATH=/usr/local/texlive/2024/texmf-dist/doc/man:$MANPATH; export MANPATH
    INFOPATH=/usr/local/texlive/2024/texmf-dist/doc/info:$INFOPATH; export INFOPATH

Pro csh nebo tcsh je editovaný soubor typicky $HOME/.cshrc a řádky k přidání mohou vypadat jako:

    setenv PATH /usr/local/texlive/2024/bin/x86_64-linux:$PATH
    setenv MANPATH /usr/local/texlive/2024/texmf-dist/doc/man:$MANPATH
    setenv INFOPATH /usr/local/texlive/2024/texmf-dist/doc/info:$INFOPATH

Pokud nejste na platformě x86_64-linux, použijte příslušný název platformy; podobně, pokud jste nenainstalovali ve výchozím adresáři, změňte název adresáře. Instalační program TeX Live oznamuje plné řádky k použití na konci instalace.

Pokud již někde ve svých spouštěcích souborech máte nastavení PATH, slučte v adresářích TeX Live jak uznáte za vhodné.

##### 3.4.2 Proměnné prostředí: globální konﬁgurace

Volba, zda učinit tyto změny globálně, anebo pro uživatele právě přidaného do systému, je na vás. Mezi různými systémy existuje příliš mnoho variant, kde a jak se tato nastavení provádějí. Naše dvě rady jsou: 1) můžete vyhledat soubor /etc/manpath.config a pokud existuje, přidejte řádky jako

    MANPATH_MAP /usr/local/texlive/2024/bin/x86_64-linux \
                /usr/local/texlive/2024/texmf-dist/doc/man

A za 2) vyhledejte soubor /etc/environment, který může deﬁnovat vyhledávací cestu a další standardní proměnné prostředí.

V každém (Unixovém) adresáři binárek vytváříme také symbolický odkaz na adresář texmf-dist/doc/man s názvem man. Některé programy man, jako například standardní macOS man, ho automaticky najdou, což odstraňuje potřebu jakéhokoliv nastavování dokumentačních stránek.

##### 3.4.3 Internetové aktualizace po instalaci z DVD

Pokud jste instalovali TeX Live z DVD a později si přejete získat aktualizace z internetu, budete potřebovat spuštění tohoto povelu – poté, co jste aktualizovali vaši vyhledávací cestu (jako to bylo popsané v předcházejícím oddíle):

> tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet

Toto řekne programu tlmgr, aby pro následující aktualizace použil nejbližší zrcadlo CTANu. To je implicitně nastaveno při instalaci z DVD pomocí volby popsané v sekci 3.2.4.

Pokud se vyskytnou problémy s automatickým výběrem zrcadla, můžete deklarovat konkrétní zrcadlo CTANu ze seznamu na stránce https://ctan.org/mirrors. Použijte přesnou cestu k podadresáři tlnet tohoto zrcadla, jak jsme uvedli výše.

##### 3.4.4 Systémová konﬁgurace fontů pro XeTeX a LuaTeX

XeTeX a LuaTeX mohou používat jakýkoli font instalovaný v systému, nejenom ty, které se nacházejí v TeXovských stromech. Takové systémové fonty (nejsou součástí TeX Live) jsou obvykle přístupné zadáním názvu písma, např. ‘Liberation Serif’, i když lze použít i systémový název souboru.

Související problém je zpřístupnění písem z distribuce TeX Live jako systémová písma, které je následně zpřístupní podle názvu písma.

Pro LuaTeX: pro přístup podle názvu písma není třeba dělat nic zvláštního. Všechny fonty v TeX Live by měly být stejně přístupné buď podle názvu písma nebo podle názvu souboru pro LuaTeX, prostřednictvím balíčku luaotﬂoad, který podporuje jak LaTeX tak prostý TeX. Seznam názvů fontů luaotﬂoad může být nutné přebudovat pro nová písma; toto je spuštěno automaticky při pokusu o načtení fontu, který ještě není znám.

Pro XeTeX: pod Windows jsou fonty dodané s TeX Live automaticky dostupné (spuštěním programu fc-cache poskytnutého pro Windows jako součást TeX Live). Pro Mac se budete muset poradit s další dokumentaci. Pro jiné systémy než macOS, je postup následující.

Když je nainstalován balíček xetex (buď na začátku instalace nebo později), je vytvořen potřebný konﬁgurační soubor TEXMFSYSVAR/fonts/conf/texlive-fontconfig.conf. Chcete-li vytvořit TeX Live fonty dostupné jako systémové fonty (za předpokladu, že máte odpovídající oprávnění),

1. Zkopírujte tento soubor texlive-fontconfig.conf do adresáře (obvykle) /etc/fonts/conf.d/09-texlive.conf.

2. Spusťte fc-cache -fsv.

Pokud nemáte postačující práva k provedení výše popsaných kroků, nebo chcete-li učinit fonty TeX Live dosažitelné pro jediného uživatele, můžete učinit následující:

1. Zkopírujte soubor texlive-fontconfig.conf (obvykle) do ~/.fonts.conf.d/ 09-texlive.conf, kde ~ označuje váš domovský adresář.

2. Spusťte fc-cache -fv.

Pokud chcete uvidět jména všech dostupných systémových fontů, můžete spustit příkaz fc-list. Příkaz fc-list : family style file spacing (všechny tyto argumenty jsou písmenkové řetězce) ukáže některou obecně zajímavou informaci.

##### 3.4.5 ConTeXt LMTX and MKIV

,Starý‘ ConTeXt (Mark IV nebo MkIV) a ,nový‘ ConTeXt (LMTX nebo MkXL) by měly po instalaci TeX Live fungovat bez dalších zásahů a neměly by vyžadovat zvláštní pozornost, pokud budete k aktualizacím používat tlmgr.

ConTeXt nepoužívá knihovnu Kpathsea ani systém ls-R soubory; místo toho ConTeXt udržuje pro uživatele databázi souborů pro všechny známé stromy. Spuštěním mktexlsr se tyto databáze neaktualizují přímo, ale ConTeXt je automaticky znovu sestaví při dalším spuštění. (Implementují to soubory speciﬁcké pro TeX Live cont-sys.mkiv a cont-sys.mkxl.)

Pokud budete někdy chtít tyto databáze ručně znovu sestavit, spusťte pro jednu nebo obě:

    mtxrun --generate           # LMTX
    mtxrun --luatex --generate  # MkIV

Výsledné soubory jsou uloženy do proměnné TEXMFCACHE, jejíž přednastavená hodnota v TeX Live je TEXMFSYSVAR;TEXMFVAR.

ConTeXt bude číst ze všech cest uvedených v TEXMFCACHE a zapisovat do první zapisovatelné cesty. Při čtení v případě duplicitních údajů v paměti cache získá přednost poslední nalezený prvek.

Pro další informace viz https://wiki.contextgarden.net/LMTX
a https://wiki.contextgarden.net/Running_Mark_IV.

##### 3.4.6 Začleňování lokálních a osobních maker

Toto je již implicitně zmíněno v sekci 2.3: adresář TEXMFLOCAL (standardně /usr/local/texlive/texmf-local nebo %SystemDrive%\texlive\texmf-local pod Windows) je určen pro rozsáhlé systémové lokální fonty a makra; adresář TEXMFHOME (standardně $HOME/texmf nebo %USERPROFILE%\texmf) je určen pro osobní fonty a makra. Pro oba stromy musí být soubory umístěny v patřičných podadresářích TDS (TeX Directory Structure); viz https://tug.org/tds nebo nahlédni do souboru texmf-dist/web2c/texmf.cnf. Například, LaTeXovský styl, třída nebo makrobalík by měl být umístěn v TEXMFLOCAL/tex/latex nebo TEXMFHOME/tex/latex, nebo v jejich podadresářích.

TEXMFLOCAL vyžaduje aktuální databázi jmen souborů, jinak nebudou soubory nalezeny. Můžete ji obnovit povelem mktexlsr nebo použít tlačítko ,Update ﬁle database‘ na záložce ,Actions‘ programu TeX Live Manager v režimu GUI.

Standardně je každá z těchto proměnných deﬁnována jako samostatný adresář, jak je vidět. To však není nezbytně nutné. Pokud například potřebujete přepínat mezi dvěma verzemi velkých balíků, můžete udržovat více stromů pro vaše vlastní potřeby. Toho dosáhnete nastavením TEXMFHOME na seznam adresářů uvnitř složených závorek oddělených čárkami:

         TEXMFHOME = {/my/dir1,/mydir2,/a/third/dir}

Další popis expanze závorek je v oddíle 7.1.5.

##### 3.4.7 Začleňování fontů třetích stran

Toto je naneštěstí nepříjemné téma pro TeX a pdfTeX. Zapomeňte na něj, pokud se nechcete probírat v mnoha podrobnostech instalace TeXu. Mnohé fonty již jsou zahrnuty v TeX Live, proto se podívejte, jestli chcete; https://tug.org/FontCatalogue je pohodlný způsob, jak zobrazit písma dostupná na webu.

Pokud to potřebujete udělat, vyvinuli jsme maximální úsilí k popsání postupu, viz https://tug.org/fonts/fontinstall.html.

Zvažte rovněž použití XeTeXu nebo LuaTeXu (viz sekce 2.4), které vám umožní používat provozní systémová písma bez jakékoli instalace v TeXu. (Ale pozor, používání systémových fontů obvykle způsobí, že zdrojáky vašich dokumentů budou nepoužitelné pro kohokoli v jiném prostředí.)

#### 3.5 Testování instalace

Po nainstalování TeX Live přirozeně chcete systém otestovat, abyste mohli začít vytvářet nádherné dokumenty nebo fonty.

Jednou z věcí, kterou byste mohli ihned hledat, je nástroj na editaci souborů. TeX Live nainstaluje TeXworks ( https://tug.org/texworks) pro Windows (pouze) a MacTeX nainstaluje TeXShop ( https://pages.uoregon.edu/koch/texshop). V jiných Unixových systémech je volba editoru ponechána na vás. Jsou k dispozici mnohé možnosti, některé z nich jsou uvedeny v následujícím oddíle; viz též https://tug.org/interest.html#editors. Bude fungovat libovolný obyčejný editor; nic TeXovsky speciﬁcké se nevyžaduje.

Zbytek tohto oddílu udává některé základní postupy testování funkcionality nového systému. Zde uvádíme příkazy Unixu; pod macOS nebo Windows pravděpodobně budete spouštět testy pomocí graﬁckého rozhraní, avšak principy jsou stejné.

1. Nejprve ověřte, zda se spustí program tex:

   > tex --version
   TeX 3.14159265 (TeX Live ...)
   Copyright ... D.E. Knuth.
   ...
   Pokud obdržíte hlášku s ,command not found‘ místo výše uvedeného nebo se starší verzí, patrně nemáte nastavený správný podadresář bin v proměnné prostředí PATH. Vraťte se k informacím o jejich nastavování na straně 46.

2. Přeložte ukázkový soubor LaTeXu a vytvořte PDF:

   > pdflatex sample2e.tex
   This is pdfTeX 3.14...
   ...
   Output written on sample2e.pdf (3 pages, 142120 bytes).
   Transcript written on sample2e.log.
   Pokud selže nalezení souboru sample2e.tex nebo jiných souborů, můžete mít aktivní stará nastavení proměnných prostředí nebo konﬁguračních souborů; pro začátek doporučujeme zrušit nastavení všech proměnných prostředí souvisejících s TeXem. Pro hlubší analýzu a dohledání problému můžete kdykoliv požádat TeX o detaily toho, co a kde hledá: viz „Ladicí činnosti“ na straně 90.

3. Prohlédněte si PDF soubor, například:

   > xpdf sample2e.pdf
   Mělo by se zobrazit nové okno s pěkným dokumentem vysvětlujícím některé ze základů LaTeXu. (Mimochodem stojí za přečtení, pokud jste TeXovský nováček.)

   Samozřejmě existuje mnoho dalších prohlížečů PDF; na unixových systémech se běžně používají evince a okular. Pro Windows doporučujeme vyzkoušet Sumatra PDF ( https://www.sumatrapdfreader.org/free-pdf-reader.html). Žádné prohlížeče PDF nejsou součástí TeX Live, takže si musíte samostatně nainstalovat, co chcete používat.

4. Samozřejmě stále můžete generovat původní TeXovský formát DVI:

   > latex sample2e.tex

5. A prohlédnout si DVI na obrazovce:

   > xdvi sample2e.dvi # Unix
   > dviout sample2e.dvi # Windows
   Musíte mít spuštěny X Window, aby xdvi pracovalo. Pokud tomu tak není, nebo máte špatně nastavenou proměnnou prostředí DISPLAY, dostanete chybovou hlášku ,Can’t open display‘.

6. Pro vytvoření PostScriptového souboru z DVI použijte:

   > dvips sample2e.dvi -o sample2e.ps

7. Nebo vytvořte PDF ze souboru DVI, alternativní cestou k použití pdfTeXu (nebo XeTeXu nebo LuaTeXu), co může být někdy užitečné:

   > dvipdfmx sample2e.dvi -o sample2e.pdf

8. Další standardní testovací soubory, které mohou být užitečné kromě sample2e.tex:

   small2e.tex

     Ukázkový dokument, ještě kratší než sample2e.

   testpage.tex

     Test, jestli vaše tiskárna neposunuje tiskové zrcadlo.

   nfssfont.tex

     Pro tisk tabulek fontů a testů fontů.

   testfont.tex

     Pro totéž, ale pro plain TeX.

   story.tex

     Základní (plain) TeXový testovací soubor. Musíte napsat , bye‘ na výzvu * po ,tex story.tex‘.

9. Pokud máte nainstalovaný balík xetex package, můžete prověřit jeho přístup k systémovým fontům následovně:

   > xetex opentype-info.tex
   This is XeTeX, Version 3.14…
   ...
   Output written on opentype-info.pdf (1 page).
   Transcript written on opentype-info.log.

   Jestliže obdržíte chybové hlášení „Invalid fontname ‘Latin Modern Roman/ICU’…“, pak potřebujete nakonﬁgurovat váš systém tak, aby fonty dodané s TeX Live byly k nalezení. Viz oddíl 3.4.4.

#### 3.6 Odinstalování TeX Live

Chcete-li odinstalovat TeX Live (po úspěšné instalaci; pro Windows viz níže) použijte:

> tlmgr uninstall –all

Budete požádáni o potvrzení, jinak se nic dělat nebude. (Bez --all se k odstranění použije činnost uninstall jednotlivé balíčky.)

Tím se neodstraní adresáře speciﬁcké pro uživatele, konkrétně (viz také oddíl 2.3):

TEXMFCONFIG

  To je určeno pro změny uživatelské konﬁgurace. Pokud je chcete zachovat, před odstraněním sa ujistěte, že víte, jak je znovu vytvořit.

TEXMFVAR

  To je určeno k ukládání automaticky generovaných runtime dat, jako jsou lokální soubory formátů. Pokud jste je nepoužili pro jiné účely, mělo by jejich odstranění být bezpečné.

TEXMFHOME

  Obvykle obsahuje pouze soubory, které jste si sami nainstalovali, které nejsou dostupné v distribucích. Pravděpodobně toto nebudete chtít odstranit, pokud neplánujete úplně přestat používat TeX, nebo pokud nechcete začít znovu od nuly.

Cesty k adresářům pro tyto proměnné můžete najít spuštěním kpsewhich -var-value=var.

Tato odinstalace tlmgr také nezruší poinstalační činnosti, jako jsou změny PATH v inicializačních souborech vašeho shellu a systémový přístup k fontům v TeX Live (viz oddíl 3.4). Takové akce musíte ručně zvrátit, pokud je to žádoucí.

V systému Windows lze odinstalaci provést pomocí GUI; viz oddíl 6.1.

#### 3.7 Odkazy na doplňkový software s možností stažení z internetu

Pokud jste TeXový začátečník nebo potřebujete pomoc s psaním TeXových, respektive LaTeXových dokumentů, navštivte https://tug.org/begin.html, kde najdete úvodní informace k instalaci.

Odkazy na některé další pomůcky, o jejichž instalaci můžete uvažovat:

Ghostscript

  https://ghostscript.com/, bezplatný interpret PostScriptu a PDF.

Perl

  https://perl.org/ s doplňujícími balíky z CPAN, https://cpan.org/.

ImageMagick

  https://imagemagick.org, k zpracování a konverzi graﬁky

NetPBM

  http://netpbm.sourceforge.net, rovněž pro graﬁku.

TeXovsky orientované editory

  Existuje široký výběr a je to záležitost vkusu uživatele. Tady je výběr v abecedním řazení (několik málo je pouze pro Windows).

  - GNU Emacs je k dispozici pro všechny hlavní platformy, viz https://www.gnu.org/software/emacs.

  - AUCTeX běží pod Emacsem; je k dispozici přes správce balíčků Emacs ELPA. Zdroje jsou také k dispozici na CTAN. Domovská stránka AUCTeXu je https://www.gnu.org/software/auctex.

  - SciTE je k dostání z https://www.scintilla.org/SciTE.html.

  - Texmaker je volný (free) software, k dispozici z https://www.xmlmath.net/texmaker.

  - TeXstudio začínalo jako odbočka programu Texmaker s dodatečnými rysy; dostupné z https://texstudio.org/.

  - TeXnicCenter je volný software, k dispozici z https://www.texniccenter.org.

  - TeXworks je volný software, k dispozici z https://tug.org/texworks a je nainstalovaný jako součást TeX Live pro Windows (pouze).

  - Vim je volný software, k dispozici z https://www.vim.org.

  - WinEdt je shareware dostupný třeba na https://tug.org/winedt nebo na https://www.winedt.com.

  - WinShell je k dispozici z https://www.winshell.de.

Pro mnohem delší seznam balíků a programů viz https://tug.org/interest.html.

### 4 Specializované instalace

Předcházející oddíly popisovaly základní instalační proces. Teď se zaměříme na některé speciální případy.

#### 4.1 Instalace sdílené uživateli

TeX Live byl navržený tak, aby se dal sdílet mezi různými systémy na síti. Se standardní strukturou adresářů se nekonﬁgurují žádné pevné plné cesty: umístění souborů potřebných pro programy TeX Live je zřízeno relativně k programům. Můžete ho najít v nejdůležitějším konﬁguračním souboru $TEXMFDIST/web2c/texmf.cnf, který obsahuje řádky jako jsou

    TEXMFROOT = $SELFAUTOPARENT
    ...
    TEXMFDIST = $TEXMFROOT/texmf-dist
    ...
    TEXMFLOCAL = $SELFAUTOGRANDPARENT/texmf-local

To znamená, že k získání funkčního nastavení stačí přidat ke své vyhledávací cestě adresář binárek TeX Live pro jejich platformu.

Stejným způsobem můžete nainstalovat TeX Live lokálně a pak přesunout celou hierarchii později na místo v síti.

Pro Windows TeX Live zahrnuje spouštěč tlaunch. Jeho hlavní okno obsahuje položky menu a tlačítka pro pro různá programy a dokumentaci související s TeXem, které se dají přizpůsobovat prostřednictvím ini souboru. Při prvním použití spouští běžné poinstalační procesy speciﬁcké pro Windows, tj. upravuje vyhledávací cesty pro TeX Live a vytváří některé asociace souborů ale jenom pro aktuálního uživatele. Proto pracovní stanice s přístupem k TeX Live na lokální síti potřebují pouze link pro spouštěč. Viz příručku tlaunch (texdoc tlaunch nebo https://ctan.org/pkg/tlaunch).

#### 4.2 Mobilní USB instalace

Volba instalačního programu -portable (nebo příkaz V v textové verzi instalátoru nebo odpovídající volba GUI) vytváří úplně samostatnou instalaci TeX Live pod společným kořenem a předcházející integraci systému. Takovou instalaci můžete vytvořit přímo na klíči USB, nebo ji zkopírovat na klíč USB později.

Technicky přenosná instalace se stává samostatnou nastavením výchozích hodnot TEXMFHOME, TEXMFVAR a TEXMFCONFIG tak, aby byly stejné jako TEXMFLOCAL, TEXMFSYSVAR a TEXMFSYSCONFIG; tím pádem, konﬁgurace a mezipaměti pro uživatele nebudou vytvořeny.

Ke spuštění TeXu při použití této přenosné instalace musíte přidat příslušný adresář binárek k vyhledávané cestě během vaší práce na terminálu jako obvykle.

Pod Windows můžete dvakrát kliknout na tl-tray-menu v kořenovém adresáři instalace a vytvořit dočasné ‘tray menu’poskytující volby mezi několika běžnými úkoly, jak je to ukázáno na této obrazovce:

Vstup ,Více…‘ vysvětluje, jak si můžete přizpůsobit tuto nabídku.

### 5 tlmgr: správa vaší instalace

Obrázek 9: tlshell GUI, ukazující menu ,Actions‘ (macOS)

Obrázek 10: tlcockpit GUI pro tlmgr

Obrázek 11: Starší režim tlmgr GUI: hlavní okno, po kliknutí na tlačítko ,Load‘

TeX Live obsahuje program nazvaný tlmgr pro správu TeX Live po výchozí instalaci. Jeho možnosti zahrnují:

- instalaci, aktualizaci, zálohování, obnovení a odinstalování jednotlivých balíků, volitelně i se započítáním závislostí mezi balíky;

- vyhledávání a přehled balíků a jejich popisy;

- výpis seznamu, přidání a odstranění platforem;

- změna instalačních voleb jako například velikosti papíru a umístění zdrojů (viz sekci 3.3.1).

Funkcionalita programu tlmgr úplně zahrnuje program texconﬁg. Pořád distribuujeme a udržujeme texconﬁg, pokud někdo využívá jeho rozhraní, avšak nyní doporučujeme používat tlmgr.

#### 5.1 Rozhraní GUI pro tlmgr

TeX Live obsahuje několik GUI pro tlmgr. Dva pozoruhodné: (1) Obr. 9 ukazuje tlshell, který je napsán v Tcl/Tk a pod Windows pracuje mimo ,box‘u. (2) Obr. 10 ukazuje tlcockpit, který vyžaduje Java ve verzi 8 nebo vyšší a JavaFX. Oba jsou dodány jako samostatné balíčky.

tlmgr má také nativní režimu GUI (viz obr. 11), který se spouští pomocí

> tlmgr -gui
Avšak toto rozšíření GUI vyžaduje Perl/Tk, kterého modul již není zahrnut v distribuci Perl v TeX Live pro Windows.

#### 5.2 Vzorové realizace tlmgr z příkazového řádku

Po výchozí instalaci můžete svůj systém aktualizovat na nejnovější dostupnou verzi pomocí:

> tlmgr update -all
Pokud vás to znepokojuje, zkuste nejdříve
> tlmgr update -all -dry-run
nebo (méně upovídané):
> tlmgr update -list

Tento složitější příklad přidá z místního adresáře kolekci pro nástroj (engine) XeTeX:

> tlmgr -repository /local/mirror/tlnet install collection-xetex
Vytvoří následující výstup (zkrácené):

    install: collection-xetex
    install: arabxetex
    ...
    install: xetex
    install: xetexconfig
    install: xetex.i386-linux
    running post install action for xetex
    install: xetex-def
    ...
    running mktexlsr
    mktexlsr: Updating /usr/local/texlive/2024/texmf-dist/ls-R...
    ...
    running fmtutil-sys --missing
    ...
    Transcript written on xelatex.log.
    fmtutil: /usr/local/texlive/2024/texmf-var/web2c/xetex/xelatex.fmt installed.

Jak můžete vidět, tlmgr nainstaluje závislosti a postará se o všechny potřebné poinstalační činnosti, včetně aktualizace databáze názvů souborů a (znovu)vygenerování formátů. Výše jsme vytvořili nové formáty pro XeTeX.

K popisu balíku (nebo kolekce či schématu) zadejte:

> tlmgr show collection-latexextra
což vytvoří výstup jako tento:

    package:    collection-latexextra
    category:   Collection
    shortdesc:  LaTeX supplementary packages
    longdesc:   A very large collection of add-on packages for LaTeX.
    installed:  Yes
    revision:   46963
    sizes:      657941k

Nakonec to nejdůležitější – úplnou dokumentaci najdete na https://tug.org/texlive/tlmgr.html nebo zadáním:

> tlmgr -help

### 6 Poznámky k Windows

#### 6.1 Vlastnosti typické pro Windows

Pod Windows dělá instalační program některé dodatečné věci:

Nabídky a zkratky.

  Je nainstalována nová položka ,TeX Live‘ nabídky Start. Obsahuje vstupy pro některé programy GUI jako tlshell (GUI pro tlmgr) a dviout a trochu dokumentace.

Přidružení souborů.

  Pokud je to povoleno, TeXworks, Dviout a PS_view se buď stávají předvolenými programy pro jejich příslušné typy souborů, nebo pro tyto typu souborů získávají položku v nabídce ,Otevřít pomocí‘ dostupnou kliknutím pravým tlačítkem. Avšak přidružení souborů ,Uživatelská volba‘ s vyšší prioritou, která mohou být pouze speciﬁkované interaktivně, může překážet.

Podpora PostScriptu.

  Pro soubory PostScript typ souboru PSviewer nyní převede PostScript na dočasné PDF, které pak zobrazí výchozí prohlížeč PDF. Různé bitmapové formáty získají záznam bitmap2eps v jejich nabídce ,Otevřít pomocí‘ kliknutím pravým tlačítkem pro převod do EPS, skutečnou práci vykonají sam2p nebo bmeps.

Automatické nastavení proměnné path.

  Nevyžadují se žádné kroky ruční konﬁgurace.

Odinstalátor.

  Instalační program vytvoří položku pro TeX Live, pod nabídkou ,Add/Remove Programs‘ (administrátorská instalace) nebo pod nabídkou TeX Live (instalace pro jednoho uživatele).

Ochrana proti zápisu.

  Pro administrátorskou instalaci jsou adresáře TeX Live chráněny proti zápisu, přinejmenším pokud je TeX Live instalován na pevném disku s formátováním NTFS.

Pro jiný přístup se také podívejte na tlaunch, popsaný v oddíle 4.1.

#### 6.2 Dodatečný obsažený software pod Windows

Pro úplnost, instalace TeX Live potřebuje podpůrné programy, které na stroji s Windows obvykle nenajdete. TeX Live poskytuje chybějící součásti. Tyto programy jsou nainstalovány jako část TeX Live pouze pod Windows.

Perl, Tcl/Tk a Ghostscript.

  Kvůli důležitosti Perlu a Ghostscriptu, a protože GUI instalačního programu a tlshell jsou napsány v Tcl/Tk, zahrnuje TeX Live ,skryté‘ kopie těchto programů. Programy TeX Live, které je potřebují, vědí, kde je najdou, ale neprozrazují jejich přítomnost nastavením proměnných prostředí nebo registrů. Kromě Ghostscriptu to nejsou úplné instalace a neměly by překážet žádným systémovým instalacím Perlu, Tcl/Tk nebo Ghostscriptu. Jak říct TeX Live, že chcete použít své vlastní externí instalace pro dodané skripty v TeX Live viz pododdíl 6.3.

dviout.

  Nainstalován je také dviout, prohlížeč DVI souborů. Nejdříve, když prohlížíte soubory pomocí dviout, vytvoří fonty, protože fonty pro obrazovku nebyly nainstalovány. Po chvilce budete mít vytvořenu většinu fontů pro použití a okno vytváření fontů uvidíte už jen zřídka. Více informací je možné nalézt ve (velmi doporučené) odpovídající nápovědě.

TeXworks.

  TeXworks je TeXovsky orientovaný editor se zabudovaným prohlížečem PDF. Je již pro TeX Live nakonﬁgurován.

Nástroje příkazového řádku.

  Řada běžných unixových programů řízených z příkazového řádku je nainstalovaných pod Windows spolu s běžnými binárkami TeX Live. Ty zahrnují programy gzip, zip,unzip programy ze skupiny poppler (pdﬁnfo, pdﬀonts, …).

fc-listi, fc-cache, …

  Nástroj z knihovny fontconﬁg pomáhá XeTeXu najít systémové fonty pod Windows. Můžete použít fc-list k určení jmen fontů k předání příkazu XeTeXu \font s rozšířenou funkcionalitou. Pokud je to potřebné, nejdříve spusťte fc-cache k aktualizaci informací o fontech.

#### 6.3 Použití externích instalací Perlu, Tcl/Tk a Ghostscriptu

Normálně bude TeX Live rovněž pro skripty přidané v rámci TeX Live používat svůj vestavěný Perl, Tcl/Tk a Ghostscript. Pokud chcete použít vlastní externí verze, pak to můžete nakonﬁgurovat v souboru texmf.cnf v kořenovém adresáři instalace.

Pro Perl potřebujete přidat řádek

                    TEXLIVE_WINDOWS_TRY_EXTERNAL_PERL = 1

TeX Live (konkrétně bin/windows/runscript.tlu) pak bude hledat perl.exe na vyhledávací cestě, kromě skriptů, které patří do infrastruktury TeX Live. Toto je nejpravděpodobnější užitečné nastavení; ačkoli TeX Live Perl obsahuje mnoho dalších modulů, nemůže podporovat všechny skripty třetích stran.

Podobně pro Tcl/Tk potřebujete řádek

                    TEXLIVE_WINDOWS_TRY_EXTERNAL_TCL = 1

TeX Live pak bude hledat tclkit.exe, wish.exe, wish85.exe, wish86.exe a wish87.exe na vyhledávací cestě.

Ghostscript se zpracovává odlišně v tom, že musíte zadat název souboru nebo úplnou cestu k vašemu příkazovému řádku Ghostscript:

TEXLIVE_WINDOWS_EXTERNAL_GS = path of command-line ghostscript
Dalším rozdílem je, že Ghostscript dodáván s TeX Live je úplný, pouze s vynechanými dokumentací a ovladači tiskárny. Je tedy nepravděpodobné, že jej budete muset přepsat.

O texmf.cnf viz též oddíl 7.1.2.

#### 6.4 User Proﬁle je Home

Windowsovský protějšek domovského (home) adresáře Unixu je adresář %USERPROFILE%. Pod Windows Vista a pozdějšími je to C:\Users\<username>. V souboru texmf.cnf a obecně pro Kpathsea, se bude ~ expandovat přiměřeně v obou systémech Windows a Unix.

#### 6.5 Registry Windows

Windows ukládá téměř všechny konﬁgurační údaje do svých registrů. Registr obsahuje soubor hierarchicky uspořádaných klíčů s několika kořenovými klíči. Nejdůležitější pro instalační programy jsou stručně řečeno HKEY_CURRENT_USER a HKEY_LOCAL_MACHINE, HKCU a HKLM. Část HKCU registru je v domovském adresáři uživatele (viz sekci 6.4). HKLM je obvykle v podadresáři adresáře Windows.

V některých případech je možné získat systémové informace z proměnných prostředí, ale pro další informace, kupříkladu umístění zkratek, je nutné nahlédnout do registrů. Trvalé nastavení proměnných prostředí si rovněž vyžaduje přístup k registrům.

#### 6.6 Oprávnění Windows

V novějších verzích Windows se rozlišuje mezi běžnými uživateli a administrátory, když pouze posledně zmínění mají volný přístup k téměř celému operačnímu systému. Ve skutečnosti můžete tyto třídy uživatelů raději označit jako neprivilegovaní uživatelé a normální uživatelé: být administrátorem je pravidlo, ne výjimka. Snažili jsme se učinit TeX Live instalovatelným bez administrátorských práv.

Pokud je instalátor spuštěn s administrátorským oprávněním, je možnost instalovat i pro všechny uživatele počítače. Pokud je tato volba zvolena, odkazy (shortcuts) se vytvářejí pro všechny uživatele a systémová vyhledávací cesta se upravuje. Jinak jsou odkazy a položky nabídky vytvářeny pouze pro aktuálního uživatele a upravuje se jen jeho vyhledávací cesta.

Bez ohledu na status administrátora je standardní kořenový adresář TeX Live navržený instalačním programem vždy pod %SystemDrive%. Instalátor vždy testuje, zda je kořenový adresář zapisovatelný pro aktuálního uživatele.

Problém se může vyskytnout, pokud uživatel není administrátor a TeX již existuje ve vyhledávací cestě. Protože skutečná vyhledávací cesta sestává ze systémové vyhledávací cesty následované uživatelskou vyhledávací cestou, nový TeX Live by nikdy neměl získat přednost. Jako záložní opatření vytváří instalátor odkaz na příkazový řádek (command-prompt), ve kterém je adresář binárek nového TeX Live předřazený lokální vyhledávací cestě. Nový TeX Live bude pořád použitelný, když bude běžet v relaci příkazového řádku spuštěné z takového odkazu. Odkaz na TeXworks, pokud je nainstalován, rovněž předřadí TeX Live k vyhledávací cestě, proto by měl být imunní vůči tomuto problému cest.

Musíte si být vědomi, že dokonce i když jste přihlášen jako správce, musíte explicitně požádat o správcovská práva. Ve skutečnosti nemá význam přihlašovat se jako správce. Místo toho kliknutí pravým tlačítkem na program nebo odkaz, který chcete použít, vám obvykle nabídne volbu ,Spustit jako správce/Run as administrator‘.

#### 6.7 Zvětšení maxima paměti pod Windows a Cygwin

Uživatelé Windows a Cygwin (pro zvláštnosti instalace Cygwin viz oddíl 3.1.4) mohou zjistit, že při běhu některých programů dodaných s TeX Live, trpí nedostatkem paměti. Například asy zhavaruje pro nedostatek paměti, pokud se pokusíte alokovat pole 25,000,000 reálných čísel a LuaTeX může mít málo paměti, pokud zkusíte zpracovat dokument s velkým množstvím rozsáhlých fontů.

Pro Cygwin můžete zvětšit množství dostupné paměti podle návodu v příručce The Cygwin User’s Guide ( https://cygwin.com/cygwin-ug-net/setup-maxmem.html).

Pro Windows musíte vytvořit soubor, například moremem.reg, obsahující tyto čtyři řádky:

    Windows Registry Editor Version 5.00

    [HKEY_LOCAL_MACHINE\Software\Cygwin]
    "heap_chunk_in_mb"=dword:ffffff00

a pak spustit povel regedit /s moremem.reg jako administrátor. (Pokud si přejete změnit paměť pouze pro stávajícího uživatele místo všech, použijte HKEY_CURRENT_USER.)

### 7 Používateľská príručka ku systému Web2C

Web2C obsahuje množinu TeX-príbuzných programov, t. j. samotný TeX, Metafont, MetaPost, BibTeX atď. Je to srdce systému TeX Live. Domovská stránka Web2C, s aktuálnou príručkou a ďalšími vecami, je na https://tug.org/web2c.

Trochu histórie: originálna implementácia pochádza od Thomasa Rokického, ktorý v roku 1987 vyvinul prvý TeX-to-C systém založený na zmenových súboroch systému pre Unix, ktoré boli v prvom rade pôvodnou prácou Howarda Trickeya a Pavla Curtisa. Tim Morgan sa stal spravovateľom systému a počas jeho obdobia sa meno zmenilo na Web-to-C. V roku 1990 Karl Berry prebral túto prácu, asistoval pri tuctoch dodatočných príspevkov a v roku 1997 podal taktovku Olafovi Weberovi, ktorý ju v roku 2006 vrátil Karlovi.

Web2C systém beží pod Unixom, Windows, macOS a inými operačnými systémami. Používa originálne TeX zdrojové súbory od Donalda Knutha a ostatné základné programy napísané v systéme kultivovaného programovania WEB, ktoré sú preložené do zdrojového kódu jazyka C. Základné programy TeXu sú spracované týmto spôsobom:

bibtex

  Spravovanie bibliograﬁí.

dvicopy

  Vytváranie modiﬁkovanej kópie DVI súboru.

dvitomp

  Konverzia DVI do MPX (MetaPost obrázky).

dvitype

  Konverzia DVI do ľudsky čitateľného textu.

gftodvi

  Generovanie fontov pre náhľad.

gftopk

  Konverzia gf formátu fontov do pakovaných fontov.

gftype

  Konverzia gf formátu fontov do ľudsky čitateľného textu.

mf

  Metafont – vytváranie rodín fontov.

mft

  Preddeﬁnované Metafontové zdrojové súbory.

mpost

  MetaPost – tvorba technických diagramov.

patgen

  Vytváranie vzorov rozdeľovania slov.

pktogf

  Konverzia pakovaných formátov fontov do gf formátov.

pktype

  Konverzia pakovaných písiem do ľudsky čitateľného textu.

pltotf

  Konverzia ,Property list‘ do TFM.

pooltype

  Zobrazovanie ,WEB pool‘ súborov.

tangle

  Konverzia WEB súborov do Pascalu.

tex

  TeX – sadzba.

tftopl

  Konverzia TFM do ,property list‘.

vftovp

  Konverzia virtuálneho fontu do virtuálneho ,property list‘.

vptovf

  Konverzia virtuálneho ,property list‘ do virtuálneho fontu.

weave

  Konverzia WEB súborov do TeXu.

Presné funkcie a syntax týchto programov sú popísané v dokumentáciách jednotlivých balíkov alebo v dokumentácii Web2C. Napriek tomu, poznanie niekoľkých princípov, ktoré platia pre celý balík programov, vám pomôže vyťažiť čo najviac z vašej Web2C inštalácie.

Všetky programy dodržiavajú štandardné GNU voľby:

–help

  Vypisuje prehľad základného používania.

–version

  Vypisuje informáciu o verzii, potom skončí.

A väčšina tiež dodržiava:

–verbose

  Vypisuje detailnú správu spracovania.

Na vyhľadávanie súborov používajú Web2C programy prehľadávaciu knižnicu Kpathsea ( https://tug.org/kpathsea). Táto knižnica používa kombináciu premenných prostredia a niekoľkých konﬁguračných súborov na optimalizáciu prehľadávania adresárového stromu TeXu. Web2C zvládne prácu s viacerými adresárovými stromami súčasne, čo je užitočné, ak niekto chce udržiavať štandardnú distribúciu TeXu a jeho lokálne a osobné rozšírenia v rozličných stromoch. Na urýchlenie vyhľadávania súborov obsahuje koreň každého stromu súbor ls-R so záznamom obsahujúcim meno a relatívnu cestu ku všetkým súborom umiestneným pod týmto koreňom.

#### 7.1 Vyhľadávanie ciest knižnicou Kpathsea

Najprv popíšeme všeobecný mechanizmus vyhľadávania ciest knižnicou Kpathsea.

Vyhľadávacou cestou nazveme zoznam elementov cesty, ktorými sú v prvom rade mená adresárov oddelené dvojbodkou alebo bodkočiarkou. Vyhľadávacia cesta môže pochádzať z viacerých zdrojov. Pri vyhľadávaní súboru ,my-file‘ podľa cesty ,.:/dir‘, Kpathsea skontroluje každý element cesty: najprv ./my-file, potom /dir/my-file, vracajúc prvý zodpovedajúci nájdený prvok (alebo prípadne všetky zodpovedajúce prvky).

Aby bolo dosiahnuté prispôsobenie sa konvenciám čo možno najviac operačných systémov, na neunixových systémoch Kpathsea môže používať oddeľovače názvov súborov rôzne od dvojbodky (,:‘) a lomítka (,/‘).

Pri kontrolovaní určitého elementu cesty p Kpathsea najprv overí, či sa na naň nevzťahuje vopred vybudovaná databáza (pozri ,Databáza názvov súborov‘ na strane 85), t. j., či sa databáza nachádza v adresári, ktorý je preﬁxom p. Ak to tak je, špeciﬁkácia cesty sa porovnáva s obsahom databázy.

Hoci najjednoduchší a najbežnejší element cesty je meno adresáru, Kpathsea podporuje aj iné zdroje vo vyhľadávacích cestách: dedičné (layered) štandardné hodnoty, mená premenných prostredia, hodnoty súboru config, domáce adresáre používateľov a rekurzívne prehľadávanie podadresárov. Preto ak hovoríme, že Kpathsea rozbalí element cesty, znamená to, že pretransformuje všetky špeciﬁkácie do základného mena alebo mien adresárov. Toto je popísané v nasledujúcich odsekoch.

Všimnite si, že keď je meno hľadaného súboru vyjadrené absolútne alebo explicitne relatívne, t.j. začína ,/‘ alebo ,./‘ alebo ,../‘, Kpathsea jednoducho skontroluje, či taký súbor existuje.

##### 7.1.1 Zdroje cesty

Vyhľadávacia cesta môže byť vytvorená z rôznych zdrojov. Kpathsea ich používa v tomto poradí:

1. Používateľom nastavená premenná prostredia, napríklad TEXINPUTS. Premenné prostredia s pridanou bodkou a menom programu majú prednosť pred premennými rovnakého mena, ale bez prípony. Napríklad, keď ,latex‘ je meno práve bežiaceho programu, potom premenná TEXINPUTS.latex prepíše TEXINPUTS.

2. Programovo-špeciﬁcký konﬁguračný súbor, napríklad riadok ,S /a:/b‘ v súbore config.ps dvips.

3. Konﬁguračný súbor Kpathsea – texmf.cnf, obsahujúci riadok ako ,TEXINPUTS=/c:/d‘ (pozri ďalej).

4. Predvolené hodnoty počas kompilácie.

Všetky tieto hodnoty vyhľadávacej cesty môžete prezerať použitím ladiacích možností (pozri ,Ladenie‘ na strane 90).

##### 7.1.2 Konﬁguračné súbory

Kpathsea číta počas behu z konﬁguračných súborov s menom texmf.cnf vyhľadávaciu cestu a ďalšie deﬁnície. Vyhľadávacia cesta TEXMFCNF sa používa na hľadanie týchto súborov, ale neodporúčame nastavovať túto (ani žiadnu inú) premennú prostredia na prepísanie systémových adresárov.

Namiesto toho normálna inštalácia vyústi do súboru .../2024/texmf.cnf. Ak musíte vykonať zmeny implicitných nastavení (obyčajne to nie je nutné), toto je miesto, kam sa majú vložiť. Hlavný konﬁguračný súbor je .../2024/texmf-dist/web2c/texmf.cnf. Nesmiete editovať tento neskorší súbor, pretože vaše zmeny budú stratené pri obnove šírenej verzie.

Ak chcete iba pridať osobný adresár do konkrétnej cesty vyhľadávania, je rozumné nastavenie premennej prostredia:

       TEXINPUTS =.:/my/macro/dir:

Ak chcete zachovať udržiavateľnosť a prenosnosť nastavenia v priebehu rokov, použite koncové ‘:’ (‘;’ v systéme Windows) na vloženie systémových ciest, namiesto toho, aby sa ich všetky snažili napísať explicitne (viď oddiel 7.1.4). Ďalšou možnosťou je použitie stromu TEXMFHOME (viď oddiel 3.2.3).

Všetky súbory texmf.cnf vo vyhľadávacej ceste budú prečítané a deﬁnície v starších súboroch prepíšu deﬁnície v novších súboroch. Napríklad, pri vyhľadávacej ceste .:$TEXMF, hodnoty z ./texmf.cnf prepíšu hodnoty z $TEXMF/texmf.cnf.

- Komentáre začínajú znakom ,%‘ buď na začiatku riadku alebo s medzerou pred ním a pokračujú do konca riadku.

- Prázdne riadky sú ignorované.

- Znak \ na konci riadku slúži ako pokračovací znak, t. j. nasledujúci riadok je k nemu pripojený. Prázdne znaky na začiatku pripájaných riadkov nie sú ignorované.

- Všetky ostatné riadky majú tvar:
  variable [.progname] [=] value
  kde ,=‘ a prázdne znaky naokolo sú nepovinné. (Ale ak value začína znakom ‘.’, je najjednoduchšie použiť ‘=’, aby sa predišlo interpretácii bodky ako kvaliﬁkátora názvu programu).

- Názov premennej ,variable‘ môže obsahovať akékoľvek znaky okrem prázdnych znakov, ,=‘, alebo ,.‘, ale najbezpečnejšie je obmedziť sa na znaky ,A-Za-z_‘.

- Ak je ,.progname‘ neprázdne, deﬁnícia sa použije iba vtedy, keď práve bežiaci program má meno progname alebo progname.exe. Toto umožňuje napríklad mať pre rôzne nadstavby TeXu rôzne vyhľadávacie cesty.

- Hodnoty ,value‘ uvažované ako reťazce môžu obsahovať akýkoľvek znak. V praxi však väčšina hodnôt texmf.cnf súvisí s rozvinutím cesty a keďže v expanzii používajú rôzne špeciálne znaky (viď oddiel 7.1.7), ako napríklad zátvorky alebo čiarky, nemôžu byť použité v názvoch adresárov.

  Znak ,;‘ vo ,value‘ je preložený do ,:‘, ak sme pod operačným systémom Unix. Toto je užitočné, keď chceme mať jediný súbor texmf.cnf pre obidva systémy Unix a Windows. Táto transformácia nastane s akoukoľvek hodnotou, nielen s vyhľadávacou cestou, ale našťastie v praxi nie je ,;‘ potrebný v iných hodnotách.

  Funkcia $var.prog nie je na pravej strane dostupná; namiesto nej musíte použiť dodatočnú premennú.

- Všetky deﬁnície sú prečítané skôr, ako sa expandujú. Preto môžu existovať referencie na premenné skôr, ako sú tieto deﬁnované.

Ukážkový úsek konﬁguračného súboru, ilustrujúci väčšinu týchto bodov:

    TEXMF              = {$TEXMFLOCAL,!!$TEXMFMAIN}

    TEXINPUTS.latex    = .;$TEXMF/tex/{latex,generic;}//

    TEXINPUTS.fontinst = .;$TEXMF/tex//;$TEXMF/fonts/afm//

    % e-TeX related files

    TEXINPUTS.elatex   = .;$TEXMF/{etex,tex}/{latex,generic;}//

    TEXINPUTS.etex     = .;$TEXMF/{etex,tex}/{eplain,plain,generic;}//

##### 7.1.3 Expanzia cesty

Kpathsea rozpoznáva určité zvláštne znaky a konštrukcie vo vyhľadávacích cestách podobné tým, čo existujú v prostrediach unixovských interprétov príkazového riadku (shells). Ako všeobecný príklad uvedieme cestu ~$USER/{foo,bar}//baz, ktorá sa expanduje do všetkých podadresárov pod adresármi foo a bar v domovskom adresári používateľa $USER, ktorý obsahuje adresár alebo súbor baz. Tieto konštrukcie sú popísané v ďalších odsekoch.

##### 7.1.4 Predvolená expanzia

Ak vyhľadávacia cesta s najväčšou prioritou (pozri ,Zdroje cesty‘ na strane 78) obsahuje dvojbodku navyše (t. j. začiatočnú, koncovú, alebo zdvojenú), Kpathsea vloží na toto miesto vyhľadávaciu cestu s druhou najvyššou prioritou, ktorá je deﬁnovaná. Ak táto vložená cesta obsahuje dvojbodku navyše, to isté sa stane s ďalšou najvýznamnejšou cestou. Keby sme mali napríklad dané takéto nastavenie premennej prostredia

>> setenv TEXINPUTS /home/karl:
a hodnotu TEXINPUTS v súbore texmf.cnf
.:$TEXMF//tex
potom konečná hodnota použitá na vyhľadávanie by bola:
/home/karl:.:$TEXMF//tex
Keďže by bolo zbytočné vkladať predvolenú hodnotu na viac ako jedno miesto, Kpathsea mení iba nadbytočnú ,:‘ a všetko ostatné ponecháva na mieste. Najprv kontroluje začiatočnú ,:‘, potom koncovú ,:‘ a potom zdvojenú ,:‘.

##### 7.1.5 Expanzia zátvoriek

Užitočná črta je expanzia zátvoriek, ktorá funguje tak, že napríklad v{a,b}w sa expanduje na vaw:vbw. Vnáranie je povolené. Toto sa používa na implementáciu viacnásobných TeXovských hierarchií, priradením hodnoty $TEXMF s použitím zátvoriek. V dodanom súbore texmf.cnf nájdete deﬁníciu podobnú tejto (zjednodušenú pre tento príklad):

         TEXMF = {$TEXMFVAR,$TEXMFHOME,!!$TEXMFLOCAL,!!$TEXMFDIST}

Použijeme to potom na deﬁnovanie, napríklad, TeXovskej cesty pre vstupy:

         TEXINPUTS = .;$TEXMF/tex//

bude to znamenať, že po hľadaní v aktuálnom adresári sa najprv prehľadajú stromy $TEXMFVAR/tex, $TEXMFHOME/tex, $TEXMFLOCAL/tex a $TEXMFDIST/tex (posledné dva s použitím databázových súborov ls-R).

##### 7.1.6 Expanzia podadresárov

Dva alebo viac za sebou nasledujúcich znakov ,/‘ v elemente cesty nasledujúcom za adresárom d je nahradených všetkými podadresármi d: najprv podadresármi priamo pod d, potom podadresármi pod nimi atď. Poradie, v akom sú prehľadávané podadresáre na každej úrovni, nie je špeciﬁkované.

Ak po ,//‘ špeciﬁkujete akékoľvek komponenty mena súboru, pridajú sa iba podadresáre so zodpovedajúcimi komponentami. Napríklad ,/a//b‘ sa expanduje do adresárov /a/1/b, /a/2/b, /a/1/1/b, atď, ale nie do /a/b/c alebo /a/1.

Viacnásobné konštrukcie ,//‘ v ceste sú možné, ale použitie ,//‘ na začiatku cesty je ignorované.

##### 7.1.7 Zhrnutie špeciálnych znakov v súboroch texmf.cnf

Nasledujúci zoznam zahŕňa špeciálne znaky a konštrukcie v konﬁguračných súboroch Kpathsea.

:

  Oddeľovač v špeciﬁkácii cesty; na začiatku alebo na konci cesty, alebo zdvojený uprostred, nahrádza predvolenú expanziu cesty.

;

  Oddeľovač v neunixových systémoch (správa sa ako ,:‘).

$

  Expanzia premennej.

~

  Reprezentuje domovský adresár používateľa.

{...}

  Expanzia zátvoriek, napr. z a{1,2}b sa stane a1b:a2b.

,

  Oddeľuje členy v expanzii zátvoriek.

//

  Expanzia podadresárov. (Môže sa vyskytnúť kdekoľvek v ceste, okrem jej začiatku.)

% a #

  Začiatok komentáru.

\

  Na konci riadku, znak pokračovania na umožnenie viacriadkových vstupov.

!!

  Povel na hľadanie súboru iba v databáze, neprehľadáva disk.

Kedy presne bude znak považovaný za špeciálny alebo bude predstavovať samého seba závisí od kontextu, v ktorom sa používa. Pravidlá sú obsiahnuté vo viacerých úrovniach interpretácie konﬁgurácie (analýza, expanzia, vyhľadávanie, …), a preto, nanešťastie, to nie je možné stručne ustanoviť. Neexistuje žiadny všeobecný únikový mechanizmus; konkrétne, ‘\’ nie je „únikový znak“ v súboroch texmf.cnf.

Pokiaľ ide o výber názvov adresárov na inštaláciu, je najbezpečnejšie vyhnúť sa im všetkým.

#### 7.2 Databázy názvov súborov

Kpathsea minimalizuje prístupy na disk pri vyhľadávaní. Predsa však pri štandardnej alebo ľubovoľnej inštalácii s dostatočným množstvom adresárov, vyhľadávanie súboru v každom možnom adresári môže zabrať prehnane veľa času. Kpathsea preto môže používať externe vytvorený ,databázový‘ súbor nazývaný ls-R, ktorý mapuje súbory v adresároch a pomáha tak vyhnúť sa vyčerpávajúcemu prehľadávaniu disku.

A second database ﬁle aliases allows you to give additional names to the ﬁles listed in ls-R.

Druhý databázový súbor (aliases) vám umožňujú dať dodatočné mená súborom nachádzajúcim sa v zozname ls-R.

##### 7.2.1 Súborová databáza

Ako bolo vysvetlené hore, meno hlavnej databázy súborov musí byť ls-R. Môžete umiestniť jednu do koreňa každej hierarchie TeXu vo svojej inštalácii, ktorú chcete, aby bola prehľadávaná (predvolená je $TEXMF). Kpathsea hľadá ls-R súbory podľa cesty v TEXMFDBS.

Odporúčaný spôsob, ako vytvoriť a udržiavať ‘ls-R’, je spustiť skript mktexlsr zahrnutý v distribúcii. Je vyvolávaný rôznymi ,mktex...‘ skriptami. Tento skript v princípe iba spúšťa príkaz

cd /your/texmf/root && \ls -1LAR ./ >ls-R
predpokladajúc, že ls vášho systému vytvára správny výstup (výstup GNU ls je v poriadku). Aby ste sa ubezpečili, že databáza bude vždy aktuálna, najjednoduchšie je pravidelne ju prebudovávať cez cron, takže po zmenách v inštalovaných súboroch – napríklad pri inštalácii alebo aktualizácii balíka LaTeXu – bude súbor ls-R automaticky aktualizovaný.

Ak súbor nie je v databáze nájdený, podľa predvoleného nastavenia Kpathsea začne vyhľadávať na disku. Ak však určitý element cesty začína ,!!‘, bude prehľadávaná iba databáza, nikdy nie disk.

##### 7.2.2 kpsewhich: samostatné prehľadávanie cesty

Program kpsewhich vykonáva prehľadávanie cesty nezávislé od každej aplikácie. Môže byť užitočný ako vyhľadávací find program na nájdenie súborov v hierarchiách TeXu (veľmi sa využíva v distribuovaných ,mktex‘… skriptoch).

>> kpsewhich option… ﬁlename…
Voľby špeciﬁkované v ,option‘ môžu začínať buď ,-‘ alebo ,--‘ a každá skratka, ktorá nie je viacznačná, je akceptovaná.

Kpathsea považuje každý element vstupného riadku, ktorý nie je argumentom nejakej voľby, za meno súboru, ktorý hľadá, a vracia prvý súbor, ktorý nájde. Neexistuje voľba umožňujúca vrátiť všetky súbory s určitým menom (na to môžete použiť nástroj Unixu ,find‘).

Najbežnejšie voľby sú popísané nižšie.

–dpi=num

  Nastav rozlíšenie na ,num‘; toto má vplyv iba na ,gf‘ a ,pk‘ vyhľadávanie. ,-D‘ je synonymom, kvôli kompatibilite s dvips. Predvolená hodnota je 600.

–format=name

  Nastav formát na vyhľadávanie na ,name‘. Podľa predvoleného nastavenia je formát uhádnutý z mena súboru. Pre formáty, ktoré nemajú asociovanú jednoznačnú príponu, ako napríklad podporné súbory MetaPostu a konﬁguračné súbory dvips, musíte špeciﬁkovať meno, ako známe pre Kpathsea, také ako tex alebo enc files. Zoznam získate spustením kpsewhich --help-formats.

–mode=string

  Nastav meno módu na ,string‘; toto má vplyv iba na ,gf‘ a ,pk‘ vyhľadávanie. Žiadna predvolená hodnota: každý mód bude nájdený.

–must-exist

  Urob všetko preto, aby si našiel súbory. Ak je to potrebné, vrátane hľadania na disku. Normálne je v záujme efektívnosti prehľadávaná iba databáza ls-R.

–path=string

  Vyhľadávaj podľa cesty ,string‘ (oddeľovaná dvojbodkou ako zvyčajne) namiesto hádania vyhľadávacej cesty z mena súboru. Podporované sú ,//‘ a všetky bežné expanzie. Voľby ,–path‘ a ,–format‘ sa vzájomne vylučujú.

–progname=name

  Nastav meno programu na ,name‘. Toto nastavenie ovplyvňuje použitie vyhľadávacej cesty cez nastavenie ,.progname‘ v konﬁguračných súboroch. Predvolená hodnota je ,kpsewhich‘.

–show-path=name

  Zobrazí cestu použitú na vyhľadávanie súboru s typom ,name‘. Môže byť použitá buď súborová prípona (,.pk‘, ,.vf‘ a pod.) alebo meno, podobne ako vo voľbe ,–format‘.

–debug=num

  Nastaví masku výberu ladiacích možností na ,num‘.

##### 7.2.3 Príklady použitia

Pozrime sa na Kpathsea v akcii. Za podčiarknutým príkazom nasleduje výsledok vyhľadávania v nasledujúcich riadkoch.

> kpsewhich article.cls
/usr/local/texmf-dist/tex/latex/base/article.cls
Hľadáme súbor article.cls. Keďže prípona ,.cls‘ je jednoznačná, nemusíme špeciﬁkovať, že hľadáme súbor typu ,tex‘ (zdrojový súbor TeX). Nájdeme ho v podadresári tex/latex/base pod koreňovým adresárom ,TEXMF-dist‘. Podobne všetky nasledujúce súbory budú nájdené bez problémov vďaka ich jednoznačnej prípone.
> kpsewhich array.sty
/usr/local/texmf-dist/tex/latex/tools/array.sty
> kpsewhich latin1.def
/usr/local/texmf-dist/tex/latex/base/latin1.def
> kpsewhich size10.clo
/usr/local/texmf-dist/tex/latex/base/size10.clo
> kpsewhich small2e.tex
/usr/local/texmf-dist/tex/latex/base/small2e.tex
> kpsewhich tugboat.bib
/usr/local/texmf-dist/bibtex/bib/beebe/tugboat.bib

Mimochodom, posledným súborom je bibliograﬁcká databáza BibTeXu pre články TUGBoatu.

> kpsewhich cmr10.pk
Bitmapové súbory fontov typu .pk sa používajú zobrazovacími programami ako dvips a xdvi. V tomto prípade je vrátený prázdny výsledok, keďže neexistujú žiadne vopred generované Computer Modern ,.pk‘ súbory v našom systéme (vzhľadom na to, že v TeX Live implicitne používame verzie Type1 ).
> kpsewhich wsuipa10.pk
/usr/local/texmf-var/fonts/pk/ljfour/public/wsuipa/wsuipa10.600pk
Pre tieto fonty (fonetickú abecedu z University of Washington) sme museli vygenerovať ,.pk‘ súbory. Keďže predvolený mód Metafontu v našej inštalácii je ljfour so základným rozlíšením 600 dpi (dots per inch), je vrátená táto inštancia.
> kpsewhich -dpi=300 wsuipa10.pk
V tomto prípade po špeciﬁkovaní, že nás zaujíma rozlíšenie 300 dpi (-dpi=300), vidíme, že taký font nie je v systéme k dispozícii. Programy ako dvips alebo xdvi by v tomto prípade vytvorili požadované .pk súbory, použijúc skript mktexpk.

Teraz obráťme našu pozornosť na hlavičkové a konﬁguračné súbory dvips. Najprv sa pozrieme na jeden z bežne používaných súborov, všeobecný prológový tex.pro na podporu TeXu, potom pohľadáme konﬁguračný súbor (config.ps) a PostScriptovú mapu fontov psfonts.map – mapové a kódové súbory majú svoje vlastné cesty na vyhľadávanie a nové umiestnenie v stromoch texmf. Keďže prípona ,.ps‘ je nejednoznačná, musíme pre súbor config.ps špeciﬁkovať explicitne, o ktorý typ sa zaujímame (dvips config).

> kpsewhich tex.pro
/usr/local/texmf/dvips/base/tex.pro
> kpsewhich –format=‘dvips config’ config.ps
/usr/local/texmf/dvips/config/config.ps
> kpsewhich psfonts.map
/usr/local/texmf/fonts/map/dvips/updmap/psfonts.map
Teraz sa pozrieme na podporné súbory URW Times PostScript. V Berryho schéme meno pre tieto pomenovania fontov je „utm“. Prvý súbor, ktorý hľadáme, je konﬁguračný súbor, ktorý obsahuje meno mapového súboru:
> kpsewhich –format="dvips config" config.utm
/usr/local/texmf-dist/dvips/psnfss/config.utm
Obsah tohoto súboru je
p +utm.map
čo odkazuje na súbor utm.map, ktorý ideme ďalej hľadať.
> kpsewhich utm.map
/usr/local/texmf-dist/fonts/map/dvips/times/utm.map
Tento mapový súbor deﬁnuje mená súborov fontov typu Type1 PostScript v kolekcii URW. Jeho obsah vyzerá takto (zobrazili sme iba jeho časť):
utmb8r NimbusRomNo9L-Medi ... <utmb8a.pfb
utmbi8r NimbusRomNo9L-MediItal... <utmbi8a.pfb
utmr8r NimbusRomNo9L-Regu ... <utmr8a.pfb
utmri8r NimbusRomNo9L-ReguItal... <utmri8a.pfb
utmbo8r NimbusRomNo9L-Medi ... <utmb8a.pfb
utmro8r NimbusRomNo9L-Regu ... <utmr8a.pfb
Zoberme napríklad inštanciu Times Regular utmr8a.pfb a nájdime jej pozíciu v adresárovom strome texmf použitím vyhľadávania fontových súborov Type1:
> kpsewhich utmr8a.pfb
/usr/local/texmf-dist/fonts/type1/urw/times/utmr8a.pfb

Z týchto príkladov by malo byť zrejmé, ako ľahko môžete nájsť umiestnenie daného súboru. Toto je zvlášť dôležité, keď máte podozrenie, že ste narazili na zlú verziu súboru, pretože kpsewhich emuluje vyhľadávanie úplne rovnakým spôsobom ako skutočný program (TeX, dvips a pod).

##### 7.2.4 Ladiace činnosti

Niekedy je potrebné vyšetriť, ako program rozpoznáva referencie na súbory. Aby toto bolo možné vhodne uskutočniť, Kpathsea ponúka rôzne stupne ladenia:

- Volania stat (testy súborov). Pri behu s aktuálnou ls-R databázou by nemal dať takmer žiaden výstup.

- Referencie do hašovacích tabuliek (ako ls-R databázy, mapové súbory, konﬁguračné súbory).

- Operácie otvárania a zatvárania súboru.

- Všeobecná informácia o ceste pre typy súborov hľadaných Kpathsea. Toto je užitočné pri zisťovaní, kde bola deﬁnovaná určitá cesta pre daný súbor.

- Adresárový zoznam pre každý element cesty (vzťahuje sa iba na vyhľadávanie na disku).

- Vyhľadávanie súborov.

- Premenlivé hodnoty.

Hodnota -1 nastaví všetky horeuvedené voľby, v praxi pravdepodobne vždy použijete tieto úrovne, ak budete potrebovať akékoľvek ladenie.

Podobne s programom dvips nastavením kombinácie ladiacich prepínačov môžete detailne sledovať, odkiaľ sa berú používané súbory. Aktuálny popis parametrov je možné nájsť v ../texmf/doc/html/dvips/dvips_2.html. Alternatívne, keď súbor nie je nájdený, ladiaca cesta ukazuje, v ktorých adresároch program daný súbor hľadal, čo môže naznačovať, v čom sa asi vyskytol problém. Všeobecne povedané, keďže väčšina programov volá knižnicu Kpathsea vnútorne, ladiace voľby je možné nastaviť pomocou premennej prostredia KPATHSEA_DEBUG na potrebnú kombináciu, ako je to popísané v horeuvedenom zozname. (Poznámka pre používateľov Windows: nie je jednoduché presmerovať všetky hlášky v tomto systéme do súboru. Na diagnostické účely môžete dočasne priradiť
SET KPATHSEA_DEBUG_OUTPUT=err.log.) Uvažujme ako príklad malý zdrojový súbor LaTeXu, hello-world.tex, ktorý obsahuje nasledujúci vstup.

         \documentclass{article}
      \begin{document}
      Hello World!
      \end{document}

Tento malý súbor používa iba font cmr10, takže pozrime sa, ako dvips pripravuje PostScriptový súbor (chceme použiť Type1 verziu písiem Computer Modern, preto je nastavená voľba -Pcms 1.

> dvips -d4100 hello-world -Pcms -o
V tomto prípade sme skombinovali dvips ladiacu triedu 4 (cesty k fontom) s expanziou elementu cesty Kpathsea (pozri Referenčnú príručku dvips). Výstup, trochu preusporiadaný, je zobrazený na obrázku 12.

debug:start search(file=texmf.cnf, must_exist=1, find_all=1,
path=.:/usr/local/bin/texlive:/usr/local/bin:
/usr/local/bin/texmf/web2c:/usr/local:
/usr/local/texmf/web2c:/.:/./teTeX/TeX/texmf/web2c:).
kdebug:start search(file=ls-R, must_exist=1, find_all=1,
path=~/tex:/usr/local/texmf).
kdebug:search(ls-R) =>/usr/local/texmf/ls-R
kdebug:start search(file=aliases, must_exist=1, find_all=1,
path=~/tex:/usr/local/texmf).
kdebug:search(aliases) => /usr/local/texmf/aliases
kdebug:start search(file=config.ps, must_exist=0, find_all=0,
path=.:~/tex:!!/usr/local/texmf/dvips//).
kdebug:search(config.ps) => /usr/local/texmf/dvips/config/config.ps
kdebug:start search(file=/root/.dvipsrc, must_exist=0, find_all=0,
path=.:~/tex:!!/usr/local/texmf/dvips//).
search(file=/home/goossens/.dvipsrc, must_exist=1, find_all=0,
path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//).
kdebug:search($HOME/.dvipsrc) =>
kdebug:start search(file=config.cms, must_exist=0, find_all=0,
path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//).
kdebug:search(config.cms)
=>/usr/local/texmf/dvips/cms/config.cms
Obr. 12: Vyhľadávanie konﬁguračných súborov

dvips začne lokáciou svojich pracovných súborov. Najprv je nájdený texmf.cnf, ktorý obsahuje deﬁnície vyhľadávacích ciest ostatných súborov, potom databáza súborov ls-R (na optimalizáciu vyhľadávania súborov) a skratky mien súborov (aliases), čo robí možným deklarovať viacero mien (napr. krátke meno typu ,8.3‘ ako v DOSe a dlhšiu prirodzenejšiu verziu) pre ten istý súbor. Potom dvips pokračuje v hľadaní všeobecného konﬁguračného súboru config.ps skôr, ako začne hľadať súbor nastavení .dvipsrc (ktorý, v tomto prípade, nie je nájdený). Nakoniec, dvips nájde konﬁguračný súbor pre font Computer Modern PostScript, config.cms (toto bolo iniciované voľbou-Pcms v príkaze dvips). Tento súbor obsahuje zoznam „mapových“ súborov, ktoré deﬁnujú vzťah medzi menami fontov v TeXu, PostScripte a systéme súborov.

> more /usr/local/texmf/dvips/cms/config.cms
p +ams.map
p +cms.map
p +cmbkm.map
p +amsbkm.map
dvips preto pokračuje v hľadaní všetkých týchto súborov plus všeobecného mapového súboru psfonts.map, ktorý sa načíta vždy (obsahuje deklarácie bežne používaných PostScriptových fontov; pozri poslednú časť sekcie 7.2.3, kde sa nachádza viac detailov o narábaní s mapovými súbormi PostScriptu).

V tomto bode sa dvips identiﬁkuje používateľovi …

This is dvips(k) 5.92b Copyright 2002 Radical Eye Software
…potom pokračuje v hľadaní prológového súboru texc.pro:
kdebug:start search(file=texc.pro, must_exist=0, find_all=0,
path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
kdebug:search(texc.pro) => /usr/local/texmf/dvips/base/texc.pro

Po nájdení tohoto súboru dvips vypíše na výstup dátum a čas a informuje nás, že vygeneruje súbor hello-world.ps, že potrebuje súbor s fontom cmr10, ktorý bude deklarovaný ako „rezidentný“:

TeX output 1998.02.26:1204’ -> hello-world.ps
Defining font () cmr10 at 10.0pt
Font cmr10 <CMR10> is resident.
Teraz sa rozbehne hľadanie súboru cmr10.tfm, ktorý je nájdený, potom je referencovaných ešte niekoľko prológových súborov (nezobrazené) a nakoniec je nájdená inštancia fontu Type1, cmr10.pfb, ktorá je pridaná do výstupného súboru (pozri posledný riadok).
kdebug:start search(file=cmr10.tfm, must_exist=1, find_all=0,
path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:
/var/tex/fonts/tfm//).
kdebug:search(cmr10.tfm) => /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm
kdebug:start search(file=texps.pro, must_exist=0, find_all=0,
...
<texps.pro>
kdebug:start search(file=cmr10.pfb, must_exist=0, find_all=0,
path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
kdebug:search(cmr10.pfb) => /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb
<cmr10.pfb>[1]

#### 7.3 Možnosti nastavenia za behu programu

Ďalšou z pekných čŕt distribúcie Web2C je možnosť kontroly množstva pamäťových parametrov (najmä veľkosti polí) za behu prostredníctvom súboru texmf.cnf, ktorý číta knižnica Kpathsea. Nastavenia všetkých parametrov môžete nájsť v časti 3 tohto súboru. Najdôležitejšie riadiace premenné (čísla riadkov sa vzťahujú na súbor texmf.cnf):

main_memory

  Celkový počet dostupných slov v pamäti pre TeX, Metafont a MetaPost. Musíte vytvoriť nový formátový súbor pre každé odlišné nastavenie. Napríklad môžete vygenerovať „obrovskú“ verziu TeXu a zavolať súbor s formátom hugetex.fmt. S použitím štandardnej špeciﬁkácie mena programu používaného knižnicou Kpathsea, konkrétna hodnota premennej main_memory sa načíta zo súboru texmf.cnf.

extra_mem_bot

  Dodatočný priestor pre „veľké“ dátové štruktúry TeXu: „boxy“, „glue“, „breakpoint(y)“ a podobne. Je to užitočné hlavne ak používate PI CTeX.

font_mem_size

  Počet dostupných slov pre informáciu o fontoch v TeXu. Toto je viac-menej celková veľkosť všetkých prečítaných TFM súborov.

hash_extra

  Dodatočný priestor pre hašovaciu tabuľku mien riadiacej sekvencie, jeho implicitná hodnota je 600000.

Tento prvok nemôže nahradiť naozajstné dynamické polia a alokácie pamäte, ale keďže tieto sa veľmi ťažko implementujú v súčasnej verzii TeXu, tieto parametre počas behu programu poskytujú praktický kompromis, ktorý dovoľuje aspoň nejakú ﬂexibilitu.

#### 7.4 $TEXMFDOTDIR

Na rôznych miestach uvedených vyššie sme uviedli rôzne cesty vyhľadávania začínajúce znakom . (na vyhľadávanie najprv v aktuálnom adresári), ako v

TEXINPUTS=.;$TEXMF/tex//

Toto je zjednodušenie. Súbor texmf.cnf, ktorý je súčasťou distribúcie TeX Live používa $TEXMFDOTDIR namiesto jednoduchého ‘.’, ako v:

TEXINPUTS=$TEXMFDOTDIR;$TEXMF/tex//
(V dodanom súbore je aj druhý prvok cesty o niečo komplikovanejší ako $TEXMF/tex//. Ale to je drobnosť; na tomto mieste chceme pojednať o črte $TEXMFDOTDIR.)

Dôvod na použitie premennej $TEXMFDOTDIR v deﬁníciach ciest namiesto jednoduchého ‘.’ je čisto taký, že môže byť prepísaný. Napríklad zložitý dokument môže pozostávať z mnohých zdrojových súborov uložených vo viacerých podadresároch. Aby ste to zvládli, môžete nastaviť TEXMFDOTDIR na .// (napríklad, v prostredí keď zostavujete dokument) a všetky budú prehľadávané. (Upozornenie: nepoužívajte .// ako implicitné nastavenie; je to zvyčajne veľmi nežiadúce a potenciálne nezabezpečené, aby ste hľadali hocijaký dokument vo všetkých podadresároch.)

As another example, you may wish not to search the current directory at all, e.g., if you have arranged for all the ﬁles to be found via explicit paths. You can set $TEXMFDOTDIR to, say, /nonesuch or any other nonexistent directory for this.

Ďalším príkladom je, že nebudete chcieť vôbec prehľadávať aktuálny adresár, napríklad, ak ste zariadili, aby sa všetky súbory našli prostredníctvom explicitných ciest. Môžete nastaviť $TEXMFDOTDIR, napríklad, na /nonesuch alebo na akýkoľvek neexistujúci adresár.

Implicitná hodnota $TEXMFDOTDIR je jednoducho ‘.’, ako je to nastavené v našom súbore texmf.cnf.

### 8 Poděkování

TeX Live je výsledkem společného úsilí téměř všech skupin uživatelů TeXu. Toto vydání TeX Live redigoval Karl Berry. Seznam ostatních hlavních přispěvatelů, minulých i současných, následuje. Děkujeme:

- Anglickému, německému, holandskému a polskému sdružení uživatelů TeXu (TUG, DANTE e.V., NTG resp. GUST), kteří společně zajistili nezbytnou technickou a administrativní infrastrukturu. Připojte se, prosím, k TeXovskému sdružení ve vaší blízkosti (CSTUG, https://www.cstug.cz), v jehož gesci vznikl i tento překlad! (Viz https://tug.org/usergroups.html.)

- Týmu CTANu ( https://ctan.org), který distribuuje obrazy TeX Live a poskytuje společnou infrastrukturu pro aktualizaci balíků, na kterých je TeX Live závislý.

- Nelsonu Beebemu, který zpřístupnil mnohé platformy vývojařům TeX Live a za jeho vlastní obsáhlé testování a bezpříkladné bibliogtraﬁcké úsilí.

- Johnu Bowmanovi za vykonání mnoha změn v jeho pokročilém graﬁckém programu Asymptote, aby fungoval v TeX Live.

- Peteru Breitenlohnerovi a e-TeX týmu, kteří poskytují stabilní základ budoucnosti TeXu, a výslovně Peterovi za skvělou pomoc s používáním osobních nástrojů GNU a udržování zdrojů v aktuálním stavu. Peter zemřel v říjnu 2015 a pokračující dílo věnujeme jeho památce.

- Jin-Hwan Choovi a celému týmu DVIPDFMx za jejich vynikající ovladač a za schopnost reagovat na konﬁgurační problémy.

- Thomasi Esserovi za překrásný balík teTeX, bez něhož by TeX Live nikdy neexistoval.

- Michelu Goossensovi, který je spoluautorem původní dokumentace.

- Eitanu Gurarimu, jehož TeX4ht je použito pro HTML verzi této dokumentace a který každý rok obratem neúnavně pracoval na jeho rozšířeních. Eitan nás předčasně opustil v červnu 2009 a tuto dokumentaci věnujeme jeho památce.

- Hansi Hagenovi za mnohá testování a přípravu jeho balíku ConTeXt ( https://pragma-ade.com) pracujícího uvnitř systému TeX Live a za neustály rozvoj TeXu.

- Hàn Thế Thànhovi, Martinu Schröderovi a pdfTeX týmu ( http://pdftex.org) za pokračující rozšiřování možností TeXu.

- Hartmutu Henkelovi za významný příspěvek k vývoji pdfTeXu, LuaTeXu atp.

- Shunshaku Hirata, za originálnejší a pokračování práce na DVIPDFMx.

- Tacu Hoekwaterovi za významné úsilí při obnovení vývoje MetaPostu i samotného (Lua)TeXu ( http://luatex.org), za začlenění ConTeXtu do systému TeX Live, za přidání vícevláknové funkčnosti programu Kpathsea a mnoho dalšího.

- Khaledu Hosnymu, za podstatnou práci na XeTeXu, DVIPDFMx a za úsilí s arabskými i jinými fonty.

- Pawłu Jackowskému za windowsový instalátor tlpm a Tomaszi Łuczakovi za tlpmgui, používaný v předchozích vydáních.

- Akiru Kakutovi, za poskytnutí windowsovských binárek z jeho distribucí W32TEX a W64TEX pro japonský TeX ( http://w32tex.org) a za množství dalších příspěvků k vývoji.

- Jonathanu Kewovi a SIL za vyvinutí pozoruhodného systému XeTeX a za čas a trápení při jeho integraci do TeX Live, stejně tak za výchozí verzi instalačního programu MacTeX a kromě toho za námi doporučený pomocný program TeXworks.

- Hironorimu Kitagawa za údržbu (e)pTeXu a související podporu.

- Dicku Kochovi za údržbu MacTeXu ( http://tug.org/mactex) ve velmi blízkém tandemu s TeX Live a za jeho skvělý přístup.

- Reinhardu Kotuchovi za důležitý příspěvek k infrastruktuře a instalačnímu programu TeX Live 2008, rovněž za úsilí při výzkumu Windows, za skript getnonfreefonts a mnoho dalšího.

- Siep Kroonenbergové rovněž za důležitý příspěvek k infrastruktuře a instalačnímu programu TeX Live 2008, zvláště pod Windows, a za množství práce při aktualizaci této příručky, popisující tyto vlastnosti.

- Clerku Ma za opravu a rozšíření stroje.

- Mojce Miklavec za množství pomoci s ConTeXtem, vybudování mnoha souborů binárek a mnohem víc.

- Heikovi Oberdiekovi za balík epstopdf a mnohé další, za kompresi velikých datových souborů pst-geo tak, že jsme je mohli zařadit do instalace, a především za jeho mimořádnou práci na balíku hyperref.

- Phelypemu Oleiniku za skupinově oddělený \input pro různé stroje v roce 2020 a mnohé další.

- Petru Olšákovi, který velmi pečlivě kontroloval svou českou a slovenskou podporu na TeX Live.

- Toshiu Oshimovi za jeho prohlížeč dviout do Windows.

- Manuelu Pégourié-Gonnardovi za pomoc při aktualizaci balíků, vylepšení dokumentace a rozvoj dokumentu texdoc.

- Fabrice Popineau, za původní podporu Windows na TeX Live a za francouzskou dokumentaci.

- Norbertu Preiningovi, hlavnímu architektovi současné infrastruktury a instalačního programu TeX Live, za koordinaci Debian verze TeX Live (společně s Frankem Küsterem) a za vykonání obrovského množství práce v průběhu naší cesty.

- Sebastianu Rahtzovi za původní vytvoření systému TeX Live a za jeho údržbu po mnoho let. Sebastian zemřel v březnu 2016 a pokračující dílo věnujeme jeho památce.

- Luigimu Scarsovi za pokračující vývoj MetaPostu, LuaTeXu a mnoho dalšího.

- Andreasu Schererovi za cwebbin, implementaci CWEB použitou TeX Live, a pokračující údržbu původního CWEBu.

- Takujimu Tanakovi za údržbu (e)pTeXu a související podporu.

- Tomaszi Trzeciakovi za všestrannou pomoc s Windows.

- Vladimiru Volovichovi za významnou pomoc s přenositelností a jinými problémy údržby, obzvláště za to, že udělal realizovatelným zahrnutí xindy do TeX Live.

- Staszku Wawrykiewiczovi, hlavnímu testérovi všeho na TeX Live a koordinátorovi mnoha důležitých polských příspěvků: fontů, windowsové instalace a dalších. Staszek zemřel v únoru 2018 a my věnujeme pokračující práci jeho paměti.

- Olafu Weberovi za jeho pečlivou údržbu Web2Cv minulých letech.

- Gerbenu Wierdovi za vytvoření a údržbu původní podpory macOS.

- Grahamu Williamsovi, tvůrci TeX Catalogue.

- Josephovi Wrightovi za množství práce umožňující dostupnost tytéž primitivní funkcionality pro různé stroje.

- Hironobu Yamashitovi za množství práce na pTeXu a souvisící podporu.

Tvůrci binárek: Ettore Aldrovandi (i386-solaris, x86_64-solaris), Marc Baudoin (amd64-netbsd, i386-netbsd), Ken Brown (x86_64-cygwin), Akira Kakuto (windows), Dick Koch (x86_64-darwin), Mojca Miklavec (x86_64-darwinlegacy), Norbert Preining (aarch64-linux, armhf-linux, i386-freebsd, amd64-freebsd, i386-linux, x86_64-linux, i386-solaris, x86_64-solaris, x86_64-linuxmusl). Pro informaci o procesu budování TeX Live, viz https://tug.org/texlive/build.html.

Překladatelé této příručky: Carlos Enriquez Figueras (španělština), Jjgod Jiang, Jinsong Zhao, Yue Wang, & Helin Gai (čínština), Nikola Lečić (srbština), Marco Pallante & Carla Maggi (italština), Denis Bitouzé & Patrick Bideault (francouzština), Petr Sojka & Ján Buša (čeština/ slovenština),2 Boris Veytsman & Vladimir Lomov (ruština), Uwe Ziegenhagen (němčina). Webovská stránka dokumentace TeX Live je https://tug.org/texlive/doc.html.

Samozřejmě nejdůležitější poděkování patří Donaldu Knuthovi, především za vymyšlení TeXu a také za to, že ho věnoval světu.

### 9 Historie vydání

#### 9.1 Minulost

Diskuse začala koncem roku 1993, kdy holandská skupina uživatelů TeXu NTG začala práci na CD 4AllTeX pro uživatele MS-DOSu, doufajíc, že doba nazrála pro vydání jednoho CD pro všechny systémy. Byl to na svou dobu příliš ambiciózní cíl, ale nenastartoval jen velmi úspěšné 4AllTeX CD, ale také pracovní skupinu TUGu o TeX Directory Structure ( https://tug.org/tds), která speciﬁkovala, jak vytvořit konzistentní a spravovatelnou kolekci TeXových souborů. Kompletní draft TDS byl publikován v prosincovém čísle časopisu TUGboat v roce 1995 a hned ze začátku bylo jasné, že jedním z žádaných produktů bude vzorová struktura CD. Distribuce, kterou nyní máte, je přímým výstupem práce této pracovní skupiny. Evidentní úspěch CD 4AllTeX ukázal, že i unixoví uživatelé by toužili po podobně jednoduchém systému, a to je také jedno z hlavních aktiv TeX Live.

Nejprve jsme vytvořili unixové TDS CD na podzim 1995 a rychle identiﬁkovali teTeX Thomase Essera jako ideální systém, jelikož již měl multiplatformní podporu a byl koncipován s perspektivou přenositelnosti. Thomas souhlasil s pomocí a seriózní práce započala začátkem roku 1996. První vydání se uskutečnilo v květnu 1996. Začátkem 1997 Karl Berry dokončil nové hlavní vydání Web2C, které obsahovalo téměř všechny vlastnosti, které Thomas Esser přidal do teTeXu, a tak jsme se rozhodli druhé vydání CD postavit na standardním Web2C, s přidáním skriptu texconfig z teTeXu. Třetí vydání CD bylo založeno na další revizi Web2C, 7.2, provedené Olafem Weberem; a jelikož zároveň byla hotova nová verze teTeXu, TeX Live obsahoval téměř všechna její vylepšení. Podobně čtvrté vydání používalo novou verzi teTeXu a nové vydání Web2C (7.3). TeX Live nyní obsahuje i kompletní systém pro Windows díky Fabrice Popineau.

Pro páté vydání (březen 2000) bylo mnoho částí CD revidováno a zkontrolováno a byly aktualizovány stovky balíků. Detaily o balících byly uloženy v souborech XML. Ale hlavní změnou pro TeX Live 5 bylo vynětí softwaru, na kterém byla jakákoliv omezení na šíření (non-free software). Vše uložené na TeX Live je nyní slučitelné s tzv. ,Debian Free Software Guidelines‘ ( https://debian.org/intro/free); udělali jsme vše možné, abychom zkontrolovali licenční podmínky všech balíků, ale budeme vděčni za upozornění na jakékoli chyby.

Šesté vydání (červenec 2001) mělo aktualizovaného materiálu ještě více. Hlavní změnou byl nový instalační přístup: uživatel může volit instalační kolekce. Byly kompletně reorganizovány jazykové kolekce, takže jejich výběrem se instalují nejen makra, fonty, ale je také připraven odpovídající soubor language.dat.

Sedmé vydání v roce 2002 mělo podstatné rozšíření v přidání podpory macOS, kromě množství aktualizací balíků a programů. Důležitým cílem byla opětná integrace s teTeXem a korekce odchylek z pátého a šestého vydání.

##### 9.1.1 2003

V roce 2003 se neustálou smrští oprav a rozšíření stalo to, že velikost TeX Live již neumožnila jeho směstnání na jedno CD, a tak došlo k rozdělení na tři různé distribuce (viz oddíl 2.1 na straně 8). Navíc:

- Na žádost LaTeX týmu jsme změnili standardní příkazy latex a pdﬂatex tak, že nyní používají e-TeX (viz strana 12).

- Byly přidány a jsou nyní doporučovány k používání nové fonty Latin Modern.

- Byla zrušena podpora OS Alpha OSF (podpora HPUX byla zrušena již dříve), jelikož se nenašel nikdo, kdo by na těchto platformách zkompiloval nové binárky.

- Instalační program Windows byl změněn podstatným způsobem; poprvé bylo integrováno uživatelské prostředí založené na XEmacsu.

- Důležité pomocné programy pro Windows (Perl, Ghostscript, ImageMagick, Ispell) jsou nyní instalovány do instalačního adresáře TeX Live.

- Mapovací soubory jmen fontů pro dvips, dvipdfm a pdftex jsou nyní generovány novým programem updmap a instalovány do texmf/fonts/map.

- TeX, Metafont a MetaPost nyní dávají na výstup většinu vstupních 8-bitových znaků (32 a výš) bez konverze (například do souborů zapisovaných pomocí \write, souborů log, na terminál), a tedy nejsou překládány do sedmibitové ^^ notace. V TeX Live 7 bylo toto mapování závislé na nastavení systémových locale; nyní již nastavení locale neovlivní chování TeXu. Pokud z nějakých důvodů potřebujete výstup s ^^, přejmenujte soubor texmf/web2c/cp8bit.tcx. Příští verze bude mít čistší řešení.

- Tato dokumentace byla podstatným způsobem přepracována.

- Konečně, jelikož čísla verzí TeX Live již příliš narostla, verze je nyní identiﬁkována rokem vydání: TeX Live 2004.

##### 9.1.2 2004

Rok 2004 přinesl mnoho změn:

- Pokud máte lokálně instalovány fonty, které využívají své vlastní podpůrné soubory .map nebo (mnohem méně pravděpodobně) .enc, možná budete nuceni tyto soubory přesunout.

  Soubory .map jsou nyní vyhledávány jen v podaresářích fonts/map (v každém stromě texmf), podle cesty TEXFONTMAPS. Podobně soubory .enc jsou hledány jen v podadresářích fonts/enc, podle cesty ENCFONTS. updmap se pokusí vypsat varování o problematických souborech.

  O metodách zpracování té které informace prosíme viz https://tug.org/texlive/mapenc.html.

- TeX-kolekce byla rozšířena přidáním instalovatelného CD, založeného na MiKTeXu, pro ty, kteří dávají přednost této implementaci před Web2C. Viz oddíl 2 (stránka 8).

- Uvnitř TeX Live byl velký strom texmf předešlých vydání nahrazen třemi: texmf, texmf-dist a texmf-doc. Viz oddíl 2.2 (stránka 8) a soubory README pro každý z nich.

- Všechny vstupní soubory týkajíci se TeXu jsou teď soustředěny v podadresáři tex stromů texmf* a nemají oddělené sourozenecké adresáře tex, etex, pdftex, pdfetex atd. Viz texmf-doc/doc/english/tds/tds.html#Extensions.

- Pomocné dávky (neměly by být volány uživateli) jsou teď umístěny v novém podadresáři scripts stromů texmf* a mohou být vyhledávány prostřednictvím kpsewhich -format=texmfscripts. Pokud tedy máte programy volající tyto dávky, budou muset být nastaveny. Viz https://tug.org/tds/tds.html\#Scripts.

- Téměř všechny formáty umožňují většinu znaků tisknout bez konverze pomocí překladového souboru cp227.tcx místo jejich konverze pomocí ^^ notace. Konkrétně znaky na pozicích 32–256, plus „tab“, „vertikální tab“ a „form feed“ jsou považovány za tisknutelné a nejsou konvertovány. Výjimky tvoří plain TeX (jen 32–127 jsou tisknutelné), ConTeXt (0–255 tisknutelné) a formáty systému Omega. Toto implicitní chování je téměř stejné jako v TeX Live 2003, ale je implementováno čistěji, s více možnostmi přizpůsobení. Viz texmf-dist/doc/web2c/web2c.html#TCX-files. (Mimochodem, se vstupem Unicode může TeX na výstupu vypsat posloupnosti částečných znaků při výpisu chybových kontextů, protože je bytově orientován.)

- pdfetex je teď implicitní stroj pro všechny formáty kromě samotného (plain) texu. (Ten samozřejmě generuje DVI, když je spuštěn jako latex atd.) To znamená, kromě jiných věcí, že mikrotypograﬁcké rozšíření pdftexu je dostupné v LaTeXu, ConTeXtu atd., stejně jako rozšíření e-TeXu (texmf-dist/doc/etex/base/).

  To také znamená, že užití balíku ifpdf (pracuje s plainem i LaTeXem) nebo ekvivalentního kódu je důležitější než kdykoliv předtím, protože jednoduché testování, zda je \pdfoutput nebo nějaký jiný primitiv deﬁnován, není spolehlivý způsob určení, zda je generován PDF výstup. Tento zpětný krok jsme udělali co nejvíc kompatibilní letos, ale v příštím roce \pdfoutput může být deﬁnován, dokonce i když se zapisuje do DVI.

- pdfTeX ( http://pdftex.org/) má množství nových vlastností:

  - \pdfmapfile a \pdfmapline poskytují podporu mapování fontů uvnitř dokumentu.

  - Mikrotypograﬁcké rozšíření fontu může být použito jednodušeji.
    http://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html.

  - Všechny parametry, které byly předtím nastavovány ve zvláštním konﬁguračním souboru pdftex.cfg, musejí teď být nastaveny pomocí primitivů, obyčejně v pdftexconfig.tex; pdftex.cfg není dále podporován. Všechny existující .fmt soubory musí být znovu vytvořeny při změně souboru pdftexconfig.tex.

  - Další informace viz manuál pdfTeXu: texmf/doc/pdftex/manual.

- Primitiv \input v texu (a mf a mpost) teď akceptuje dvojité uvozovky se jmény obsahujícími mezery a s jinými zvláštními znaky. Typické příklady:

           \input "filename with spaces"   % plain
      \input{"filename with spaces"}  % latex

  Pro další informace viz manuál Web2C: texmf-dist/doc/web2c.

- Podpora encTeXu je nyní zahrnuta uvnitř Web2C, v důsledku toho ve všech TeXových programech, použitím volby -enc – jen v případě, že formáty jsou vytvořeny. encTeX podporuje obecné překódování vstupu a výstupu, čímž umožňuje plnou podporu kódování Unicode (v UTF-8). Viz texmf-dist/doc/generic/enctex/ a http://olsak.net/enctex.html.

- Aleph, nový stroj kombinující e-TeX a Omega, je nyní k dispozici. Nějaké informace jsou k dispozici na texmf-dist/doc/aleph/base a https://texfaq.org/FAQ-enginedev. Formát pro Aleph, založený na LaTeXu, se jmenuje lamed.

- Nejnovější vydání LaTeXu má novou verzi LPPL – teď oﬁciálně schválená Debian licence. Rozmanité další aktualizace najdete v souborech ltnews v texmf-dist/doc/latex/base.

- Je dodán dvipng, nový program pro konvertování DVI na obrazové soubory PNG. Viz https://ctan.org/pkg/dvipng.

- Zredukovali jsme balík cbgreek na „středně“ velkou sadu fontů, se souhlasem a na radu autora (Claudio Beccari). Odstraněné fonty jsou neviditelné, obrysové, a průhledné, relativně zřídka se používají a my jsme potřebovali místo. Úplná sada je dostupná z CTAN ( https://ctan.org/pkg/cbgreek-complete).

- oxdvi byl odebrán; použijte jednoduše xdvi.

- Příkazy ini a vir (linky) pro tex, mf a mpost se již nevytvářejí, například initex. Funkčnost instrukce ini byla po celá léta přístupná prostřednictvím volby -ini na příkazovém řádku.

- Podpora platformy i386-openbsd byla zrušena. Jelikož balíček tetex v BSD Ports systému je dostupný a GNU/Linux a FreeBSD binárky byly dostupné, zdálo se nám, že čas dobrovolníků může být využit lépe někde jinde.

- Na sparc-solaris (přinejmenším) jste možná museli nastavovat proměnné prostředí LD_LIBRARY_PATH, aby běžely programy t1utils. Je to tím, že jsou kompilovány v C++, a neexistuje standardní umístění ,runtime‘ knihoven. (To není novinka roku 2004, ale nebylo to dřív zdokumentováno.) Podobně na mips-irix jsou ,runtime‘ knihovny pro MIPS 7.4 nezbytné.

##### 9.1.3 2005

Rok 2005 přinesl jako obvykle množství modernizací balíčků a programů. Infrastruktura zůstala relativně stabilní z roku 2004, ale nutně také nastaly určité změny:

- Byly zavedeny nové skripty texconﬁg-sys, updmap-sys a fmtutil-sys, které mění konﬁguraci v systémových stromech. Skripty texconﬁg, updmap a fmtutil teď mění uživatelské (user-speciﬁc) soubory v $HOME/.texlive2005.

- Na speciﬁkaci stromů obsahujících konﬁgurační soubory (uživatelské, resp. systémové) byly zavedeny odpovídající nové proměnné TEXMFCONFIG, resp. TEXMFSYSCONFIG. Budete tedy možná potřebovat přesunout osobní verze souborů fmtutil.cnf a updmap.cfg na tato místa; jiná volba je předeﬁnování TEXMFCONFIG nebo TEXMFSYSCONFIG v souboru texmf.cnf. V každém případě skutečná pozice těchto souborů a hodnoty TEXMFCONFIG a TEXMFSYSCONFIG se musejí shodovat. Viz oddíl 2.3, strana 10.

- Loni jsme ponechali \pdfoutput a jiné primitivy nedeﬁnovány pro výstup DVI, přestože byl používán program pdfetex. Letos, jak jsme slíbili, jsme odstranili toto zpětně kompatibilní opatření. Tedy když váš dokument používá \ifx\pdfoutput\undefined na testování výstupu do formátu PDF, je nutné ho změnit. Můžete k tomu použít balík ifpdf.sty (který funguje v plain TeXu i LaTeXu), nebo použít jeho logiku.

- Loni jsme změnili většinu formátů tak, aby vypisovaly (8bitové) znaky tak, jak jsou (viz předcházející sekci). Nový TCX soubor empty.tcx teď poskytuje jednodušší cestu k dosažení původního zápisu ^^, když si to budete přát, jako v případě:

           latex --translate-file=empty.tcx yourfile.tex

- Nový program dvipdfmx je zařazen pro převedení z DVI do PDF; ten je platnou aktualizací programu dvipdfm (který je též ještě k dispozici, i když ho nedoporučujeme).

- Nové programy pdfopen a pdfclose byly přidány, aby poskytly možnost znovu otevřít PDF soubory v programe Adobe Acrobat Reader bez jeho restartu. (Jiné prohlížeče PDF, především xpdf, gv a gsview, nikdy netrpěly tímto problémem.)

- Kvůli důslednosti proměnné HOMETEXMF a VARTEXMF byly přejmenovány na TEXMFHOME, resp. na TEXMFSYSVAR. Je tu také TEXMFVAR, která je implicitně uživatelsky závislá (user-speciﬁc). Viz první bod výše.

##### 9.1.4 2006–2007

V letech 2006–2007 byl rozsáhlým přírůstkem na TeX Live program XeTeX, přístupný jako programy xetex a xelatex; viz https://scripts.sil.org/xetex.

MetaPost byl také podstatně aktualizován, s mnoha plány do budoucnosti ( https://tug.org/metapost/articles), podobně pdfTeX ( https://tug.org/applications/pdftex).

Formát TeX .fmt (vysokorychlostní formát) a podobně soubory MetaPost a Metafont jsou teď uloženy v podadresářích texmf/web2c, namísto přímého uložení v něm (ačkoliv je adresář stále prohledáván, v zájmu stávajících formátů .fmt). Podadresáře nesou jména používaných programů, například tex nebo pdftex nebo xetex. Tato změna by měla při běžném používání zůstat nepostřehnuta.

Program (plain) tex již nečte první řádky %&, aby určil, jaký formát má spustit; je to čistý knuthovský TeX. (LaTeX a všechny ostatní programy stále čtou řádky %&). Pochopitelně se během roku (jako obvykle) vyskytly stovky jiných aktualizací balíků a programů. Jako obyčejně, zkontrolujte, prosím, aktualizace na CTANu ( https://ctan.org).

Strom zdrojových textů je nyní uložen v Subversion, se standardním webovským rozhraním pro jeho prohlížení, kam směruje odkaz z naší domovské stránky. Třebaže není v konečné verzi viditelný, očekáváme, že to poskytne základ pro stabilní rozvoj v letech následujících.

Nakonec, v květnu 2006 Thomas Esser oznámil, že už nebude aktualizovat teTeX ( https://tug.org/tetex). Výsledkem je nárůst zájmu o TeX Live, především mezi distributory GNU/Linuxu. (Na TeX Live se nachází nové instalační schéma tetexu, poskytující přibližný ekvivalent.) Doufáme, že to možná povede ke zlepšení prostředí TeXu pro všechny.

##### 9.1.5 2008

V roce 2008 byla celá infrastruktura TeX Live přebudována a znovu implementována. Úplná informace o instalaci je nyní uložena v textovém souboru tlpkg/texlive.tlpdb.

Mezi dalšími věcmi je konečně možná aktualizace instalace TeX Live z internetu po předchozí instalaci. Tuto vlastnost poskytoval MiKTeX již řadu let. Předpokládáme pravidelnou aktualizaci nových balíků po jejich vydání na CTANu.

Obsažený je významnější nový stroj (engine) LuaTeX ( http://luatex.org); kromě lepší přizpůsobivosti v sázení je možno tento vynikající skriptovací jazyk použít jak uvnitř, tak i mimo TeXovské dokumenty.

Podpora Windows a unixových platforem je nyní jednotnější. Zejména většina skriptů Perlu a Lua je teď k dispozici pod Windows, s použitím Perlu distribuovaného na TeX Live.

Nový skript tlmgr (sekce 5) je všeobecné rozhraní pro správu TeX Live po předchozí instalaci. Ovládá aktualizaci balíků a následující znovuvytvoření formátů, mapovacích souborů a jazykových souborů, volitelně zahrnující lokální doplňky.

S příchodem programu tlmgr jsou nyní činnosti programu texconﬁg na editaci formátů a konﬁguračních souborů dělení slov blokované.

Program xindy pro tvorbu rejstříků ( http://xindy.sourceforge.net/) je nyní zahrnut na většině platforem.

Nástroj kpsewhich může nyní ohlásit všechny výskyty pro daný soubor (option --all) a omezené výskyty pro daný podadresář (option --subdir).

Program dvipdfmx zahrnuje nyní funkčnost extrakce informace o ,bounding boxu‘, pomocí povelu extractbb; toto byl jeden z posledních rysů, které poskytoval dvipdfm, avšak ne dvipdfmx.

Fontové přezdívky Times-Roman, Helvetica atd. byly odstraněny. Různé balíky očekávaly jejich různé chování (především, že budou mít různé kódování) a nenalezlo se vhodné řešení tohoto problému.

Formát platex byl odstraněn pro konﬂikt jmen s japonštinou platex; podporu polštiny nyní zajišťuje balík polski.

Soubory WEBovských řetězců (pool) jsou nyní zkompilované do binárek pro usnadnění aktualizací.

A nakonec, v tomto vydání jsou zahrnuty změny provedené Donaldem Knuthem v jeho úpravách TeXu roku 2008 (,TeX tuneup of 2008‘). Viz https://tug.org/TUGboat/Articles/tb29-2/tb92knut.pdf.

##### 9.1.6 2009

Od roku 2009 je standardní výstupní formát Lua(LA )TeX PDF, pro využití výhody LuaTeXovské podpory OpenType a jiné. Nové binárky nazvané dviluatex a dvilualatex spouští LuaTeX při výstupu DVI. Domovská stránka LuaTeXu je http://luatex.org.

Původní systém (engine) Omega a formát Lambda format byly odstraněny po diskusích s autory systému Omega. Zůstaly aktualizované programy Aleph a Lamed, podobně jako pomocné programy systému Omega.

Obsaženo je nové vydání fontů AMS Type 1včetně Computer Modern: do zdrojáků Metafontu bylo zapracováno několik málo změn tvarů, které za léta udělal Donald Knuth a byl aktualizován hinting fontů. Tvary fontů Euler byly důkladně překresleny Hermannem Zapfem (viz https://tug.org/TUGboat/Articles/tb29-2/tb92hagen-euler.pdf). Ve všech případech zůstaly metriky nezměněny. Domovská stránka AMS fontů je https://ams.org/tex/amsfonts.html.

Pomocný program – nový GUI editor – TeXworks je zahrnut pro Windows, ale také v MacTeXu. Pro jiné platformy a další informace viz domovskou stránku TeXworks https://tug.org/texworks. Je to multi-platformní prostředí inspirované editorem TeXShop v macOS, zaměřené na jednoduché použití.

Graﬁcký program Asymptote je zahrnutý pro více platforem. Realizuje textově založený jazyk pro popis graﬁky, blízký k MetaPostu, avšak s pokročilou podporou 3D a jinými vlastnostmi. Jeho domovská stránka je https://asymptote.sourceforge.io.

Samostatný program dvipdfm byl nahrazen programem dvipdfmx, který pod tímto jménem pracuje ve zvláštním režimu kompatibility. dvipdfmx zahrnuje podporu CJK a má nahromaděny mnohé další úpravy za léta od posledního vydání dvipdfm.

Binárky pro platformy cygwin a i386-netbsd jsou nyní v TeX Live zahrnuty, zatímco nám bylo oznámeno, že uživatelé OpenBSD získají TeX pomocí jejich systémů balíků a navíc se objevily potíže při vytváření binárek, které by měly šanci fungovat na více než jedné verzi.

Z dalších menších změn: nyní používáme xz kompresi, stabilní náhradu za lzma ( https://tukaani.org/xz/); a literál $ je povolen v názvech souborů pokud není uveden na začátku jména známé proměnné; knihovna Kpathsea je teď vícevláknová (použitelné v MetaPostu); budování celého TeX Live je nyní založeno na systému Automake.

Závěrečná poznámka o minulosti: všechna vydání TeX Live spolu s podpůrným materiálem jako např. CD labels jsou dostupná na ftp://tug.org/historic/systems/texlive.

##### 9.1.7 2010

V roce 2010 je předvolenou verzí pro výstup PDF verze 1.5, umožňující větší kompresi. To se týká všech nástrojú TeXu používaných na vytváření PDF a dvipdfmx. Načtením LaTeXovského balíčku pdf14 se provede zpětná změna na PDF 1.4, nebo nastavte \pdfminorversion=4.

pdf(LA )TeX nyní automaticky konvertuje požadovaný soubor ve formátu Encapsulated PostScript (EPS) na PDF prostřednictvím balíku epstopdf, když a pokud je načten konﬁgurační soubor LaTeXu graphics.cfg a pokud je výstup do PDF. Implicitní nastavení jsou zamýšlena pro eliminaci možností přepsání ručně vytvořených PDF souborů, ale můžete také docela zakázat načtení epstopdf zadáním \newcommand{\DoNotLoadEpstopdf}{} (nebo \def...) před deklarací \documentclass. Balík epstopdf rovněž nebude zaveden pokud bude použit balík pst-pdf. Pro další podrobnosti viz dokumentaci balíku epstopdf ( https://ctan.org/pkg/epstopdf-pkg).

Další podobnou změnou je, že vykonání několika málo externích příkazů z TeXu, prostřednictvím vlastnosti \write18, je nyní implicitně povoleno. Tyto příkazy jsou repstopdf, makeindex, kpsewhich, bibtex a bibtex8; seznam je uveden v texmf.cnf. Prostředí, která musí zakázat všechny takové externí povely, mohou zrušit tuto volbu v instalátoru (viz oddíl 3.2.4), nebo po instalaci přepsat hodnotu spuštěním tlmgr conf texmf shell_escape 0.

Ještě další podobnou změnou je to, že BibTeX a Makeindex nyní implicitně odmítají zapsat své výstupní soubory do libovolného adresáře (jako samotný TeX). Je to proto, že nyní mohou být povolené pro použití omezeným \write18. Aby se to změnilo, může být nastavena proměnná prostředí TEXMFOUTPUT nebo změneno nastavení openout_any.

XeTeX nyní podporuje posun (kerning) okrajů podél stejných linií jako pdfTeX. (Expanze fontů není aktuálně podporována.)

Program tlmgr nyní standardně ukládá jednu zálohu každého aktualizovaného balíku (tlmgr option autobackup 1), tudíž přerušené aktualizace balíků mohou být snadno vráceny příkazem tlmgr restore. Pokud děláte poinstalační aktualizace a nemáte dostek místa na disku pro zálohy, spusťte tlmgr option autobackup 0.

Byly zařazeny nové programy: nástroj (engine) pTeX a příbuzné pomůcky pro sazbu Japonštiny; program BibTeXU pro BibTeXumožňující použití Unicode; utility chktex (původně z https://www.nongnu.org/chktex/) na kontrolu dokumentů (LA )TeXu; překladač dvisvgm z DVI do SVG ( https://dvisvgm.de).

Jsou dodány binárky těchto nových platforem: amd64-freebsd, amd64-kfreebsd, i386-freebsd, i386-kfreebsd, x86_64-darwin, x86_64-solaris.

Změna TeX Live 2009, které jsme si nevšimli: četné binárky týkající se TeX4ht ( https://tug.org/tex4ht) byly odstraněny z adresářů binárek. Obecně použitelný (generic) program mk4ht může být použit na spuštění libovolné z rozličných kombinací tex4ht.

Nakonec, vydání TeX Live na TeX Collection DVD již nemůže být (kupodivu) spouštěno živě. Samostatné DVD již nemá dostatek místa. Výhodou je, že instalace z fyzického DVD je mnohem rychlejší.

##### 9.1.8 2011

Binárky macOS (universal-darwin a x86_64-darwin) nyní pracují jenom pro Leopard nebo pozdější; Panther a Tiger již nejsou podporovány.

Program biber pro zpracování bibliograﬁe je zahrnut pro běžné platformy. Jeho rozvoj je úzce spojený s balíkem biblatex, který úplně přebudovává bibliograﬁcké prostředky poskytované LaTeXem.

Program MetaPost (mpost) již nevytváří nebo nepoužívá soubory .mem. Potřebné soubory, jako je plain.mp, se jednoduše načítají při každém spuštění. To souvisí s podporou MetaPostu jako knihovny, což je další důležitá změna, třebas neviditelná pro uživatele.

Implementace updmap v programu Perl, předtím používaná pouze pod Windows, byla vylepšena a nyní je používána na všech platformách. Výsledkem toho je, že uživatel by neměl vidět žádné změny, kromě toho, že program běží mnohem rychleji.

Programy initex a inimf byly obnoveny (ale žádné jiné ini* varianty).

##### 9.1.9 2012

tlmgr podporuje aktualizace z vícenásobných síťových repozitářů. Více obsahuje oddíl o vícenásobných repozitářích ve výstupu příkazu tlmgr help.

Parametr \XeTeXdashbreakstate je implicitně nastaven na 1, pro xetex i xelatex. To umožňuje zalomení řádek po pomlčkách a spojovnících, což vždy bylo chováním plain TeXu, LaTeXu, LuaTeXu atd. Stávající dokumenty XeTeXu, které si musí udržet perfektní kompatibilitu zalomení řádek, musí explicitně nastavit hodnotu \XeTeXdashbreakstate na 0.

Výstupní soubory generované programy pdftex a dvips teď mohou mimo jiné překročit velikost 2 GiB.

Do výstupu programu dvips je implicitně zahrnuto 35 standardních PostScriptových fontů, protože existuje příliš mnoho jejich různých verzí.

V omezeném režimu vykonávání \write18, který je implicitně nastaven, je teď mpost povoleným programem.

Soubor texmf.cnf je také k nalezení v adresáři ../texmf-local, například /usr/local/texlive/texmf-local/web2c/texmf.cnf, pokud existuje.

Skript updmap čte soubor updmap.cfg podle stromu místo globálního konﬁguračního souboru. Tato změna by neměla být viditelná, pokud needitujete vaše soubory updmap.cfg přímo. Více obsahuje výstup příkazu updmap –help.

Platformy: byly přidány armel-linux a mipsel-linux; sparc-linux a i386-netbsd již nejsou v základní distribuci.

##### 9.1.10 2013

Rozvržení distribuce: kořenový adresář texmf/ přešel do texmf-dist/ kvůli zjednodušení. Obě proměnné TEXMFMAIN a TEXMFDIST Kpathsea nyní odkazují na texmf-dist.

Mnohé malé jazykové kolekce byly sloučeny pro zjednodušení instalace.

MetaPost: byla přidána původní podpora pro výstup PNG a pro pohyblivou čárku (IEEE double).

LuaTeX: aktualizován na Lua 5.2 a zahrnuje novou knihovnu (pdfscanner) pro zpracování obsahu externí stránky PDF, kromě množství dalšího (viz jeho stránky).

XeTeX (pro doplnění viz také jeho stránky):

- Na navrhování fontů je nyní použita knihovna The HarfBuzz místo ICU. (ICU je stále používán pro podporu vstupních kódování, obousměrnost a zvláštní zalamování řádků v Unicode.)

- Na návrh Graphite se nyní používají Graphite2 a HarfBuzz namísto SilGraphite.

- Na počítačích Mac se používá Core Text namísto (kritizovaného) ATSUI.

- Preferují se TrueType/OpenType fonty před Type1, pokud mají stejné názvy.

- Opraveny jsou občasné neshody při hledání fontů mezi XeTeXem a xdvipdfmx.

- Podpora OpenType math cut-ins.

xdvi: nyní používá pro vyobrazení FreeType namísto t1lib.

microtype.sty: trochu podpory pro XeTeX (vyčuhování) a LuaTeX (vyčuhování, rozpínavost fontů, mezipísmenný proklad – tracking), kromě dalších zlepšení.

tlmgr: nová činnost pinning pro usnadnění konﬁgurace násobných repozitářů; více obsahuje tato sekce v tlmgr --help, online na https://tug.org/texlive/doc/tlmgr.html#MULTIPLE-REPOSITORIES.

Platformy: armhf-linux, mips-irix, i386-netbsd a amd64-netbsd přidány nebo oživeny; powerpc-aix odstraněna.

##### 9.1.11 2014

Rok 2014 zažil další doladění TeXu od Donalda Knutha; to ovlivnilo všechny stroje, ale pravděpodobně jedinou viditelnou změnou je navrácení řetězce preloaded format ve výstupním řádku. Podle Knutha toto nyní odráží formát, který bude standardně načten, a ne formát, který je ve skutečnosti natažen již v binárce; toto může být potlačeno různými způsoby.

pdfTeX: nový parametr na potlačení varování \pdfsuppresswarningpagegroup; nové primitivy pro ﬁktivní mezislovní mezery na pomoc s přeformátováváním textu v PDF: \pdfinterwordspaceon, \pdfinterwordspaceoff, \pdffakespace.

LuaTeX: význačné změny a úpravy byly provedeny pro čtení fontů a dělení slov. Největší přírůstek je nová varianta stroje, luajittex a jeho sourozenci texluajit a texluajitc. Používá just-in-time Lua kompilátor (podrobný článek v TUGboatu je na https://tug.org/TUGboat/tb34-1/tb106scarso.pdf). luajittex je stále ve vývoji, není k dispozici pro všechny platformy a je podstatně méně stabilní než luatex. Ani my, ani jeho vývojáři nedoporučujeme jeho použití s výjimkou zvláštního použití pro účel experimentu s jit na kódech Lua.

XeTeX: Stejné graﬁcké formáty jsou nyní podporovány na všech platformách (včetně Mac); tím se vyhýbá problému kompatibility dekompozice v Unicode. Preferuje fonty OpenType před Graphite kvůli kompatibilitě s předchozími verzemi XeTeXu.

MetaPost: Podporován je nový číselný systém decimal, společně s interním parametrem numberprecision; nová deﬁnice makra drawdot v plain.mp, podle Donalda Knutha, mimo jiné odstraňuje chyby ve výstupech SVG a PNG.

ConTeXtová pomůcka pstopdf bude odstraněna jako samostatný příkaz v určité době po vydání kvůli konﬂiktům s pomůckami OS téhož názvu. Stále může být (i teď) vyvolána jako mtxrun –script pstopdf.

psutils byl podstatně revidován novým vývojářem. Ve výsledku jsou nyní mnohé zřídka užívané pomůcky (fix*, getafm, psmerge, showchar) pouze v adresáři scripts/ a nejsou vykonavatelné na uživatelské úrovni. Toto může být navráceno, pokud se to ukáže jako problematické. Byl přidán nový skript psjoin.

Přerozdělení TeX Live pro MacTeX (sekce 3.1.2) již nezahrnuje výběrové balíky pouze pro Mac pro fonty Latin Modern a TeX Gyre, jelikož pro jednotlivé uživatele je dostatečně jednoduché začlenit je do systému. Program convert z ImageMagick byl rovněž odstraněn, protože TeX4ht (konkrétně tex4ht.env) nyní používá přímo Ghostscript.

Kolekce langcjk pro čínskou, japonskou a korejskou podporu byla rozdělena na jednotlivé jazykové kolekce z důvodu rozumnějších velikostí.

Platformy: x86_64-cygwin byla přidána; mips-irix odstraněna. Microsoft již nepodporuje Windows XP, tudíž naše programy mohou kdykoliv začít selhávat.

##### 9.1.12 2015

LaTeX2e nyní implicitně zahrnuje změny, které byly předtím zahrnuty pouze explicitním načtením balíčku ﬁxltx2e, který je nyní „no-op“ (prázdný). Nový balík latexrelease a další mechanismy umožňují kontrolu toho, co je již doděláno v základním LaTeXu. Podrobnosti obsahují zahrnuté dokumenty LaTeX News #22 a „LaTeX changes“. Mimochodem, balíky babel a psnfss, které jsou součástí jádra LaTeXu, se spravují odděleně a nejsou dotčeny těmito změnami (a měly by být stále ještě funkční).

Vnitřně nyní LaTeX2e zahrnuje konﬁguraci Unicode-related stroje (jehož znaky jsou písmena, názvy primitivů atd.), který byl původně součástí TeX Live. Tato změna je zamýšlena jako neviditelná pro uživatele; několik vnitřních řídících příkazů nízké úrovně bylo přejmenováno nebo odstraněno, ale vnější chování by mělo zůstat stejné.

pdfTeX: Podpora JPEG Exif stejně JFIF; dokonce nevydává výstrahu při záporném \pdfinclusionerrorlevel; synchronizace s xpdf 3.04.

LuaTeX: Nová knihovna newtokenlib na skenování tokenů; odstraněna chyba v generátoru normálních náhodných čísel a na jiných místech.

XeTeX: Opraveno zacházení s obrázky; binárka xdvipdfmx nyní poprvé vypadá jako příbuzná xetexu; změněn vnitřní operační kód XDV.

MetaPost: Nový číselný systém binary; nové programy upmpost a updvitomp umožňující japonštinu, analogické k up*tex.

MacTeX: Aktualizace zařazeného balíku Ghostscript pro podporu CJK. Panel preferencí TeXové distribuce pracuje nyní v Yosemite (macOS 10.10). Resource-fork font suitcases (obecně bez přípony) XeTeX už nepodporuje; podpora data-fork suitcases (.dfont) zůstává.

Infrastruktura: Skript fmtutil byl předělán pro čtení fmtutil.cnf na stromovém základě, analogicky k updmap. Skripty Web2C mktex* (včetně mktexlsr, mktextfm, mktexpk) upřednostňují nyní programy v jejich vlastních adresářích, místo vždy používané existující proměnné PATH.

Platformy: *-kfreebsd jsou odstraněny, protože TeX Live je nyní snadno dostupný prostřednictvím mechanismu systémových platforem. Podpora pro několik dalších platforem je dostupná ve formě uživatelských binárek ( https://tug.org/texlive/custom-bin.html). Navíc jsou některé platformy nyní vynechány na DVD (jednoduše pro ušetření místa), avšak mohou být normálně nainstalovány z Internetu.

##### 9.1.13 2016

LuaTeX: Rozsáhlé změny primitivů, jak přejmenování, tak i odstranění společně s reorganizací struktury některých uzlů. Změny jsou shrnuty v článku Hanse Hagena, „LuaTeX 0.90 backend changes for PDF and more“ ( http://tug.org/TUGboat/tb37-1/tb115hagen-pdf.pdf); pro všechny podrobnosti viz příručku LuaTeXu, texmf-dist/doc/luatex/base/luatex.pdf.

Metafont: Nové vysoce experimentální příbuzné programy MFlua a MFluajit, integrující Lua s Metafont, pro účely pokusného testování.

MetaPost: Opravy chyb a interní příprava pro MetaPost 2.0.

SOURCE_DATE_EPOCH má podporu všech překladačů s výjimkou LuaTeXu (ta přijde v další verzi) a originálního texu (cíleně vynechána): pokud je proměnná prostředí SOURCE_DATE_EPOCH nastavena, její hodnota je použita jako časová známka PDF výstupu. Pokud je nastavena i proměnná SOURCE_DATE_EPOCH_TEX_PRIMITIVES, hodnota SOURCE_DATE_EPOCH je použita k inicializaci TeXových primitiv \year, \month, \day a \time. Manuál pdfTeXu má příklady a detaily.

pdfTeX: Tři nové primitivy \pdfinfoomitdate, \pdfsuppressptexinfo, \pdftrailerid, na nastavení hodnot objevujících se v PDF výstupu, které se normálně mění při každém spuštění (časové známky). Ovlivní pouze výstup PDF, ne DVI.

XeTeX: Nové primitivy \XeTeXhyphenatablelength, \XeTeXgenerateactualtext,
\XeTeXinterwordspaceshaping, \mdfivesum; limit počtu tříd znaků byl zvětšen na 4096; a byl zvýšen DVI id byte.

Ostatní nástroje:

- gregorio je nový program, část balíku gregoriotex pro sazbu not Gregoriánských chorálů; implicitně je zařazen do shell_escape_commands.

- upmendex je program na vytváření indexů, většinou slučitelný s programem makeindex, s podporou řazení pro Unicode sorting, kromě jiných změn.

- afm2tfm nyní provádí výškové nastavení jenom na základě akcentů, nová volba -a vynechává všechny úpravy.

- ps2pk umí zacházet s rozšířenými fonty PK/GF.

MacTeX: The TeX Distribution Preference Panel byl zrušen; jeho funkcionalita je nyní v TeX Live Utility; přibalené aplikace GUI jsou aktualizovány; nový skript cjk-gs-integrate pro spuštění uživateli, kteří si přejí začlenit různé fonty CJK do Ghostscriptu.

Infrastruktura: Podporován je systémový konﬁgurační soubor tlmgr; ověření kontrolního součtu balíku; pokud je dostupný program gpg, dojde k ověření podpisu síťové aktualizace. Ověření se týká jak instalačního programu tak tlmgr. Pokud gpg k dispozici není, aktualizace probíhají jako obvykle.

Platformy alpha-linux a mipsel-linux byly odstraněny.

##### 9.1.14 2017

LuaTeX: Více zpětných volání (callbacks), více typograﬁckého řízení, více přístupů k interním datovým strukturám; pro některé platformy přidáná knihovna ffi pro dynamické načtení kódu.

pdfTeX: Proměnná prostředí SOURCE_DATE_EPOCH_TEX_PRIMITIVES z minulého roku přejmenována na FORCE_SOURCE_DATE bez změn ve funkcionalitě; pokud seznam tokenů \pdfpageattr obsahuje řetězec /MediaBox, potlačí se výstup implicitního /MediaBox.

XeTeX: Unicode/OpenType matematika je nyní založena na podpoře tabulky HarfBuzz MATH; odstraněno pár chyb.

Dvips: Poslední nastavení \special papersize „vyhrává“, pro konzistenci s dvipdfmx a očekáváním balíků; konﬁgurační nastavení L0 (přepínač -L0) obnovuje předchozí chování, tedy to, kdy „první nastavení vyhrává“.

epTeX, eupTeX: Nová primitiva \pdfuniformdeviate, \pdfnormaldeviate, \pdfrandomseed, \pdfsetrandomseed, \pdfelapsedtime, \pdfresettimer z pdfTeXu.

MacTeX: Jako v tomto roce, pouze vydání macOS, pro která Apple ještě vydává bezpečnostní záplaty, budou podporovány v MacTeXu pod platformou s názvem x86_64-darwin; v současnosti sa tím myslí Yosemite, El Capitan a Sierra (10.10 a novší). Binárky pro starší verze macOS nejsou zahrnuty v MacTeXu, ale stále ještě jsou dostupné v TeX Live (x86_64-darwinlegacy, i386-darwin, powerpc-darwin).

Infrastruktura: Strom TEXMFLOCAL je nyní prohledáván před TEXMFSYSCONFIG a TEXMFSYSVAR (implicitně); je naděje, že to povede k lepšímu naplnění očekávání použití lokálních souborů před systémovými. Program tlmgr má také nový režim shell pro interaktivní a dávkové použití a novou funkci conf auxtrees pro jednodušší přidání a odebrání doplňkových stromů.

updmap a fmtutil: Tyto skripty nyní vydávají varování pokud jsou vyvolány bez speciﬁkace buď v tzv. systémovém režimu (updmap-sys, fmtutil-sys nebo volba -sys) nebo v uživatelském režimu (updmap-user, fmtutil-user nebo volba -user). Změna byla dělána v naději, že toto povede k snížení setrvalého problému náhodného spouštění uživatelského režimu, a tím ke ztrátě následných aktualizací systému. Pro podrobnosti viz https://tug.org/texlive/scripts-sys-user.html.

install-tl: Osobní cesty jako TEXMFHOME jsou nyní přiřazeny hodnotám MacTeXu (~/Library/... implicitně na Macích). Nová volba -init-from-profile pro zahájení instalace s hodnotami zadaného proﬁlu; nový příkaz P pro explicitní uložení proﬁlu; nové názvy proměnných proﬁlu (ale předchozí jsou ještě stále akceptovány).

SyncTeX: dočasný soubor se nyní jmenuje foo.synctex(busy), namísto foo.synctex.gz(busy). Frontendy a dávky, které mažou dočasné soubory by se měly upravit (kvůli zrušené koncovce .gz).

Ostatní nástroje: texosquery-jre8 je nový multi-platformní program pro získávání lokálních nastavení (locale) a jiných systémových informací ze zdrojového dokumentu TeXu; je to implicitně zahrnuto v příkazech shell_escape_commands pro omezené vykonávání shellu. (Starší verze JRE jsou podporovány programem texosquery, ale nemohou být k dispozici v omezeném režimu vykonávání, protože už nejsou podporovány Oracle, kvůli bezpečnostním problémům.)

Platformy: Viz položku MacTeX výše; žádné další změny.

##### 9.1.15 2018

Kpathsea: implicitně je hledání v nesystémových adresářích nezávislé na velikosti písmenek v názvech souborů; nastav texmf.cnf nebo proměnnou prostředí texmf_casefold_search na 0 pro potlačení nezávislosti. Plné detaily jsou v manuálu Kpathsea ( https://tug.org/kpathsea).

epTeX, eupTeX: Nový primitiv \epTeXversion.

LuaTeX: Příprava na migraci na Lua 5.3 v roce 2019: binárka luatex53 je dostupná pro většinu platform, ale musí být přejmenována na luatex aby byla účinná. Nebo použijte soubory ConTeXt Garden ( https://wiki.contextgarden.net); více informací tamtéž.

MetaPost: Oprava chybných směrů cest, TFM a PNG výstupy.

pdfTeX: Umožňuje kódování vektorů pro bitmapové fonty; aktuální adresář není zakódován do PDF ID; odstranění chyb pro \pdfprimitive a souvisejíci věci.

XeTeX: Podpora /Rotate při vkládání PDF obrázků; nenulový chybový kód programu pokud selže výstupní ovladač; opraveny různé UTF-8 a další primitivy.

MacTeX: Viz změny podpory verze níže. Navíc, soubory instalovány do /Applications/TeX/ programem MacTeX byly reorganizovány pro větší srozumitelnost; nyní toto místo obsahuje čtyři GUI programy (BibDesk, LaTeXiT, TeX Live Utility a TeXShop) na nejvyšší úrovni a adresáře s dalšími nástroji a dokumentací.

tlmgr: nové front-end tlshell (Tcl/Tk) a tlcockpit (Java); výstup JSON; uninstall je nyní synonymem pro remove; nová akce/volba print-platform-info.

Platformy:

- Odstraněny: armel-linux, powerpc-linux.

- x86_64-darwin podporuje 10.10–10.13 (Yosemite, El Capitan, Sierra a High Sierra).

- x86_64-darwinlegacy podporuje 10.6–10.10 (i když pro 10.10 je preferován x86_64-darwin). Veškerá podpora pro 10.5 (Leopard) je pryč, tj. platformy powerpc-darwin a i386-darwin platforms byly odstraněny.

- Windows: XP už není podporován.

##### 9.1.16 2019

Kpathsea: Důslednější expanze závorek a rozdělení cesty; nová proměnná TEXMFDOTDIR namísto ,hard-coded‘ . v cestách umožňuje snadné vyhledávání dalších adresářů nebo podadresářů (viz komentáře v texmf.cnf).

epTeX, eupTeX: Nové primitivy \readpapersizespecial a \expanded.

LuaTeX: Lua 5.3 nyní používán, s průvodními aritmetickými změnami a změnami rozhraní. Domácí knihovna pplib slouží ke čtení souborů PDF, co odstraňuje závislost na poppleru (a potřebu C++); odpovídajícím způsobem se změnilo rozhraní Lua.

MetaPost: název příkazu r-mpost rozpoznán jako alias pro vyvolání pomocí volby --restricted a přidán do seznamu omezených příkazů dostupních ve výchozím nastavení. Minimální přesnost je nyní 2 pro desetinný a binární režim. Binární režim již není v MPlib k dispozici, ale stále je k dispozici v samostatném MetaPostu.

pdfTeX: Nový primitiv \expanded; pokud je parametr \pdfomitcharset nového primitivu nastaven na 1, řetězec /CharSet je vypuštěn z výstupu PDF, protože nemůže být garantovaně správný, jak to požadují PDF/A-2 a PDF/A-3.

XeTeX: Nové primitivy pro podporu napříč různými verzemi sázecích programů: \expanded, \creationdate, \elapsedtime, \filedump, \filemoddate, \filesize, \resettimer, \normaldeviate, \uniformdeviate, \randomseed; rozšiřují \Ucharcat pro vytvoření aktivních znaků.

tlmgr: Podporuje curl jako program na stahování; pro lokální zálohování používá lz4 a gzip před xz, pokud jsou k dispozici; dává přednost systémovým binárkám před binárkami, které poskytuje TeX Live pro programy pro kompresi a stahování, pokud není nastavena proměnná prostředí TEXLIVE_PREFER_OWN.

install-tl: Nová volba -gui (bez argumentu) je výchozí pod Windows a Macs, a vyvolává nové GUI Tcl/TK (viz oddíly 1.3 a 3.1.6).

Nástroje:

- cwebbin ( https://ctan.org/pkg/cwebbin) je nyní implementace CWEB v TeX Live, s podporou pro více jazykových dialektů, včetně programu ctwill na výrobu mini-indexů.

- chkdvifont: poskytuje informace o fontech z DVI souborů, také z tfm/ofm, vf, gf, pk.

- dvispc: udělá soubor DVI nezávislým na stránce vzhledem na ,specials‘.

MacTeX: x86_64-darwin nyní podporuje 10.12 a vyšší (Sierra, High Sierra, Mojave); x86_64-darwinlegacy ještě pořád podporuje 10.6 a novější. Kontrola pravopisu Excalibur již není zahrnuta, protože vyžaduje 32-bitovou podporu.

Platformy: odstraněna sparc-solaris.

#### 9.2 2020

Všeobecně:

- Primitiv \input ve všech strojích TeXu, včetně tex, nyní rovněž přijímá argument group-delimited název souboru, jako systémově závislé rozšíření. Použití se snandardním space/token-delimited názvem souboru je úplně nezměněno. The group-delimited argument byl předtím implementován v LuaTeXu; nyní je k dispozici pro všechny stroje. ASCII znaky dvojitých uvozovek (") jsou odstraněny z názvu souboru, ale jinak to zůstane nezměněno po tokenizaci. Toto v současnosti neovlivní příkaz LaTeXu \input, protože se jedná o redeﬁnici standardního primitivu \input.

- Nová volba --cnf-line pro kpsewhich, tex, mf a všechny další stroje, pro podporu libovolné nastavení konﬁgurace na příkazovém řádku.

- Přidání různých primitivů do různých strojů v tomto roce a v předchozích letech je zamýšleno aby vyústilo do společné sady funkcionality dostupné ve všech strojích (LaTeX News #31, https://latex-project.org/news).

epTeX, eupTeX: Několik nových primitivů, většinou pro podporu mezi verzemi sázecích programů: \Uchar, \Ucharcat, \current(x)spacingmode, \ifincsname; také opraveny \fontchar?? a \iffontchar. Jenom pro eupTeX: \currentcjktoken.

LuaTeX: Integrace s knihovnou HarfBuzz, dostupná jako nové stroje luahbtex (použito pro lualatex) a luajithbtex. Nové primitivy: \eTeXgluestretch, \eTeXglueshrink, \eTeXglueorder.

pdfTeX: Nový primitiv \pdfmajorversion; to pouze mění číslo verze ve výstupu PDF; nemá žádný vliv na obsah PDF. \pdfximage a podobné nyní hledají obrazové soubory stejným způsobem jako \openin.

pTeX: Nové primitivy \ifjfont, \iftfont. Rovněž v epTeXu, upTeXu, eupTeXu.

XeTeX: Opravy pro \Umathchardef, \XeTeXinterchartoks, \pdfsavepos.

Dvips: Výstupní kódování bitmapových fontů pro lepší schopnosti copy/paste ( https://tug.org/TUGboat/tb40-2/tb125rokicki-type3search.pdf).

MacTeX: MacTeX a x86_64-darwin nyní požadují 10.13 nebo vyšší (High Sierra, Mojave a Catalina); x86_64-darwinlegacy podporuje 10.6 a novější. MacTeX je na systému autorizován pro běh a programy příkazové řádky mají zajištěné spouštění, jak nyní vyžaduje Apple pro instalační balíčky. BibDesk a TeX Live Utility v MacTeXu protože nejsou pro systém autorizovány, ale soubor README obsahuje seznam url, kde je možné je získat.

x86_64-darwinlegacy: zrušena podpora X11, včetně xdvi.

tlmgr a infrastruktura:

- Automaticky (jednou) zopakuje balíčky, které se nepodaří stáhnout.

- Nová volba tlmgr check texmfdbs, na kontrolu souhlasu (konzistence) souborů ls-R a speciﬁkací !! pro každý strom.

- Používejí verzované názvy souborů pro balíčkové kontejnery, jako
  v tlnet/archive/pkgname.rNNN.tar.xz. Tohle by mělo být neviditelné pro uživatele, ale je to výrazná změna v distribuci.

- catalogue-date informace již nejsou šířeny z TeX Catalogue, protože to často nesouviselo s aktualizacemi balíčků.

##### 9.2.1 2021

Všeobecně:

- Začleněny jsou změny Donalda Knutha pro jeho vyladění TeXu a Metafontu v roce 2021 ( https://tug.org/TUGboat/tb42-1/tb130knuth-tuneup21.pdf. Jsou k dispozici také na CTAN jako balíčky knuth-dist a knuth-local. Opravy se podle očekávání týkají obskurních případů a nemají vliv na jakékoli chování v praxi.

- S výjimkou původního TeXu: pokud je \tracinglostchars nastaveno na 3 nebo více, chybějící znaky budou mít za následek chybu, nejen zprávu v log-souboru, a chybějící kód znaku se zobrazí v hexadecimálním formátu.

- S výjimkou původního TeXu: nový celočíselný parametr \tracingstacklevels, pokud je kladný, a \tracingmacros je také kladný, způsobí předponu označující hloubku expanze makra na výstup na každém příslušném řádku protokolu (např. ~.. v hloubce 2). Také protokolování maker je zkráceno na hloubku ≥ hodnotu parametru.

Aleph: LaTeXovský formát na bázi Aleph, pojmenovaný lamed, byl odstraněn. Samotný binární soubor aleph je stále zahrnut a podporován.

LuaTeX:

- Lua 5.3.6.

- Zpětné volání pro úroveň vnoření použitou v \tracingmacros, jako zobecněná varianta nového \tracingstacklevels.

- Označí matematické glyfy jako chráněné, aby se zabránilo zpracování jako textu.

- Odstraněna kompenzace šířky/italické korekce pro tradiční cestu matematického kódu.

MetaPost:

- Podpora proměnné prostředí SOURCE_DATE_EPOCH pro reprodukovatelný výstup.

- Vyhne se chybnému konečnému % v mpto.

- Popsaná volba -T, další opravy příručky.

- Hodnota epsilon se změnila v binárním a desítkovém režimu, takže
  funkce mp_solve_rising_cubic nyní funguje podle očekávání.

pdfTeX:

- Nové primitivy \pdfrunninglinkoff a \pdfrunninglinkon; např. pro deaktivaci generování odkazů v záhlavích a zápatích.

- Varování místo přerušení, když „\pdfendlink skončí v jiné úrovni vnoření než \pdfstartlink“.

- Záložní (dump) přiřazení \pdfglyphtounicode v souboru fmt.

- Zdroj: podpora poppler byla odstraněna, protože bylo příliš těžké ji aktualizovat. V nativním TL, pdfTeX vždy používal libs/xpdf, což je výřez a upravený kód z xpdf.

XeTeX: Opravy matematického vyrovnání párů (kerningu).

Dvipdfmx:

- Ghostscript je nyní ve výchozím nastavení bezpečně vyvolán; pro potlačení (tedy za předpokladu, že všechny vstupní soubory jsou důvěryhodné) použijte -i dvipdfmx-unsafe.cfg. Chcete-li použít PSTricks s XeTeXem, je to tak vyžadováno, jako v:
  xetex -output-driver="xdvipdfmx -i dvipdfmx-unsafe.cfg -q -E" ...

- Pokud soubor s obrázkem nebyl nalezen, ukončení se špatným stavem.

- Rozšířená speciální syntaxe pro podporu barev.

- Specials pro manipulaci ExtGState.

- Specials pdfcolorstack a pdffontattr pro kompatibilitu.

- Experimentální podpora rozšířeného fnt_def dviluatexu.

- Podpora nové vlastnosti virtuálního písma pro záložní deﬁnici japonského písma.

Dvips:

- Výchozí název dokumentu PostScript je nyní základním názvem vstupního souboru a lze jej přepsat novou volbou -title.

- Pokud soubor .eps nebo jiný obrazový soubor nebyl nalezen, ukončení se špatným stavem.

- Podpora nové vlastnosti virtuálního písma pro záložní deﬁnici japonského písma.

MacTeX: MacTeX a jeho nová binární složka universal-darwin nyní vyžadují macOS 10.14 nebo vyšší (Mojave, Catalina a Big Sur); binární složka x86_64-darwin již není k dispozici. Binární složka x86_64-darwinlegacy, dostupná pouze s Unixovým install-tl, podporuje verzi 10.6 a novější.

Tento rok je důležitý pro Macintosh, protože společnost Apple v listopadu představila stroje ARM a bude prodávat a podporovat stroje ARM i Intel po mnoho let. Všechny programy v universal-darwin mají spustitelný kód pro ARM i Intel. Oba binární soubory jsou kompilovány ze stejného zdrojového kódu.

Doplňkové programy Ghostscript, LaTeXiT, TeX Live Utility a TeXShop jsou všechny univerzální a jsou podepsány s potvrzeným modulem runtime, takže všechny jsou letos součástí MacTeXu.

tlmgr a infrastruktura:

- ponechávají pouze jednu zálohu hlavního úložiště texlive.tlpdb.

- ještě větší přenositelnost napříč systémy a verzemi Perlu.

- tlmgr info hlásí nové pole lcat-* a rcat-* pro místní vs. vzdálená data katalogu.

- úplné protokolování dílčích příkazů přesunuto do nového log-souboru
  texmf-var/web2c/tlmgr-commands.log.

##### 9.2.2 2022

Všeobecné:

- Nový stroj hitex, který vytváří svůj vlastní HINT formát, navržen speciálně pro responzivní čtení technických dokumentů na mobilních zařízeních. Odděleně od TeX Live jsou k dispozici prohlížeče HINT pro GNU/Linux, Windows a Android.

- tangle, weave: podporují volitelný třetí argument pro speciﬁkaci výstupní soubor.

- Nyní zahrnut Knuthův program twill pro vytváření miniindexů pro původní programy WEBu.

Rozšíření příkazů pro různé verze sázecích programů (kromě původních TeX, Aleph a hiTeX):

- Nový primitiv \showstream pro přesměrování výstupu \show do souboru.

- Nové primitivy \partokenname a \partokencontext umožňují přepsat název tokenu \par vygenerovaného na prázdných řádcích, konec vboxů atd.

epTeX, eupTeX:

- Nové primitivy: \lastnodefont, \suppresslongerror, \suppressoutererror, \suppressmathparerror.

- Nyní dostupné rozšíření pdfTeXu \vadjust pre.

LuaTeX:

- Podporuje strukturované destinace z PDF 2.0.

- PNG /Smask pro PDF 2.0.

- Variabilní rozhraní písma pro luahbtex.

- Různé výchozí styly odmocnin v mathdefaultsmode.

- Možnost volit speciﬁcké dělení (\discretionary ve vybraném bloku.

- Vylepšení implementace písem TrueType.

- Efektivnější alokace \fontdimen.

- Ignoruje odstavce s pouze lokálním uzlem par následovaným synchronizačními uzly směru.

MetaPost: Oprava chyby pro nekonečnou expanzi maker.

pdfTeX:

- Podporuje strukturované destinace z PDF 2.0.

- Pro písma s mezipísmenným prokladem se použije explicitní \fontdimen6, pokud je speciﬁkován.

- Vždy začne varování na začátku řádku.

- Pro znaky s automatickým kerningem (\pdfappendkern a \pdfprependkern) se přesto provede vysunutí (protrusion); podobně se použije automatika prokladu použije u implicitního a explicitního rozdělovníku.

pTeX et al.:

- Významná důležitá aktualizace pTeXu na 4.0.0 pro lepší podporu aktuálního LaTeXu.

- Nové primitivy \ptexlineendmode a \toucs.

- \ucs (dříve k dispozici v uptex, euptex) nyní dostupný také v pTeXu a epTeXu.

- Rozlišují se 8bitové znaky a japonské znaky, jak je diskutováno v článku TUGboat od Hironori Kitagawy ( https://tug.org/TUGboat/tb41-3/tb129kitagawa-char.pdf).

XeTeX: Nové skripty na spouštění xetex-unsafe a xelatex-unsafe pro jednodušší překlad dokumentů požadujících oba operátory průhlednosti XeTeX a PSTricks, což je ze své podstaty nebezpečné (dokud a pokud nedojde k reimplementaci v Ghostscriptu). Pro bezpečnost použijte Lua(LA )TeX.

Dvipdfmx:

- Podpora pro PSTricks bez nutnosti -dNOSAFER, kromě transparentnosti.

- Volba -r pro nastavení rozlíšení bitmapových fontů opět funguje.

Dvips: Ve výchozím nastavení se nepokoušejte o automatické nastavení média pro otočené velikosti papíru; nová volba --landscaperotate ho znovu povolí.

upmendex: Experimentální podpora pro arabské a hebrejské skripty; vylepšená klasiﬁkace znaků a jazyková podpora.

Kpathsea: První cesta vrácená z kpsewhich -all je nyní stejná jako při běžném (ne -all) vyhledávání.

tlmgr a infrastruktura:

- standardně používájí https pro mirror.ctan.org.

- používájí TEXMFROOT místo SELFAUTOPARENT pro snazší přemisťování.

- install-tl: pokud stahování nebo instalace pro daný balíček selže, bude automaticky pokračovat a později to zopakuje (jednou).

MacTeX: MacTeX a jeho binární složka universal-darwin vyžadují macOS 10.14 nebo vyšší (Mojave, Catalina, Big Sur, Monterey). Binární složka x86_64-darwinlegacy, dostupná pouze s Unixem install-tl, podporuje 10.6 (Snow Leopard) a novější.

Platformy: Žádné změny v podpoře platforem pro tento rok (2022). Nicméně, pro vydání v příštím roce (2023) plánujeme přechod binárních souborů Windows z 32-bit na 64-bit. Bohužel nedokážeme realizovat podporu pro oba současně.

##### 9.2.3 2023

Windows: Jak bylo oznámeno dříve, TeX Live nyní obsahuje 64bitové binární soubory pro Windows namísto 32bitových. Nový název adresáře je bin/windows (nezdá se správné vkládat 64bitové binární soubory do adresáře pojmenovaného “32”). Víme, že to způsobí dodatečnou práci pro uživatele Windows, ale zdálo se, že neexistuje žádná lepší alternativa. Pokud potřebujete podporu 32bitového systému Windows, budete si muset nainstalovat TeX Live 2022. Od Windows 11 dále, Windows na ARM podporují emulaci 64bitové verze AMD/Intel a tak může používat aktuální TeX Live. Nicméně Windows 10 na ARM neumí emulovat Intel/AMD 64-bit, a proto bude potřebovat také 32-bitový TeX Live. Viz samostatnou webovou stránku TeX Live pro Windows ( https://tug.org/texlive/windows.html).

Rozšíření pro různé verze sázecích programů (kromě původních TeXu a e-TeXu): \special následované novým klíčovým slovem „shipout“ zpožďuje rozšíření tokenů argumentů do času \shipout, jako non-\immediate\write.

epTeX, eupTeX:

- „Prvotní“ (u)ptex již není sestavován; (u)ptex nyní běží v režimu kompatibility e(u)ptexu. Totéž platí pro nástroje pTeXu, které jsou uvedeny níže.

- Nová primitiva: \tojis, \ptextracingfonts, \ptexfontname.

- Pro \font je podporována nová syntaxe pro JIS/UCS.

LuaTeX:

- Nový primitiv \variablefam umožňuje zachovat třídu matematických znaků a zároveň nechat rodinu, aby se přizpůsobila.

- Vylepšené oblasti anotací r2l.

- „Zpožďující \special“ pro různé verze sázecích programů popsaný výše.

- V LuaTeXu 1.17.0, vydaném v květnu 2023: knihovna socketů je nyní ve výchozím nastavení zakázána; nová možnost příkazového řádku –socket to umožňuje, stejně jako –shell-escape (ne –shell-restricted). Navíc knihovna mime je nyní vždy dostupná a nové funkce os.socketsleep a os.socketgettime jsou také vždy k dispozici. Nakonec nějaké obskurní způsoby, jak obejít různé bezpečnostní prvky, byly opraveny.

MetaPost: Opravy chyb. svg->dx a svg->dy jsou nyní pro lepší přesnost double; aktualizován mp_begin_itration; opraven únik paměti v mplib.

pdfTeX:

- Nový primitiv \pdfomitinfodict k úplnému vynechání slovníku /Info.

- Nový primitiv \pdfomitprocset pro ovládání vynechání pole /ProcSet: /ProcSet je zahrnuto, pokud je tento parametr záporný, nebo pokud je tento parametr nulový a pdftex generovuje výstup PDF 1.x.

- S \pdfinterwordspaceon, pokud aktuální kódování písma má na pozici 32 znak /space, je použit; v opačném případě se používá /space z (nového) výchozího písma pdftexspace. Toto výchozí písmo lze přepsat novým primitivem \pdfspacefont. Stejný nový postup se používá pro \pdffakespace.

pTeX a další:

- Jak bylo uvedeno výše, ptex nyní spouští eptex v režimu kompatibility místo toho, aby byl sestaven samostatně.

- Nástroje pTeXu (pbibtex, pdvitype, ppltotf, ptftopl) sloučeny do odpovídajících verzí upTeXu, běží v režimu kompatibility.

XeTeX: opraven výpočet \topskip a \splittopskip, když je aktivní \XeTeXupwardsmode; „zpožďující \special“ popsaný výše.

Dvipdfmx: nová volba --pdfm-str-utf8 pro vytvoření „pdfmark“ a/nebo záložky.

BibTeX:

- Tato varianta BibTeXu je většinou směrem zpětně kompatibilní s BibTeXem, s mnohem lepší vícejazyčnou podporou (založenou na Unicode). Byla v TeX Live několik let.

- Letos byly přidány další funkce pro podporu jazyků CJK, některé se rozšířily z japonského (u)pbibtexu a dalších programů.

Kpathsea: podpora odhadu kódování vstupních souborů pro platformy Unixu jako na Windows; povolena pro (e)p(la)tex, pbibtex, mendex.

tlmgr a infrastruktura:

- výchozí pro textové rozhraní na macOS,

- nejprve nainstaluje základní balíčky, instalaci ostatních balíčků opakuje jedenkrát (pokud stahování nebo instalace pro daný balíček selže),

- vykonávají se jednodušší kontroly dostatku místa na disku.

MacTeX:

- MacTeX a jeho binární složka universal-darwin vyžadují macOS 10.14 nebo vyšší (Mojave, Catalina, Big Sur, Monterey, Ventura). Binární složka x86_64-darwinlegacy, k dispozici pouze s unixovým install-tl, podporuje 10.6 (Snow Leopard) a pozdější.

- Balíček GUI v MacTeXu nyní obsahuje hintview, prohlížeč dokumentů HINT pro macOS (vytvořený pomocí sázecích programů pro mobilní zařízení hitex a hilatex; viz webovou stránku HiTeXu https://hint.userweb.mwn.de/hint/hitex.html). Balíček GUI již nenainstaluje složku dokumentů a nahradí je stručným READ ME pro nové uživatele a stránkou o hintview.

- The GUI package in MacTeX now contains hintview, a macOS viewer for HINT documents (created by the hitex and hilatex engines for mobile devices; see the HiTeX web page, https://hint.userweb.mwn.de/hint/hitex.html). The GUI package no longer installs a folder of documents, replacing them with a short READ ME for new users and a page about hintview.

- Složka Extras dalšího softwaru TeX na DVD byla nahrazena dokumentem obsahujícím odkazy na stránky ke stažení.

Platformy:

- Jak bylo zmíněno výše, nový binární adresář windows obsahuje 64bitové binární soubory pro Windows a

- binární adresář bin/win32 je pryč, protože nemůžeme podporovat 32bitové a 64bitové Windows současně.

- Binární adresář i386-cygwin je pryč, protože Cygwin již nepodporuje i386.

#### 9.3 Současnost: 2024

Změny pro různé verze sázecích programů (kromě původních TeX, e-TeX a LuaTeXu):

- Vyhněte se zhroucení při nesprávném použití párů \output a \write.

- Drobná optimalizace vnitřní smyčky. (Obě tyto změny jsou způsobeny Davidem Fuchsem.)

LuaTeX:

- Kontroly na úrovni Lua pro zápis do souborů, které jsou nyní podobné jako kontroly na úrovni TeXu.

- Pokud je nastavena hodnota Lua texconfig.trace_extra_newline, v protokolu mezi parametry makra se vypisují prázdné řádky. V r. 2020–2023 tomu tak bylo standardně; před tím takové prázdné řádky nebyly nikdy na výstupu, což je chování ostatních verzí sázecích programů.

- V minulosti texlua pod Windows (nikoli luatex a ne jakákoli jiná platforma), interně prováděl rozšíření zástupných znaků na argumenty. To se již neděje.

MetaPost:

- MPFI knihovna nyní zahrnuta pro intervalovou aritmetiku; umožněno volbou --numbersystem=interval.

pdfTeX:

- Spolehlivější extrakce textu na systémech BigEndian.

- Více kontrol proti poškozeným souborům pfb, fmt, pdf.

- Vyhněte se psaní poškozeného pdf vzhledem k neobvyklým zahrnutím pdf.

- Příručka převedena na LaTeX a důkladně zkontrolována, ačkoli podstatné aktualizace jsou minimální.

epTeX, eupTeX:

- Nový jednoduchý nástroj pro převod kódování ptekf.

- eptex se již nestaví samostatně; běží v;režimu legacy-encoding programu euptex.

XeTeX:

- Podporovány jsou znaky Unicode v názvech souborů mimo BMP.

Dvipdfmx:

- Vypočítá posun časové zóny stejným způsobem jako pdfTeX.

- Ovládejte selektory variací, abyste si poradili s novým Adobe-Japan1-UCS2 CMap.

- Záložní vícebajtové znaky ve virtuálních fontech na OFM fonty pro (u)pTeX.

- Podpora klíčového slova named ve „special“ pdf:image.

Kpathsea:

- Podpora rozšířené kontroly bezpečných jmen souborů, která také umožňuje zápis pod TEXMF[SYS]VAR, pro Lua(LA )TeX; nové funkce a odpovídající volby kpsewhich.

- Podpora nové proměnné TEXMF_OUTPUT_DIRECTORY (vedle tradiční TEXMFOUTPUT), takže podprogramy mohou mít přístup k nastavení --output-directory při vyvolání sázecího programu.

CWEB:

- Podpora LuaTeXu jako backend sázecího programu TeXu.

- Opraveno přetečení vyrovnávací paměti na řádcích bez bodu přerušení.

tlmgr:

- Nová akce bug, která pomůže najít informace o hlášení chyb.

- Použijte náš vlastní balíček kořenových certiﬁkátů na všech platformách pro podporu LWP v širším měřítku, zejména na macOS.

- Detekujte vzdálené úložiště starší než místní instalace (tj. zastaralé zrcadlo) a neaktualizujte, abyste předešli nesprávnému odstranění balíčků.

- Podpora nastavení velikosti papíru v ConTeXtu.

- Ořízněte zálohy souborů tlpdb pro zrcadlená úložiště (hlavní a tlcontrib).

Platformy:

- Obraz ISO opět obsahuje binární soubory pro všechny platformy. V posledních několika letech byly některé binární sady oříznuty, ale letos nevytváříme fyzické DVD jako výhodu pro skupinu uživatelů, takže můžeme znovu vše zahrnout. Také, dokonce i maximálně-prořezaný obraz je příliš velký na to, aby se vešel na jednovrstvé DVD, takže prořezávání nemá žádný přínos pro dobrovolné napalovače v roce 2024. Více informací na https://tug.org/texcollection/.

- Robert Alessi poskytuje binární soubory pro nativní instalaci TeX Live pod OpenBSD na https://sr.ht/~ralessi/texlive-openbsd/.

MacTeX: nyní obsahuje nejnovější Ghostscript 10.03.0, aktualizace ze všech čtyř programů GUI spolu se všemi novými změnami TeX Live (jako vždy). Binární soubory stále podporují macOS 10.14 (Mojave, 2018) a novější. (Jako obvykle, starší verze Mac jsou podporovány binárními soubory x86_64-darwinlegacy, které jsou součástí TeX Live, ale ne MacTeX.)

#### 9.4 Budoucnost

Máme v úmyslu pokračovat v pravidelných vydáních TeX Live a rádi bychom poskytovali více dokumentace, více programů, a také stále aktualizovaný a lépe zkontrolovaný strom maker a fontů, a vše ostatní pro TeX. Tato práce je prováděna dobrovolníky v jejich omezeném volném čase a tedy vždy je co dodělávat. Viz, prosím, https://tug.org/texlive/contribute.html.

Prosíme, pošlete opravy, návrhy, náměty a nabídky pomoci na:

> tex-live@tug.org (nemusíte se přihlásit, abyste mohli posílat příspěvky)
> https://tug.org/texlive

Šťastné TeXování!

1 Od verzie TeX Live 7 nie je nutné túto voľbu nastavovať, pretože Type1 fonty sú načítané implicitne.

2 Ke korektuře českého a slovenského překladu přispěli v letech 2001–2015 kromě výše uvedených autorů Jaromír Kuben, Milan Matlák, Zbyněk Michálek, Tomáš Obšívač, Karel Píška, Tomáš Polešovský, Libor Škarvada, Zdeněk Wagner a další. Michal Mádr editoval cs.po a přeložil soubor README.EN.