TEX Live 2009Příručka TEX Live, CS verze 1.37

Karl Berry, editor

http://tug.org/texlive/

20. října 2009

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

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

Obsah1 Úvodem 21.1 TEX Live a kolekce TEXu 21.2 Podpora operačních systémů 31.3 Základní instalace TEX Live 31.4 Nápověda 32 Přehled TEX Live 42.1 Kolekce TEXu: TEX Live, proTEXt, MacTEX 42.2 Popis kořenových adresářů TEX Live 42.3 Přehled předdefinovaných stromů texmf 42.4 Rozšíření TEXu 52.5 Další za zmínku stojící programy na TEX Live 62.6 Fonty v TEX Live 63 Instalace 63.1 Spuštění instalačního programu 63.1.1 Unix 63.1.2 MacOSX 73.1.3 Windows 73.1.4 Cygwin 73.1.5 Textový instalační program 73.1.6 Grafický instalační program pro zkušené 83.1.7 Jednoduchý průvodce instalací 83.2 Spuštění instalačního programu 83.2.1 Nabídka binárních systémů (pouze Unix) 83.2.2 Volba obsahu instalace 83.2.3 Adresáře 93.2.4 Volby 103.2.5 Nastavení spouštění z DVD (pouze v textovém režimu) 113.3 Volby příkazového řádku pro install-tl 123.3.1 Volba -repository 123.4 Poinstalační činnosti 133.4.1 Windows 133.4.2 Pokud byly vytvořeny symbolické odkazy 133.4.3 Proměnné prostředí pro Unix 133.4.4 Proměnné prostředí: globální konfigurace 133.4.5 Konfigurace fontů pro XeTEX 133.4.6 Při spuštění TEX Live z DVD 14

1

http://tug.org/texlive/

SEZNAM TABULEK 2

3.4.7 ConTEXt Mark IV 143.4.8 Začleňování lokálních a osobních maker 143.4.9 Začleňování fontů třetích stran 143.5 Testování instalace 143.6 Odkazy na doplňkový software s možností stažení z Internetu 154 Síťové instalace 165 Maximálně mobilní TEX Live na DVD a USB 166 tlmgr: správa vaší instalace 176.1 GUI režim tlmgr 176.2 Vzorové realizace tlmgr z příkazového řádku 187 Poznámky o Windows 197.1 Vlastnosti typické pro Windows 197.2 Dodatečný obsažený software pod Windows 197.3 User Profile je Home 207.4 Registry Windows 207.5 Oprávnění Windows 208 Používateľská príručka ku systému Web2C 218.1 Vyhľadávanie ciest knižnicou Kpathsea 218.1.1 Zdroje cesty 228.1.2 Konfiguračné súbory 228.1.3 Expanzia cesty 238.1.4 Predvolená expanzia 238.1.5 Expanzia zátvoriek 238.1.6 Expanzia podadresárov 248.1.7 Typy špeciálnych znakov a ich význam: zhrnutie 248.2 Databázy názvov súborov 248.2.1 Súborová databáza 248.2.2 kpsewhich: samostatné prehľadávanie cesty 248.2.3 Príklady použitia 258.2.4 Ladiace činnosti 268.3 Možnosti nastavenia za behu programu 289 Poděkování 2910 Historie vydání 3010.1 Minulost 3010.1.1 2003 3110.1.2 2004 3110.1.3 2005 3310.1.4 2006–2007 3310.1.5 2008 3410.2 Současnost 3410.3 Budoucnost 35

Seznam tabulek

1 Úvodem1.1 TEX Live a kolekce TEXuTento dokument popisuje základní vlastnosti distribuce TEX Live 2009, což je instalace TEXu apříbuzných programů pro GNU/Linux a další unixové systémy, MacOSX a (32bitové) systémyWindows.

TEX Live můžete získat stažením z internetu, nebo na TEX-kolekce DVD. Některé skupinyuž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. Tentodokument popisuje převážně samotný TEX Live.

TEX Live obsahuje .exe soubory pro TEX, LATEX2ε, ConTEXt, METAFONT, MetaPost,BibTEX a mnoho dalších programů včetně obsáhlého seznamu maker, fontů a dokumentacespolu s podporou sazby v mnoha různých světových jazycích.

1 ÚVODEM 3

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

1.2 Podpora operačních systémůTEX Live obsahuje binárky pro mnohé unixové architektury, včetně GNU/Linux a MacOSX.K dispozici jsou také binárky Cygwin. Obsažené zdrojové texty mohou být zkompilovány proplatformy, pro které nejsou k dispozici binárky.

Co se týče Windows: podporovány jsou jenom Windows 2000 a pozdější verze. Upustilijsme od podpory Windows 9x, ME a NT. V důsledku této změny si Windows vyžaduje mnohemméně zvláštního zacházení ve srovnání s Unixovými systémy. Pro Windows nejsou k dispozici64bitové .exe soubory, ale 32bitové binárky by měly běžet na 64bitových systémech.

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

1.3 Základní instalace TEX LiveTEX Live můžete nainstalovat buď z DVD nebo z internetu. Samotný síťový instalační programje malý a vše požadované stáhne z internetu. Síťový instalační program je vhodné použít, kdyžpotřebujete jenom část z kompletní instalace TEX Live.

Instalační program na DVD vám umožní instalaci na lokálním disku, avšak TEX Livemůžete spustit přímo z DVD (nebo z obrazu DVD, když to váš systém podporuje). Instalace jepopsána v následujících sekcích, zde jen souhrn:

• Instalační dávka se jmenuje install-tl . Může pracovat v „průvodcovském režimu“po zadání volby -gui=wizard (předvolba pro Windows), v textovém režimu zadanémvolbou -gui=text (předvoleném pro všechny ostatní systémy), nebo v GUI režimu propokročilé zadaném volbou -gui=perltk.

• Jednou součástí instalace je program, ‘TEX Live Manager’, nazvaný tlmgr. Podobně jakoinstalační program může být použit v režimu GUI nebo v textovém režimu. Můžete hopoužít k nainstalování nebo odinstalování balíků a na různé konfigurační činnosti.

1.4 NápovědaTEXovská 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 čtenáři 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žítepo garantované komerční podpoře, můžete na TEX Live zapomenout a zakoupit komerčnídistribuci; viz seznam prodejců na http://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 http://tug.org/begin.html najdete

krátký úvod do systému.TEX FAQ TEX FAQ je obrovská studnice znalostí obsahující všechny druhy otázek, od

těch základních až po ty nejobskurnější. Dokument najdete na TEX Live v ad-resáři texmf-dist/doc/generic/FAQ-en/html/index.html nebo na internetu nahttp://www.tex.ac.uk/faq. Prosíme, začněte své hledání odpovědi zde.

TEX Catalogue Pokud hledáte konkrétní balík, font, program ap., TEX Catalogue je místo,kde začít. Je to obsáhlá sbírka TEXových položek. Viz http://www.ctan.org/help/Catalogue/.

TEXové odkazy na Webu Na http://tug.org/interest.html najdete mnoho relevant-ních odkazů na různé příručky, knihy, manuály a články o všech aspektech systémuTEX.

archívy diskusních skupin Dvě základní fóra pro hledání řešení problémů jsou newsová sku-pina news:comp.text.tex a emailová diskusní skupina texhax@tug.org. V archívechtěchto zdrojů najdete tisíce předchozích dotazů a odpovědí čekajících na vaše hledání.Nahlédněte na http://groups.google.com/groups?group=comp.text.tex, respekti-ve na http://tug.org/mail-archives/texhax. Dotazem do obecného vyhledávacíhostroje jako http://google.com/ také nic nepokazíte a pro specifika č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 news:comp.text.tex přes Google nebo newsového klienta nebo emailem na texhax@tug.org.Ale dříve, než tak učiníte, prosím, přečtěte si toto doporučení, abyste maximalizovali vy-hlídky na získání užitečné odpovědi: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion.

http://tug.org/interest.html#vendorshttp://tug.org/begin.htmlfile:../../../../texmf-dist/doc/generic/FAQ-en/html/index.htmlhttp://www.tex.ac.uk/faq../../../../http://www.ctan.org/help/Catalogue/../../../../http://www.ctan.org/help/Catalogue/http://tug.org/interest.htmlnews:comp.text.texmailto:texhax@tug.orghttp://groups.google.com/groups?group=comp.text.texhttp://tug.org/mail-archives/texhaxhttp://google.com/http://www.cstug.cz/news:comp.text.texnews:comp.text.texmailto:texhax@tug.orghttp://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestionhttp://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion

2 PŘEHLED TEX LIVE 4

podpora TEX Live Pokud chcete poslat chybové hlášení, připomínku nebo poznámku k dis-tribuci TEX Live, její instalaci nebo dokumentaci, diskusní skupina k tomu určená jetex-live@tug.org. Pokud však je vaše otázka specifická pro program na TEX Liveumístěný, napište prosím přímo autorovi nebo do diskusní skupiny určené pro tentoprogram. Spuštění programu s volbou --help nezřídka poskytuje adresu pro chybovéhlášení.

Druhou stranou mince je odpovídání na dotazy těch, kdo kladou otázky. news:comp.text.texi list texhax jsou otevřeny pro kohokoliv. Přihlaste se, naslouchejte a začněte odpovídat tam,kde můžete.

2 Přehled TEX LiveTento oddíl popisuje obsah TEX Live a TEX-kolekce, jejíž je částí.

2.1 Kolekce TEXu: TEX Live, proTEXt, MacTEXDVD TEX-kolekce zahrnuje následující:TEX Live Úplný systém TEX, který může být spouštěn přímo nebo nainstalován na disk.

Jeho domovská stránka je http://tug.org/texlive/.MacTEX pro MacOSX, přidává přirozený MacOSX instalační program a jiné aplikace Mac

k TEX Live. Jeho domovská stránka je http://tug.org/mactex/.proTEXt Rozšíření systému MiKTEX pro Windows. proTEXt přidává k MiKTEXu nové doplň-

kové nástroje a zjednodušuje instalaci. Je plně nezávislý na TEX Live a má své vlastnípříkazy. Domovská stránka projektu proTEXt je na http://tug.org/protext.

CTAN Výpis obrazovky skladiště CTAN (http://www.ctan.org).texmf-extra Adresář s rozmanitými doplňkovými balíky.

CTAN, protext a texmf-extra nemusí mít stejné podmínky pro kopírování jako TEXLive, proto buďte pozorní při šíření nebo modifikaci.

2.2 Popis kořenových adresářů TEX LiveTady uvádíme stručný seznam a popis kořenových adresářů distribuce TEX Live. Na TEXCollection DVD je celá TEX Live hierarchie v podaresáři texlive, a ne v kořenovém adresářidisku.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ě distribuce Web2C TEXu a METAFONTu.texmf Viz TEXMFMAIN níže.texmf-dist Viz TEXMFDIST níže.tlpkg Skripty, programy a údaje pro správu instalace a nějakou přídavnou podporu pro

Windows.V kořenovém adresáři distribuce jsou navíc instalační dávky a soubory README (v růz-

ných jazycích).Co se týče dokumentace, užitečné mohou být obsáhlé odkazy v kořenovém souboru

doc.html. Dokumentace programů (manuály, man-stránky, info-soubory) jsou v texmf/doc.Dokumentace TEXových balíků a formátů je v texmf-dist/doc. K vyhledání veškeré doku-mentace na libovolném místě můžete použít programy texdoc.

Samotná tato příručka TEX Live je k dispozici v několika jazycích v adresáři texmf-doc:• zjednodušená čínština: texmf/doc/texlive/texlive-zh-cn• česko-slovenská: texmf/doc/texlive/texlive-cz• anglická: texmf/doc/texlive/texlive-en• francouzská: texmf/doc/texlive/texlive-fr• německá: texmf/doc/texlive/texlive-de• polská: texmf/doc/texlive/texlive-pl• ruská: texmf/doc/texlive/texlive-ru

2.3 Přehled předdefinovaných stromů texmfTento oddíl uvádí seznam předdefinovaných proměnných určujících stromy texmf, používa-ných systémem, a jejich zamýšlený účel a standardní uspořádání systému TEX Live. Povel

mailto:tex-live@tug.orgnews:comp.text.texhttp://tug.org/texlive/http://tug.org/mactex/http://tug.org/protexthttp://www.ctan.orgfile:../../../../doc.html

2 PŘEHLED TEX LIVE 5

tlmgr conf ukáže hodnoty těchto proměnných, tedy můžete jednoduše zjistit, jak tyto odpo-vídají jednotlivým adresářům ve vaší instalaci.TEXMFMAIN Strom obsahující životně důležité části systému, jako konfigurační soubory, po-

mocné skripty a dokumentaci programu.TEXMFDIST Strom obsahující hlavní sadu balíků maker, fontů, atd.TEXMFLOCAL Strom, který mohou použít administrátoři na instalaci doplňkových nebo upra-

vených maker, fontů, atd., pro celý systém.TEXMFHOME Strom, který mohou použít uživatelé na svoje osobní instalace doplňkových nebo

upravených maker, fontů, atd. Rozšíření této proměnné se dynamicky nastaví pro kaž-dého uživatele na jeho vlastní osobní adresář.

TEXMFCONFIG Strom používaný nástroji texconfig, updmap a fmtutil na uložení modifiko-vaných konfiguračních údajů. Implicitně pod TEXMFHOME.

TEXMFSYSCONFIG Strom používaný nástroji texconfig-sys, updmap-sys a fmtutil-sys nauložení modifikovaných konfiguračních údajů.

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

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

Standardní struktura je:system-wide root může obsáhnout vícenásobné vydání TEX Live:

2008 Předchozí vydání.2009 Nynější vydání.

bini386-linux binárky systému GNU/Linux...universal-darwin binárky systému MacOSXwin32 binárky systému Windows

texmf Toto je TEXMFMAIN.texmf-dist TEXMFDISTtexmf-var TEXMFSYSVARtexmf-config TEXMFSYSCONFIG

texmf-local TEXMFLOCAL, zamýšlený být zachován od vydání k vydání.domovský adresář uživatele ($HOME nebo %USERPROFILE%)

.texlive2008 Soukromě generované a konfigurační údaje předchozího vydání.

.texlive2009 Soukromě generované a konfigurační údaje aktuálního vydání.texmf-var TEXMFVARtexmf-config TEXMFCONFIG

texmf TEXMFHOME Osobní makra atd.

2.4 Rozšíření TEXuSamotný Knuthův původní TEX je zmrazený, kromě ojedinělých oprav chyb. Stále je v TEXLive přítomen jako program tex a tak to zůstane v dohledné budoucnosti. TEX Live obsahujeněkolik rozšířených verzí TEXu:ε-TEX přidává množinu nových příkazů (nazývaných TEXové primitivy). Nové příkazy se na-

příklad týkají makroexpanze, načítání znaků, tříd značek (marks), rozšířených ladicíchmožností a rozšíření TEX--XET pro obousměrnou sazbu. Implicitně je ε-TEX 100% kom-patibilní se standardním TEXem. Viz texmf-dist/doc/etex/base/etex_man.pdf.

pdfTEX vybudován na rozšířeních ε-TEXu přidává podporu zápisu ve formátu PDF stejně jakov DVI a četná rozšíření netýkající se výstupu. Toto je program používaný pro většinu for-mátů, například, etex, latex, pdflatex. Jeho stránka je http://www.pdftex.org/. Viz ná-vod texmf-dist/doc/pdftex/manual/pdftex-a.pdf a texmf/doc/pdftex/manual/samplepdf/samplepdf.tex pro vzorové použití některých jeho vlastností.

LuaTEX je označován za nástupce pdfTEX/u, se kterým je z větší části (ale ne úplně) zpětněkompatibilní. Měl by se také stát funkční podmnožinou systému Aleph, viz dále, ačkolitechnická kompatibilita není zamýšlena. Zabudovaný interpret Lua (http://www.lua.org/) umožňuje elegantní řešení mnoha ožehavých TEXovských problémů. Volaný po-velem texlua, funguje jako samostatný interpret Lua, a jako taký je již použit v rámci

http://www.pdftex.org/file:../../../../texmf/doc/pdftex/manual/samplepdf/samplepdf.texfile:../../../../texmf/doc/pdftex/manual/samplepdf/samplepdf.texhttp://www.lua.org/http://www.lua.org/

3 INSTALACE 6

TEX Live. Jeho stránka je http://www.luatex.org/ a příručka je texmf-dist/doc/luatex/luatexref-t.pdf.

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

Ω (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 (Ω Translation Processes, OTP) pro realizacisložitých transformací na jakémkoliv vstupu. Omega už není součástí TEX Live jakosamostatný program; poskytnutý je jenom Aleph:

Aleph kombinuje rozšíření Ω a ε-TEX. Pro minimální dokumentaci viz texmf-dist/doc/aleph/base.

2.5 Další za zmínku stojící programy na TEX LiveNa TEX Live najdete několik často používaných programů:bibtex podpora práce se seznamem literatury.makeindex, xindy vytváření rejstříku. Pro češtinu a slovenštinu však potřebujete verzi pro-

gramu s názvem csindex (není zatím součástí distribuce, je potřeba instalovat zvlášť).dvips pro konverzi DVI do PostScript.xdvi prohlížeč DVI pro systém X Window.dvilj DVI ovladač tiskáren HP LaserJet.dviconcat, dviselect pro kopii a vkládání stránek do/z DVI souborů.dvipdfmx konvertor DVI do PDF, alternativní přístup vedle pdfTEXu zmíněného výše. Srovnej

balíky ps4pdf a pdftricks pro další alternativy.psselect, psnup, . . . programy pro práci s PostScriptem.texexec, texmfstart wrapper pro ConTEXt a práci s PDF.tex4ht konvertor TEXu do HTML.

2.6 Fonty v TEX LiveTEX Live přináší množství vysoce kvalitních vektorových fontů. Viz http://tug.org/fontsa texmf-dist/doc/fonts/free-math-font-survey.

3 Instalace3.1 Spuštění instalačního programuPro začátek si obstarejte TEX Collection DVD nebo si stáhněte síťový instalační program TEXLive, a najděte instalační skript: install-tl pro Unix, install-tl.bat pro Windows.Síťový instalátor: stáhněte z CTANu, z adresáře systems/texlive/tlnet; url http:

//mirror.ctan.org/systems/texlive/tlnet vás automaticky přesměruje na blízký,aktuální mirror. Můžete získat install-tl.zip, který může být použit pod Unixema Windows nebo jenom pro Unix podstatně menší install-unx.tar.gz. Po rozbaleníse install-tl a install-tl.bat objeví v podadresáři install-tl.

DVD TEX kolekce: vejděte do podadresáře texlive. Pod Windows se instalátor normálněspustí automaticky po vložení DVD. DVD můžete získat, když se stanete členem skupinyuživatelů TEXu (vřele doporučujeme, http://tug.org/usergroups.html), nebo si hozvlášť zakoupíte (http://tug.org/store), anebo si vypálíte svoje vlastní z ISO obrazu.

Pro další informace a způsoby získání softveru navštivte http://tug.org/texlive/acquire.html.

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

3.1.1 UnixDále > označuje výzvu (prompt shellu); vstup uživatele vstup je zvýrazněn. terminálu je :Skript install-tl je Perlovský skript. Nejjednodušší způsob jeho spuštění v Unixovskémsystému je následující:> cd /path/to/installer> perl install-tl(Nebo můžete vyvolat perl /path/to/installer/install-tl, nebo ./install-tl když jespustitelný, atd.; nechceme opakovat všechny tyto variace.) Možná zvětšíte okno terminálu abyukazovalo celou obrazovku textového instalátora (obr. 1).

K instalaci v pokročilém režimu GUI (obr. 2; budete potřebovat modul Perl/TK), pou-žijte:

http://www.luatex.org/http://tug.org/xetexhttp://tug.org/fontshttp://mirror.ctan.org/systems/texlive/tlnethttp://mirror.ctan.org/systems/texlive/tlnethttp://tug.org/usergroups.htmlhttp://tug.org/storehttp://tug.org/texlive/acquire.htmlhttp://tug.org/texlive/acquire.html

3 INSTALACE 7

> perl install-tl -guiÚplný seznam různých voleb získáte povelem:

> perl install-tl -helpVarování o oprávněních Unixu: Vaše nastavení umask v čase instalace bude respek-

tová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 Unixovských systémů,Cygwin implicitně neobsahuje všechny nezbytné programy, které instalátor TEX Livepotřebuje. Pro podrobnosti viz sekci 3.1.4.

3.1.2 MacOSXJak již bylo zmíněno v sekci 2.1, pro MacOSX je připravena samostatná distribuce, na-zvaná MacTEX (http://tug.org/mactex). Doporučujeme použít původní instalační programMacTEX u namísto instalátoru TEX Live pod MacOSX, protože původní (nativní) instalá-tor provede několik nastavení specifických pro Mac, zejména umožňuje snadné přepínání mezirůznými distribucemi TEXu pro MacOSX (MacTEX, gwTEX, Fink, MacPorts, . . . ).

MacTEX je silně založen na TEX Live, a hlavní TEXovská stromová struktura je přesněstejná. Přidává několik dalších adresářů s dokumentací a aplikacemi specifickými pro Mac.

3.1.3 WindowsJestliže používáte síťový instalátor, nebo instalační program DVD se nespustí automaticky,klikněte dvakrát na soubor install-tl.bat. Pro více voleb pro úpravy, např. výběr určitékolekce balíků, spusťte namísto něho install-tl-advanced.bat.

Můžete také spustit instalační program z příkazového řádku. Dále > označuje promptshellu; vstup uživatele je polotučný. Pokus jste v adresáři instalačního programu, jenomspusťte:> install-tl

Můžete to také vyvolat zadáním absolutní polohy, jako například:> D:\texlive\install-tlpro TEX-kolekce DVD, za předpokladu, že D: je optický disk. Obr. 3 zobrazuje průvodcovskýinstalátor, který je pro Windows implicitní.

Pro instalaci v textovém režimu použijte:> install-tl -no-gui

Pro úplný seznam různých voleb zadejte:> install-tl -help

3.1.4 CygwinInstalátor TEX Live odporuje pouze Cygwin 1.7. Před začátkem instalace použijte programCygwinu setup.exe k instalaci balíkov perl a wget pokud jste tak ještě neudělali. Doporučenéjsou následující doplňkové balíky:

• fontconfig [potřebný pro XeTEX ]• 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í programObrázek 1 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. Napří-klad, nemůžete se pohybovat v zatrhávacích rámečcích nebo vstupních polích. Jenom napíšeteněco (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 v Perlu.

http://tug.org/mactex

3 INSTALACE 8

Installing TeX Live 2009 from: ...Platform: i386-linux => ’Intel x86 with GNU/Linux’Distribution: live (uncompressed)...Detected platform: Intel x86 with GNU/Linux

binary systems: 1 out of 14

Installation scheme (scheme-full)83 collections out of 84, disk space required: 1882 MB

Customizing installation scheme: standard collections language collections

directories:TEXDIR (the main TeX directory):

/usr/local/texlive/2009TEXMFLOCAL (directory for site-wide local files):

/usr/local/texlive/texmf-localTEXMFSYSVAR (directory for variable and automatically generated data):

/usr/local/texlive/2009/texmf-varTEXMFSYSCONFIG (directory for local config):

/usr/local/texlive/2009/texmf-configTEXMFHOME (directory for user-specific files):

~/texmf

options:[ ] use letter size instead of A4 by default[X] create all format files[X] install macro/font doc tree[X] install macro/font source tree[ ] create symlinks to standard directories

set up for running from DVD

Other actions: start installation to hard disk help quit

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

3.1.6 Grafický instalační program pro zkušenéObrázek 2 ukazuje grafický instalátor pro znalce pod GNU/Linux. Kromě toho, že využívátlačítka a nabídky, se tento instalátor velmi neliší od textového (obr. 1).

Tento režim může být vyvolán explicitně pomocí> install-tl -gui=perltk

3.1.7 Jednoduchý průvodce instalacíPodWindows 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 vše nastavení upravit, musíte spustit některý z dalších instalátorů.

Tento režim může být vyvolán explicitně povelem> install-tl -gui=wizard

3.2 Spuštění instalačního programuInstalátor je zamýšlený jako co nejvíce samovysvětlující. Nicméně následuje několik poznámeko jednotlivých volbách a dílčích nabídkách:

3.2.1 Nabídka binárních systémů (pouze Unix)Obrázek 4 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 binárky projinou architekturu. Toto může být užitečné, pokud sdílíte TEXovský strom v síti heterogenníchstrojů, nebo na systému s dvojitým zaváděcím procesem.

3.2.2 Volba obsahu instalaceObrázek 5 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, avšak můžete takézvolit schéma basic pro malý systém, minimal pro účely testování, a schéma medium nebo

3 INSTALACE 9

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

teTeX pro získání něčeho mezi tím. K dispozici jsou také různá specializovaná schémata aschémata specifická pro některé země.

Svůj výběr schématu můžete upřesnit pomocí nabídek ‘standard collections’ a ‘languagecollections’ (obrázek 6, ukázané pro změnu v režimu GUI).

Kolekce jsou o jednu úroveň podrobnější než schémata—v podstatě, schéma je tvořenoně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 instalacimůžete použít program tlmgr (viz sekci 6); jeho použitím můžete řídit instalaci na úrovnibalíků.

3.2.3 AdresářeStandardní uspořádání je popsáno v sekci 2.3, na straně 4. Standardní umístění adresáře TEXDIRse liší pro Windows (%SystemDrive%\texlive\2009) a Unix (/usr/local/texlive/2009).

Hlavní důvod pro změnu této předvolby je nedostatek práv na zápis pro standardníumístění. Nemusíte být zrovna rootem nebo administrátorem, když instalujete TEX Live, alepotřebujete oprávnění na zápis do cílového adresáře.

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

Doporučujeme do názvu začlenit rok, co umožní zachování různých vydání TEX Live ve-dle sebe. (Můžete chtít vytvořit název nezávislý na verzi, například /usr/local/texlive-curpomocí 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, TEXMFSYSVARa TEXMFSYSCONFIG.

TEXMFHOME je doporučené umístění osobních souborů maker nebo balíků. Předvolenáhodnota je ~/texmf. Na rozdíl od TEXDIR, je nyní ~ uchována v nově vytvořených konfiguračníchsouborech, protože to užitečně odkazuje na domovský adresář kteréhokoliv běžícího TEXu.Expanduje se na $HOME pod Unixem a %USERPROFILE% pod Windows.

3 INSTALACE 10

Obrázek 3: Průvodcovská obrazovka instalátora (Windows)

Available sets of binaries:===============================================================================

a [ ] alpha-linux DEC Alpha with GNU/Linuxc [ ] hppa-hpux HP-UXe [X] i386-linux Intel x86 with GNU/Linuxf [ ] i386-openbsd Intel x86 with OpenBSDg [ ] i386-solaris Intel x86 with Sun Solarish [ ] mips-irix SGI IRIXi [ ] powerpc-aix PowerPC with AIXj [ ] powerpc-linux PowerPC with GNU/Linuxk [ ] sparc-linux Sparc with GNU/Linuxl [ ] sparc-solaris Sparc with Solarism [ ] universal-darwin universal binaries for MacOSX/Darwino [ ] win32 Windowsp [ ] x86_64-linux x86_64 with GNU/Linux

Obrázek 4: Nabídka binárek

3.2.4 VolbyObrázek 7 ukazuje nabídku voleb textového režimu. Další informace:

use letter size instead of A4 by default: Výběr standardní velikosti papíru. Jednotlivédokumenty mohou a měli by deklarovat zvláštní rozměr papíru, pokud je to žádoucí.

create format files: Přestože si vytvoření nepotřebných formátů vyžaduje čas a diskový pro-stor pro uložení, nicméně doporučujeme nechat tuto volbu vyznačenou: když ji nevy-

Select a scheme:====================================================================a [ ] basic scheme (plain and LaTeX)b [ ] ConTeXt schemec [X] full scheme (everything)d [ ] GUST TeX Live schemee [ ] GUTenberg TeX Live schemef [ ] medium scheme (plain, latex, recommended packages, some languages)g [ ] minimal scheme (plain only)h [ ] Omega schemei [ ] teTeX scheme (more than medium, but nowhere near full)j [ ] XML schemek [ ] custom selection of collections

Obrázek 5: Nabídka schémat

3 INSTALACE 11

Obrázek 6: Nabídka kolekcí

use letter size instead of A4 by default: [ ] create format files: [X] install font/macro doc tree: [X] install font/macro source tree: [X] create symlinks in standard directories: [ ]

binaries to:manpages to:

info to:

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

značíte, budou formátové soubory vytvořené v osobních stromech TEXMFVAR uživatelů,když budou zapotřebí. Na tomto místě nebudou automaticky aktualizované, když sebudou například obnovovat binárky nebo vzory dělení v instalaci, co může skončit ne-kompatibilními soubory formátů.

install font/macro . . . tree: Tyto volby vám umožní přeskočit stahování/instalci dokumen-tace a zdrojových souborů ve většine balíků. Nedoporučuje se.

create symlinks in standard directories (pouze Unix): Tato volba obchází potřebuzměny proměnných prostředí. Bez této volby je obvykle potřebné přidat adresáře TEXLive do proměnných PATH, MANPATH a INFOPATH. Budete muset přidělit práva na zápiscílovým adresářům. Důrazně doporučujeme nepřepsat TEXovský systém, který přišels vaším systémem s touto volbou. Toto je v první řadě určeno pro zpřístupnění systémuTEX pomocí adresářů, které již uživatelé znají, jako například /usr/local/bin, kteréneobsahují žádné TEXovské soubory.Když jsou všechna nastavení podle vašeho vkusu, můžete napsat ‘I’ 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 závěrem.

3.2.5 Nastavení spouštění z DVD (pouze v textovém režimu)K výběru této volby napište ‘V’. Toto změní hlavní nabídku na něco podobného jako ukazujeobrázek 8.

Všimněte si změny: všechny volby k instalaci zmizely, a část pro adresáře se teď zmiňujeo TEXDIRW nebo zapisovatelném kořenu. Volba pro symbolické linky také zmizela.

Instalační program bude pořád vytvářet různé adresáře a konfigurační soubory, alenezkopíruje texmf nebo texmf-dist na pevný disk.

Poinstalační konfigurace pro Unix bude o něco složitejší, protože teď se struktura adre-sářů odchyluje od standardu; viz sekci 3.4.

3 INSTALACE 12

======================> TeX Live installation procedure install-tl -helpK uvedení názvu volby mohou být použity - nebo také --. Následují nejběžnější volby:-gui Podle možností použijte GUI instalátor. Toto si vyžaduje modul Perl/Tk (http://

tug.org/texlive/distro.html#perltk); pokud Perl/Tk není k dispozici, pokračujeinstalace v textovém režimu.

-no-gui Vynutí si použití instalátoru v textovém režimu, dokonce i pod Windows; můžeteto potřebovat, pokud chcete spustit instalaci s volbou ‘from DVD’, poněvadž tato neník dispozici v režimu GUI.

-lang LL Specifikuje jazyk instalačního rozhraní jako jeho standarní dvoupísmenový kód LL.V současné době jsou podporovány jazyky: angličtina (en, předvolený), němčina (de),francouzština (fr), nizozemština (nl), polština (pl), slovinština (sl) a vietnamština(vi). Instalační program se sám pokusí určit vhodný jazyk, ale když selže nebo kdyžnení správný jazyk k dispozici, pak použije angličtinu jako nouzové řešení.

-profile soubor Instalační program vždycky uloží soubor texlive.profile do podadresářetlpkg vaší instalace. Tato volba oznámí instalačnímu programu, aby znovu použil tentoprofilový soubor tak, že můžete v dávkovém režimu instalovat TEX na další systémy, sestejnými volbami, jaké jste učinili v původní instalaci.

-repository soubor-nebo-adresář Určuje repositář balíků z kterého se má instalovat; viznásledující oddíl.

3.3.1 Volba -repositoryImplicitní repositář balíků je zrcadlo CTAN zvolené automaticky použitím http://mirror.ctan.org.

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

Ku pří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 skutečnýmhostitelským jménem (hostname) a jeho konkrétní kořenovou cestou k CTAN. Seznam zrca-del CTAN je udržován na http://ctan.org/mirrors.

http://tug.org/texlive/distro.html#perltkhttp://tug.org/texlive/distro.html#perltkhttp://mirror.ctan.orghttp://mirror.ctan.orghttp://ctan.example.org/tex-archive/systems/texlive/tlnet/http://ctan.example.org/tex-archive/systems/texlive/tlnet/http://ctan.org/mirrors

3 INSTALACE 13

Pokud je zadaný argument lokální (buď cesta nebo file:/ url), jsou použity kom-primované soubory v podadresáři archive cesty repositáře (i kdyby byli rovněž k dispozicinekomprimované soubory).

3.4 Poinstalační činnostiPo instalaci se mohou hodit některé další úpravy.

3.4.1 WindowsAvšak pod Windows se instalační program o vše postará.

3.4.2 Pokud byly vytvořeny symbolické odkazyPokud jste zvolili vytvoření symbolických odkazů v standardních adresářích (zmíněnýchv sekci 3.2.4), pak není potřeba editovat proměnné prostředí.

3.4.3 Proměnné prostředí pro UnixAdresář binárek pro vaši platformu musí být přidán k vyhledávacím cestám. Každá podporo-vaná platforma má svůj vlastní podadresář pod TEXDIR/bin. Seznam podadresářů a odpoví-dajících platforem viz na obrázku 4.

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

Například pro Bourne-kompatibilní shell, jako je bash a používaný Intel x86 GNU/Linuxse standardním nastavením adresářů, může být vhodné editovat soubor $HOME/.profile.PATH=/usr/local/texlive/2009/bin/i386-linux:$PATH; export PATHMANPATH=/usr/local/texlive/2009/texmf/doc/man:$MANPATH; export MANPATHINFOPATH=/usr/local/texlive/2009/texmf/doc/info:$INFOPATH; export INFOPATH

Pro csh nebo tcsh je editovaný soubor typicky $HOME/.cshrc a řádky k přidání můžouvypadat jako:setenv PATH /usr/local/texlive/2009/bin/i386-linux:$PATHsetenv MANPATH /usr/local/texlive/2009/texmf/doc/man:$MANPATHsetenv INFOPATH /usr/local/texlive/2009/texmf/doc/info:$INFOPATH

Pokud již máte nastavení někde ve vašich „dot“ souborech, adresáře TEX Live by měli,přirozeně, jednoduše přiměřeně s nimi splynout.

3.4.4 Proměnné prostředí: globální konfiguraceVolba, zda učinit tyto změny globálně, anebo pro uživatele právě přidaného do systému, je navás; existuje příliš mnoho variací mezi systémy, kde a jak se tato nastavení provádějí.

Naše dvě rady jsou: 1) můžete chtít vyhledat soubor /etc/manpath.config a pokudexistuje, přidejte řádky jakoMANPATH_MAP /usr/local/texlive/2009/bin/i386-linux \

/usr/local/texlive/2009/texmf/doc/manA 2) vyhledejte soubor /etc/environment, který může definovat 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 s názvem man.

Některé programy man, jako například standardní MacOSX man, ho automaticky najdou, coodstraňuje potřebu jakéhokoliv nastavování dokumentačních stránek.

3.4.5 Konfigurace fontů pro XeTEXPokud máte na unixovém systému nainstalován balík xetex, potřebujete nakonfigurovat vášsystém chcete-li aby byl XeTEX schopen najít fonty dodané s TEX Live. Pro usnadnění, když seinstaluje balík xetex (buď ve vychozí instalaci nebo později), se vytváří potřebný konfiguračnísoubor TEXMFSYSVAR/fonts/conf/texlive-fontconfig.conf.

Pro nastavení fontů TEX Live pro použití v rámci celého systému (za předpokladu, žemáte odpovídající oprávnění), postupujte následovně:

1. Zkopírujte soubor texlive-fontconfig.conf do adresáře /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ů, můžete místo toho

učinit fonty TEX Live dosažitelnými pro vás jako samostatného uživatele XeTEXu následujícímzpůsobem:

3 INSTALACE 14

1. Skopírujte soubor texlive-fontconfig.conf do ~/.fonts.conf, kde ~ označuje vášdomovský adresář.

2. Spusťte fc-cache -fv.

3.4.6 Při spuštění TEX Live z DVDProgram TEX Live obyčejně nahlédne do souboru texmf.cnf pro umístění různých stromů.Hledá tento soubor v řadě míst vztahujících se k jeho vlastnímu umístění. Nicméně, toto schémaselhává, když je program spouštěn z DVD: DVD je pouze ke čtení. Některé cesty zaznamenanév texmf.cnf jsou známé jen během instalace, tudíž tento soubor nemůže být na DVD a musíbýt umístěn někde jinde. To si vynucuje definovat proměnnou prostředí TEXMFCNF, která sdělíprogramům TEX Live, v kterém adresáři je možné najít tento soubor texmf.cnf. Přesto jetaké nutné upravit proměnnou prostředí PATH, jak bylo popsáno dříve.

Na konci instalace by instalační program měl vytisknout hlášení o hodnotě, na kterou semá nastavit proměnná TEXMFCNF. Jestliže jste ji minuli: tato hodnota je $TEXMFSYSVAR/web2c.Na předvolbu /usr/local/texlive/2009/texmf-var/web2c potřebujete řádkyTEXMFCNF=/usr/local/texlive/2009/texmf-var/web2c; export TEXMFCNFnebo, pro [t]csh:setenv TEXMFCNF /usr/local/texlive/2009/texmf-var/web2c

Tato volba je nejužitečnější když chcete spustit TEX Live ve vašem systému, ale nemátedostatek místa na disku k jeho nainstalování. Pokud chcete získat skutečně „přenosný“ TEXLive, který je soběstačný, například, pro klíč USB, nahlédněte do sekce 5.

3.4.7 ConTEXt Mark IV‘Starý’ ConTEXt by měl skončit. Nový ConTEXt ‘Mark IV’ si vyžádá ruční nastavení; vizhttp://wiki.contextgarden.net/Running_Mark_IV.

3.4.8 Začleňování lokálních a osobních makerToto je již implicitně zmíněno v sekci 2.3: adresář TEXMFLOCAL (standardně /usr/local/texlive/texmf-local nebo %SystemDrive%\texlive\texmf-local) je určen pro rozsáhlésystémové lokální fonty a makra; a adresář TEXMFHOME (standardně $HOME/texmf nebo%USERPROFILE%\texmf), je pro osobní fonty a makra.

Pro oba stromy musí být soubory umístěné v patřičných podadresářích; viz http://tug.org/tds nebo nahlédni do souboru texmf/web2c/texmf.cnf. Například, LATEXovskýsoubor třídy nebo balík by měl být umístěn v TEXMFLOCAL/tex/latex nebo TEXMFHOME/tex/latex, nebo v jejich podadresáři.

TEXMFLOCAL vyžaduje aktuální databázi jmen souborů, jinak nebudou soubory nalezeny.Můžete ji obnovit povelem mktexlsr nebo použít tlačítko ‘Reinit file database’ na konfiguračnízáložce tlmgr v režimu GUI.

3.4.9 Začleňování fontů třetích stranToto je naneštěstí nepříjemné téma. Zapomeňte na něj pokud se nechcete probírat v mnohapodrobnostech instalace TEXu. Nezapomeňte si nejdříve prohlédnout fonty, které jsou zdarmasoučástí distribuce, viz sekci 2.6.

Možnou alternativou je použití XeTEX u (viz sekci 2.4), který vám umožní používatfonty operačního systému bez jakékoliv instalace v TEXu.

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

3.5 Testování instalacePo nainstalování TEX Live přirozeně chcete systém otestovat a začít vytvářet nádherné doku-menty nebo fonty.

Tento oddíl popisuje základní postupy testování funkčnosti nového systému pod Uni-xem. Pod MacOSX a Windows budete patrně spouštět testy přes uživatelské grafické rozhraní(GUI), ale principy jsou stejné.

1. Nejprve ověřte, zda se spustí program tex:> tex --versionTeX 3.1415926 (TeX Live 2009)kpathsea version 5.0.0Copyright 2009 D.E. Knuth.

http://wiki.contextgarden.net/Running_Mark_IVhttp://tug.org/tdshttp://tug.org/tdshttp://tug.org/fonts/fontinstall.html

3 INSTALACE 15

...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ě 13.

2. Přeložte ukázkový soubor LATEXu:> latex sample2e.texThis is pdfTeX, Version 3.1415926-1.40.10 (TeX Live 2009)...Output written on sample2e.dvi (3 pages, 7484 bytes).Transcript written on sample2e.log.Pokud selže nalezení souboru sample2e.tex nebo jiných souborů, nejspíše máte ak-tivní stará nastavení proměnných prostředí nebo konfiguračních souborů; pro začátekdoporučujeme zrušit nastavení všech proměnných prostředí souvisejících s TEXem. Prohlubší analýzu a dohledání problému můžete kdykoliv požádat TEX o detaily toho, coa kde hledá: viz „Ladicí činnosti“ na straně 26.

3. Prohlédněte si výsledek na obrazovce:> xdvi sample2e.dvi # Unix> dviout sample2e.dvi # WindowsMělo by se otevřít nové okno s pěkným dokumentem popisujícím základy LATEXu. (Mi-mochodem, stojí za přečtení, pokud začínáte s TEXem.) Musíte mít spuštěny XWindow,aby xdvi pracovalo. Pokud tomu tak není nebo máte špatně nastavenou proměnnou pro-středí DISPLAY, dostanete chybovou hlášku ‘Can’t open display’.

4. Vytvořte PostScriptový soubor pro tisk nebo prohlížení:> dvips sample2e.dvi -o sample2e.ps

5. Vytvořte PDF soubor místo DVI; tento příkaz ze souboru .tex vytvoří PDF přímo:> pdflatex sample2e.tex

6. Prohlédněte si PDF soubor:> gv sample2e.pdfnebo:> xpdf sample2e.pdfAni gv ani xpdf nejsou zařazeny na TEX Live a musíte je instalovat separátně. Vizhttp://www.gnu.org/software/gv resp. http://www.foolabs.com/xpdf. Existujetaké velké množství jiných prohlížečů PDF. Pro Windows doporučujeme vyzkoušetSumatra PDF (http://blog.kowalczyk.info/software/sumatrapdf).

7. 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’.8. 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.texThis is XeTeX, Version 3.1415926......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 nakonfigurovat váš systém tak, aby XeTEX mohl najít fonty dodanés TEX Live. Viz oddíl 3.4.5.

3.6 Odkazy na doplňkový software s možností stažení z InternetuPokud jste TEXový začátečník nebo potřebujete pomoc se psaním TEXových, respektiveLATEXových dokumentů, navštivte http://tug.org/begin.html, kde najdete úvodníinformace k instalaci.

Odkazy na některé další pomůcky, o instalaci kterých můžete uvažovat:Ghostscript http://www.cs.wisc.edu/~ghost/Perl http://www.perl.org/ s doplňujícími balíky z CPAN, http://www.cpan.org/

http://www.gnu.org/software/gvhttp://www.foolabs.com/xpdfhttp://blog.kowalczyk.info/software/sumatrapdfhttp://tug.org/begin.htmlhttp://www.cs.wisc.edu/~ghost/http://www.perl.org/http://www.cpan.org/

4 SÍŤOVÉ INSTALACE 16

ImageMagick http://www.imagemagick.com, k zpracování a konverzi grafikyNetPBM http://netpbm.sourceforge.net/, rovněž pro grafiku.TEXovsky orientované editory Existuje široký výběr a je to záležitost vkusu uživatele.

Tady je výběr (několik málo je pouze pro Windows).• GNU Emacs je přirozeně k dispozici pod Windows, viz http://www.gnu.org/

software/emacs/windows/ntemacs.html.• Emacs s AucTEXem proWindows je k dispozici v TEX Live adresáři tlpkg/support

na DVD; jeho domovská stránka je http://www.gnu.org/software/auctex.• LEd je k dostání z http://www.ctan.org/support/LEd.• SciTE je k dostání z http://www.scintilla.org/SciTE.html.• Texmaker je volný (free) software, k dispozici z http://www.xmlmath.net/

texmaker/.• TeXnicCenter je volný software, k dispozici z http://www.texniccenter.org a

v distribuci proTEXt.• TeXworks je volný software, k dispozici z http://tug.org/texworks a je nainšta-

lovaný pre Windows a MacOSX jako součást TEX Live.• Vim je volný software, k dispozici z http://www.vim.org.• WinShell je k dispozici z http://www.winshell.de.• WinEdt je shareware dostupný třebas na http://tug.org/winedt nebo na http:

//www.winedt.com.Pro mnohem delší seznam balíků a programů, viz http://tug.org/interest.html.

4 Síťové instalaceTEX Live byl navržený pro sdílení mezi různými uživateli, nebo dokonce pro různé systémy nasíti. Se standardní strukturou adresářů se nekonfigurují žádné pevné cesty: umístění souborůpotřebných pro programy TEX Live je zřízeno relativně k programům. Můžete to najít v nejdů-ležitějším konfiguračním souboru $TEXMFMAIN/web2c/texmf.cnf, který obsahuje řádky jakojsouTEXMFMAIN = $SELFAUTOPARENT/texmf...TEXMFLOCAL = $SELFAUTOPARENT/../texmf-localTo 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 hierar-chii později na místo na síti.

Pro Windows můžete stáhnout z http://tug.org/texlive/w32client.html vzorovýskript síťové instalace nazvaný w32client. Vytváří nastavení a nabídkové zkratky k užívánístávající instalace TEX Live na LAN. Registruje také program k odinstalování w32unclient, jepo ruce ve stejném zip-souboru. Pro další informace viz webovou stránku.

5 Maximálně mobilní TEX Live na DVD a USBVolba ‘running from DVD’ (spouštění z DVD) popsaná v sekci 3.2.5 je skvělá pro váš systém,ale když jste hostem na systému někoho jiného, pak by se vám možná líbilo něco s nejmenšímivedlejšími účinky.

V kořenovém adresáři TEX Live DVD, nebo v podadresáři texlive TEX-kolekce DVD,jsou skripty tl-portable (Unix) a dávkové soubory tl-portable.bat (Windows), kteréspouští shell s nastavením prostředí pro přímý přístup TEX Live na DVD.

Při prvním spuštění budou vygenerovány některé soubory v adresáři ~/.tlportable2009,což zabere jistý krátký čas. Nicméně, při následných spouštěních začne téměř okamžitě.

Zbytek systému si TEX Live nebude uvědomovat. Pokud chcete, aby byl váš editorinformovaný o tomto TEX Live, pak ho můžete spustit z druhé, paralelní, stejné tl-portablerelace.

Skripty tl-portable můžete také použít na spuštění TEX Live z USB klíče. V tomtopřípadě zkopírujte (přinejmenším) všechny soubory na nejvyšší úrovni a obsah adresářůbin, texmf, texmf-dist a tlpkg na klíč. To může nějaký čas zabrat! Pokud kopírujete naUSB klíč formátovaný jako FAT32, nezapomeňte zrušit symbolické odkazy (cp -L). Adresářtexmf-local na klíči bude také nalezen a použit.

http://www.imagemagick.comhttp://netpbm.sourceforge.net/http://www.gnu.org/software/emacs/windows/ntemacs.htmlhttp://www.gnu.org/software/emacs/windows/ntemacs.htmlhttp://www.gnu.org/software/auctexhttp://www.ctan.org/support/LEdhttp://www.scintilla.org/SciTE.htmlhttp://www.xmlmath.net/texmaker/http://www.xmlmath.net/texmaker/http://www.texniccenter.orghttp://tug.org/texworkshttp://www.vim.orghttp://www.winshell.dehttp://tug.org/winedthttp://www.winedt.comhttp://www.winedt.comhttp://tug.org/interest.htmlhttp://tug.org/texlive/w32client.html

6 TLMGR: SPRÁVA VAŠÍ INSTALACE 17

Obrázek 9: tlmgr v režimu GUI. Seznam balíků/kolekcí/schémat se ukáže až po kliknutí natlačítko ‘Load’.

Pak spusťte skript tl-portable z kořenového adresáře klíče, jak bylo uvedeno výše.V tom případě bude skript vnímat klíč jako zapisovatelný a použije ho pro vytvořené soubory.

6 tlmgr: správa vaší instalaceTEX Live obsahuje program nazvaný tlmgr pro správu TEX Live po výchozí instalaci. Programyupdmap, fmtutil a texconfig jsou dosud zahrnuté a zůstanou i v budoucnosti, avšak preferovanýmrozhraním je nyní tlmgr. Jeho schopnosti zahrnují:

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

• vyhledávání a přehled balíků, atd.;• výpis seznamu, přidání a odstránění architektur;• změna instalačních voleb jako například velikosti papíru a umístění zdrojů (viz

sekci 3.3.1).Varování: tlmgr nebyl určený pro nebo testovaný s instalacemi, které jsou spouštěné z DVD.

6.1 GUI režim tlmgrtlmgr může být spuštěn v režimu GUI povelem> tlmgr -guinebo ve Windows prostřednictvím Start menu: Start, Programs, TeX Live 2009, TeX LiveManager. Po kliknutí na ‘Load’ se zobrazí seznam balíků, které jsou k dispozici, a nainstalova-ných balíků—posledně zmíněné jsou označeny ‘(i)’. Pochopitelně se předpokládá, že instalačnízdroj je platný a dosažitelný. Obrázek 10 ukazuje konfigurační záložku.

6 TLMGR: SPRÁVA VAŠÍ INSTALACE 18

Obrázek 10: tlmgr v režimu GUI: konfigurační záložka

6.2 Vzorové realizace tlmgr z příkazového řádkuPo výchozí instalaci můžete svůj systém aktualizovat na nejnovější dostupnou verzi pomocí:> tlmgr update -allPokud vás to znepokojuje, zkuste nejdříve> tlmgr update -all -dry-runnebo (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-xetexVytvoří následující výstup (zkrácené):install: collection-xetexinstall: arabxetex...install: xetexinstall: xetexconfiginstall: xetex.i386-linuxrunning post install action for xetexinstall: xetex-def...running mktexlsrmktexlsr: Updating /usr/local/texlive/2009/texmf/ls-R......running fmtutil-sys --missing...

7 POZNÁMKY O WINDOWS 19

Transcript written on xelatex.log.fmtutil: /usr/local/texlive/2009/texmf-var/web2c/xetex/xelatex.fmt installed.

Jak můžete vidět, tlmgr nainstaluje závislosti a postará se o všechny potřebné poin-stalač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émy) zadejte:> tlmgr show collection-latexextraco vytvořípackage: collection-latexextracategory: Collectionshortdesc: LaTeX supplementary packageslongdesc: A large collection of add-on packages for LaTeX.installed: Yesrevision: 14675

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

7 Poznámky o WindowsTEX Live má jediný instalační program, který běží na obou systémech Windows a Unix. Totobylo možné jenom snížením podpory starších verzí Windows, proto je možné instalovat TEXLive pouze na Windows 2000 a novější.

7.1 Vlastnosti typické pro WindowsPod 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, obsahující

vstupy pro některé programy GUI (tlmgr, texdoctk, prohlížeč PostScriptu PS_View(psv)) a trochu dokumentace. PS_View také získává ikonku na pracovní ploše jako cílpro PostScriptové soubory.

Automatické nastavení proměnných prostředí. Žádné ruční konfigurační kroky nejsoupotřebné.

Odinstalátor. Instalační program vytvoří položku pro TEX Live pod nabídkou ‘Add/RemovePrograms’. Vztahuje se k tomu záložka ‘Uninstallation’ programu tlmgr.

7.2 Dodatečný obsažený software pod WindowsPro úplnost, instalace TEX Live potřebuje další balíky a programy, které na stroji s Windowsobvykle nenajdete.

TEX Live poskytuje chybějící součásti:Perl a Ghostscript. Kvůli důležitosti Perlu a Ghostscriptu zahrnuje TEX Live ‘skryté’ ko-

pie těchto programů. Programy TEX Live, které je potřebují, vědí, kde je najdou, aleneprozrazují jejich přítomnost nastavením proměnných prostředí nebo registrů. Nejsouto úplné instalace a neměly by překážet žádným systémovým instalacím Perlu neboGhostscriptu.

PS_View. Nainstalován je také PS_View, prohlížeč PostScript a PDF souborů; viz obr. 11.dviout. Nainstalován je také dviout, prohlížeč DVI souborů. Nejdříve, když prohlížíte soubory

pomocí dviout, vytvoří tento fonty, protože fonty pro obrazovku nebyli nainstalovány. Pochvilce budete mít vytvořenu většinu fontů pro použití a okno vytváření fontů uvidíteuž jen zřídka. Více informací je možné nalézt ve (velmi doporučené) spřažené nápovědě.

TeXworks. TEXworks je TEXovsky orientovaný editor se zabudovaným prohlížečem PDF. Jejiž nakonfigurován pro TEX Live.

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. Tyto za-hrnují programy gzip, unzip a pomůcky příkazového řádku ze skupiny xpdf. Samotnýprohlížeč xpdf není k dispozici pro Windows. Namísto něho si můžete z http://blog.kowalczyk.info/software/sumatrapdf stáhnout prohlížeč PDF Sumatra, který je za-ložen na xpdf.

fc-list, fc-cache et al. Nástroj z knihovny fontconfig pomáhá XeTEXu efektivněji zacházets fonty pod Windows. Můžete použít fc-list k určení jmen fontů k předání rozšířenémupříkazu XeTEXu \font. Pokud je to potřebné, nejdříve spusťte fc-cache k aktualizaciinformací o fontech.

http://tug.org/texlive/tlmgr.htmlhttp://tug.org/texlive/tlmgr.htmlhttp://blog.kowalczyk.info/software/sumatrapdfhttp://blog.kowalczyk.info/software/sumatrapdf

7 POZNÁMKY O WINDOWS 20

Obrázek 11: PS_View: k dispozici jsou velmi vysoká zvětšení!

7.3 User Profile je HomeWindowsovský protějšek domovského (home) adresáře Unixu je adresář %USERPROFILE%. PodWindows XP a Windows 2000 je to obvykle C:\Documents and Settings\ a podWindows Vista C:\Users\. V souboru texmf.cnf a obecně pro Kpathsea, se bude~ expandovat přiměřeně v obou systémech Windows a Unix.

7.4 Registry WindowsWindows ukládá téměř všechny konfigurační údaje do svých registrů. Registr obsahuje sou-bor 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. ČástHKCU registru je v domovském adresáři uživatele (viz sekci 7.3). HKLM je obvykle v podadresářiadresář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.

7.5 Oprávnění WindowsV novějších verzích Windows se dělá rozdíl mezi běžnými uživateli a administrátory, když pouzeposledně zmínění mají volný přístup k celému operačnímu systému. Ve skutečnosti můžetetyto třídy uživatelů raději označit jako neprivilegovaní uživatelé a normální uživatelé: býtadministrátorem je pravidlo, ne výjimka. Přesto jsme se snažili učinit TEX Live instalovatelnýmbez administrativních výsad.

Pokud je uživatelem administrátor, 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 asystémové prostředí se upravuje. Jinak jsou odkazy a položky nabídky vytvářeny pouze proaktuálního uživatele a upravuje se jen jeho prostředí.

Bez ohledu na status administrátora je standardní kořenový adresář TEX Live navrženýinstalačním programem vždycky 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 vevyhledávací cestě. Protože skutečná cesta se sestává ze systémové cesty následované uživa-telskou cestou, nový TEX Live by nikdy neměl získat přednost. Jako bezpečnostní opatřenívytváří instalátor odkaz na příkazový řádek (command-prompt), ve kterém je adresář bináreknové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.

Pro Vista je tady jiná zrůdnost: dokonce i když jste přihlášen jako správce, musíte ex-plicitně požádat o správcovské práva. Ve skutečnosti nemá význam přihlašovat se jako správce.

8 POUŽÍVATEĽSKÁ PRÍRUČKA KU SYSTÉMU WEB2C 21

Místo toho, kliknutí pravým tlačítkem na program nebo odkaz, který chcete použít, vám ob-vykle nabídne volbu ‘Spustit jako správce/Run as administrator’.

8 Používateľská príručka ku systému Web2CWeb2C obsahuje množinu TEX-príbuzných programov, t.j. samotný TEX, METAFONT, Meta-Post, BibTEX, atď. Je to srdce systému TEX Live. Domovská stránka Web2C, s aktuálnoupríručkou a ďalšími vecami, je http://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 preUnix, ktoré boli v prvom rade pôvodnou prácou Howarda Trickeya a Pavla Curtisa. TimMorgan 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 av roku 1997 podal taktovku Olafovi Weberovi, ktorý ju v roku 2006 vrátil Karlovi.

Web2C systém beží pod Unixom, 32bitovými Windows, MacOSX a inými operačnýmisystémami. Používa originálne TEX zdrojové súbory od Knutha a ostatné základné programynapísané v systéme kultivovaného programovania WEB, ktoré sú preložené do zdrojového kódujazyka C. Základné programy TEXu sú spracované týmto spôsobom:bibtex Spravovanie bibliografií.dvicopy Vytváranie modifikovanej 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 Preddefinované 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íkovalebo v dokumentácii Web2C. Napriek tomu, poznanie niekoľkých princípov, ktoré platia precelý 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.–verbose Vypisuje detailnú správu spracovania.–version Vypisuje informáciu o verzii, potom skončí.

Na vyhľadávanie súborov používajú Web2C programy prehľadávaciu knižnicu Kpathsea(http://tug.org/kpathsea). Táto knižnica používa kombináciu premenných prostredia a nie-koľkých konfigurač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 niektochce udržiavať štandardnú distribúciu TEXu a jeho lokálne a osobné rozšírenia v rozličnýchstromoch. Na urýchlenie vyhľadávania súborov, koreň každého stromu obsahuje súbor ls-R sozáznamom obsahujúcim meno a relatívnu cestu ku všetkým súborom umiestneným pod týmtokoreňom.

8.1 Vyhľadávanie ciest knižnicou KpathseaNajprv popíšeme všeobecný mechanizmus vyhľadávania ciest knižnicou Kpathsea.

http://tug.org/web2chttp://tug.org/kpathsea

8 POUŽÍVATEĽSKÁ PRÍRUČKA KU SYSTÉMU WEB2C 22

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 via-cerých zdrojov. Pri vyhľadávaní súboru ‘my-file’ podľa cesty ‘.:/dir’, Kpathsea skontrolujekaždý element cesty: najprv ./my-file, potom /dir/my-file, vracajúc prvý zodpovedajúciná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 oddvojbodky (‘:’) a lomítka (‘/’).

Pri kontrolovaní určitého elementu cesty p Kpathsea najprv overí, či sa na naň nevzťa-huje vopred vybudovaná databáza (pozri ,Databáza názvov súborov‘ na strane 24), t. j., či sadatabáza nachádza v adresári, ktorý je prefixom p. Ak to tak je, špecifikácia cesty sa porovnávas obsahom databázy.

Ak databáza neexistuje, alebo sa nevzťahuje na tento element cesty, alebo sa v nejhľadaný súbor nevyskytuje, celý systém súborov je prehľadaný (pokiaľ to nebolo zakázanéšpecifikáciou začínajúcou ‘!!’ a hľadaný súbor musí existovať). Kpathsea zostrojí zoznam ad-resárov zodpovedajúcich tomuto elementu cesty a potom skontroluje každý z nich, či sa v ňomnenachádza hľadaný súbor.

Podmienka ,súbor musí existovať‘ sa týka napr. súborov typu ‘.vf’ a vstupných súborovčítaných príkazom TEXu \openin. Takéto súbory nemusia existovať (napr. cmr10.vf) a neboloby dobré prehľadávať kvôli nim celý disk. Preto, ak zabudnete aktualizovať ls-R pri inštaláciinového ‘.vf’ súboru, súbor nebude nikdy nájdený. Každý element cesty sa prekontroluje: najprvdatabáza, potom disk. Keď je súbor nájdený, vyhľadávanie sa zastaví a výsledok je vrátený.

Hoci najjednoduchší a najbežnejší element cesty je meno adresáru, Kpathsea podporujeaj iné zdroje vo vyhľadávacích cestách: dedičné (layered) štandardné hodnoty, mená premen-ných prostredia, hodnoty súboru config, domáce adresáre používateľov a rekurzívne prehľa-dávanie podadresárov. Preto, ak hovoríme, že Kpathsea rozbalí element cesty, znamená to, žepretransformuje všetky špecifiká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 explicitnerelatívne, t. j. začína ‘/’ alebo ‘./’ alebo ‘../’, Kpathsea jednoducho skontroluje, či taký súborexistuje.

8.1.1 Zdroje cestyVyhľadávacia cesta môže byť vytvorená z rôznych zdrojov. Kpathsea ich používa v tomtoporadí:

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

2. Programovo-špecifický konfiguračný súbor, napríklad riadok ,S /a:/b‘ v súboreconfig.ps dvips.

3. Konfigurač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 26).

8.1.2 Konfiguračné súboryKpathsea číta počas behu z konfiguračných súborov s menom texmf.cnf vyhľadávaciu cestua ďalšie definície. Vyhľadávacia cesta používaná na hľadanie týchto súborov sa volá TEXMFCNF(v predvolenom nastavení sa tento súbor nachádza v podadresári texmf/web2c). Všetky súborytexmf.cnf vo vyhľadávacej ceste budú prečítané a definície v posledných načítaných súborovmajú prednosť pred definíciami čítanými predtým. Preto pri vyhľadávacej ceste .:$TEXMF,hodnoty z ./texmf.cnf prepíšu hodnoty z $TEXMF/texmf.cnf.

• Komentáre začínajú znakom ,%‘ 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:

8 POUŽÍVATEĽSKÁ PRÍRUČKA KU SYSTÉMU WEB2C 23

variable[.progname] [=] valuekde ‘=’ a prázdne znaky naokolo sú nepovinné.

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

• Ak je ,.progname‘ neprázdne, definícia sa použije iba vtedy, keď práve bežiaci prog-ram má meno progname alebo progname.exe. Toto umožňuje napríklad mať pre rôznenadstavby TEXu rôzne vyhľadávacie cesty.

• Hodnota ,value‘ môže obsahovať akékoľvek znaky okrem ,%‘ a ‘@’. Na pravej strane nieje možné použiť ,$var.prog‘; namiesto toho musíte použiť ďalšiu premennú. 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ý texmf.cnf súbor pre systémy Unix, MSDOS a Windows.

• Všetky definície sú prečítané skôr, ako sa expandujú. Preto môžu existovať referenciena premenné skôr, ako sú tieto definované.

Ukážkový úsek konfigurač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 filesTEXINPUTS.elatex = .;$TEXMF/{etex,tex}/{latex,generic;}//TEXINPUTS.etex = .;$TEXMF/{etex,tex}/{eplain,plain,generic;}//

8.1.3 Expanzia cestyKpathsea 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še-obecný príklad uvedieme komplexnú cestu ~$USER/{foo,bar}//baz, ktorá sa expanduje dovš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.

8.1.4 Predvolená expanziaAk vyhľadávacia cesta s najväčšou prioritou (pozri ,Zdroje cesty‘ na strane 22) obsahuje dvoj-bodku navyše (t.j. začiatočnú, koncovú, alebo zdvojenú), Kpathsea vloží na toto miesto vyhľa-dávaciu cestu s druhou najvyššou prioritou, ktorá je definovaná. Ak táto vložená cesta obsahujedvojbodku navyše, to isté sa stane s ďalšou najvýznamnejšou cestou. Keby sme mali napríkladdané takéto nastavenie premennej prostredia>> setenv TEXINPUTS /home/karl:a hodnotu TEXINPUTS v súbore texmf.cnf

.:$TEXMF//texpotom konečná hodnota použitá na vyhľadávanie by bola:

/home/karl:.:$TEXMF//texKeďž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ú ‘:’.

8.1.5 Expanzia zátvoriekUžitočná črta je expanzia zátvoriek, ktorá funguje tak, že napríklad v{a,b}w sa expanduje navaw:vbw. Vnáranie je povolené. Toto sa používa na implementáciu viacnásobných TEXovskýchhierarchií, priradením hodnoty $TEXMF s použitím zátvoriek. Napríklad v súbore texmf.cnfnájdete nasledujúcu definíciu (približne, v skutočnosti je tam ešte viac stromov):

TEXMF = {$HOMETEXMF,$TEXMFLOCAL,!!$TEXMFVAR,!!$TEXMFMAIN}Keď potom napíšete niečo podobné ako

TEXINPUTS = .;$TEXMF/tex//bude to znamenať, že po hľadaní v aktuálnom adresári sa najprv prehľadá celý strom$HOMETEXMF/tex, $TEXMFLOCAL/tex, $TEXMFVAR/tex a $TEXMFMAIN/tex (posledné dva s pou-žitím databázových súborov ls-R). Je to vhodný spôsob ako spúšťať dve paralelné TEX štruk-túry, jednu nemennú (napríklad na CD) a druhú neustále aktualizovanú novými verziami,akonáhle sú dostupné. Použitím premennej $TEXMF vo všetkých definíciách máme istotu, že savždy ako prvý prehľadá aktuálny strom.

8 POUŽÍVATEĽSKÁ PRÍRUČKA KU SYSTÉMU WEB2C 24

8.1.6 Expanzia podadresárovDva 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, potompodadresármi pod nimi, atď. Poradie, v akom sú prehľadávané podadresáre na každej úrovni,nie je špecifikované.

Ak po ‘//’ špecifikujete akékoľvek komponenty mena súboru, pridajú sa iba podadre-sá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 jeignorované.

8.1.7 Typy špeciálnych znakov a ich význam: zhrnutieNasledujúci zoznam zahŕňa zvláštne znaky v konfiguračných súboroch Kpathsea.: Oddeľovač v špecifikácii cesty; na začiatku alebo na konci cesty 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.// Expanzia podadresárov. (Môže sa vyskytnúť kdekoľvek v ceste, okrem jej začiatku).% Začiatok komentáru.\ Znak pokračovania riadku (umožňuje viacriadkové vstupy).!! Povel na hľadanie súboru iba v databáze, neprehľadáva disk.

8.2 Databázy názvov súborovKpathsea minimalizuje prístupy na disk pri vyhľadávaní. Predsa však pri inštaláciách s do-statočným množstvom adresárov hľadanie súboru v každom možnom adresári môže zabraťprehnane veľa času (toto platí zvlášť vtedy, keď musia byť prejdené stovky adresárov s fon-tami). Kpathsea preto 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.

Skratky mien (aliases) v druhom databázovom súbore vám umožňujú dať dodatočnémená súborom nachádzajúcim sa v zozname ls-R. Toto môže byť užitočné pri prispôsobovanísa súborovým konvenciám 8.3 DOSu v zdrojových súboroch.

8.2.1 Súborová databázaAko 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úšťapríkazcd /your/texmf/root && \ls -1LAR ./ >ls-Rpredpokladajú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 pre-budovávať cez cron, takže po zmenách v inštalovaných súboroch— napríklad pri inštaláciialebo 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čnevyhľadávať na disku. Ak však určitý element cesty začína ‘!!’, bude prehľadávaná iba databáza,nikdy nie disk.

8.2.2 kpsewhich: samostatné prehľadávanie cestyProgram 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 savyužíva v distribuovaných ‘mktex’. . . skriptoch).>> kpsewhich option... filename...Voľby špecifikované v ,option‘ môžu začínať buď ‘-’ alebo ‘--’ a každá skratka, ktorá nie jeviacznačná, je akceptovaná.

8 POUŽÍVATEĽSKÁ PRÍRUČKA KU SYSTÉMU WEB2C 25

Kpathsea považuje každý element vstupného riadku, ktorý nie je argumentom neja-kej voľby, za meno súboru, ktorý hľadá, a vracia prvý súbor, ktorý nájde. Neexistuje voľbaumožň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 syno-nymom, kvôli kompatibilite s dvips. Predvolená hodnota je 600.

–format=nameNastav formát na vyhľadávanie na ,name‘. Podľa predvoleného nastavenia je formátuhádnutý z mena súboru. Pre formáty, ktoré nemajú asociovanú jednoznačnú príponu,ako napríklad podporné súbory MetaPostu a konfiguračné súbory dvips, musíte špeci-fikovať meno ako známe pre Kpathsea, také ako tex alebo enc files. Zoznam získatespustením kpsewhich --help.

–mode=stringNastav meno módu na ,string‘; toto má vplyv iba na ‘gf’ a ‘pk’ vyhľadávanie. Žiadnapredvolená hodnota: každý mód bude nájdený.

–must-existUrob 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=stringVyhľadávaj podľa cesty ,string‘ (oddeľovaná dvojbodkou ako zvyčajne) namiesto háda-nia 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=nameNastav meno programu na ,name‘. Toto nastavenie ovplyvňuje použitie vyhľadávacejcesty cez nastavenie ,.progname‘ v konfiguračných súboroch. Predvolená hodnota je‘kpsewhich’.

–show-path=nameZobrazí 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=numNastaví masku výberu ladiacích možností na ,num‘.

8.2.3 Príklady použitiaPozrime sa na Kpathsea v akcii. Za podčiarknutým príkazom nasleduje výsledok vyhľadávaniav nasledujúcich riadkoch.> kpsewhich article.cls/usr/local/texmf-dist/tex/latex/base/article.clsHľadáme súbor article.cls. Keďže prípona ‘.cls’ je jednoznačná, nemusíme špecifikovať, žehľadáme súbor typu ,tex‘ (zdrojový súbor TEX). Nájdeme ho v podadresári tex/latex/basepod 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.bibMimochodom, posledným súborom je bibliografická databáza BibTEXu pre články

TUGBoatu.> kpsewhich cmr10.pkBitmapové 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 implicitnepoužívame verzie Type1 ).

8 POUŽÍVATEĽSKÁ PRÍRUČKA KU SYSTÉMU WEB2C 26

> 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ýmrozlíšením 600 dpi (dots per inch), je vrátená táto inštancia.> kpsewhich -dpi=300 wsuipa10.pkV tomto prípade po špecifikovaní, že nás zaujíma rozlíšenie 300 dpi (-dpi=300), vidíme, žetaký font nie je v systéme k dispozícii. Programy ako dvips alebo xdvi by v tomto prípadevytvorili požadované .pk súbory, použijúc skript mktexpk.

Teraz obráťme našu pozornosť na hlavičkové a konfiguračné súbory dvips. Najprvsa pozrieme na jeden z bežne používaných súborov, všeobecný prológový tex.pro na pod-poru TEXu, potom pohľadáme konfiguračný súbor (config.ps) a PostScriptovú mapu fontovpsfonts.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 špecifikovať expli-citne, 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.mapTeraz 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 konfiguračnýsúbor, ktorý obsahuje meno mapového súboru:> kpsewhich –format="dvips config" config.utm

/usr/local/texmf-dist/dvips/psnfss/config.utmObsah 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.mapTento mapový súbor definuje mená súborov fontov typu Type1 PostScript v kolekcii URW.Jeho obsah vyzerá takto (zobrazili sme iba jeho časť):

utmb8r NimbusRomNo9L-Medi ...

8 POUŽÍVATEĽSKÁ PRÍRUČKA KU SYSTÉMU WEB2C 27

16 Adresárový zoznam pre každý element cesty (vzťahuje sa iba na vyhľadávanie na disku).32 Vyhľadávanie súborov.64 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 de-tailne 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ý, ladiacacesta ukazuje, v ktorých adresároch program daný súbor hľadal, čo môže naznačovať, v čomsa asi vyskytol problém.

Všeobecne povedané, keďže väčšina programov volá knižnicu Kpathsea vnútorne, la-diace 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áškyv 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ý obsahujenasledujú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 -Pcms1.> dvips -d4100 hello-world -Pcms -oV tomto prípade sme skombinovali dvips ladiacu triedu 4 (cesty k fontom) s expanziou elementucesty Kpathsea (pozri Referenčný Manuál dvips, texmf/doc/html/dvips/dvips_toc.html).Výstup, trochu preusporiadaný, je zobrazený na obrázku 12.

dvips začne lokáciou svojich pracovných súborov. Najprv je nájdený texmf.cnf, ktorýobsahuje definície vyhľadávacích ciest ostatných súborov, potom databáza súborov ls-R (naoptimalizáciu vyhľadávania súborov) a skratky mien súborov (aliases), čo robí možným dekla-rovať viacero mien (napr. krátke meno typu ,8.3‘ ako v DOSe a dlhšiu prirodzenejšiu verziu) preten istý súbor. Potom dvips pokračuje v hľadaní všeobecného konfiguračného súboru config.psskôr, ako začne hľadať súbor nastavení .dvipsrc (ktorý, v tomto prípade, nie je nájdený). Na-koniec, dvips nájde konfigurač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é definujú vzťah medzi menami fontov v TEXu, PostScripte a systéme súborov.> more /usr/local/texmf/dvips/cms/config.cms

p +ams.mapp +cms.mapp +cmbkm.mapp +amsbkm.map

dvips preto pokračuje v hľadaní všetkých týchto súborov plus všeobecného mapového súborupsfonts.map, ktorý sa načíta vždy (obsahuje deklarácie bežne používaných PostScriptovýchfontov; pozri poslednú časť sekcie 8.2.3, kde sa nachádza viac detailov o narábaní s mapovýmisúbormi PostScriptu).

V tomto bode sa dvips identifikuje používateľovi . . .This is dvips(k) 5.92b Copyright 2002 Radical Eye Software (www.radicaleye.com). . . 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.proPo nájdení tohoto súboru, dvips vypíše na výstup dátum a čas a informuje nás, že vygene-ruje 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.psDefining font () cmr10 at 10.0ptFont cmr10 is resident.

1. Od verzie TEX Live 7 nie je nutné túto voľbu nastavovať, pretože Type 1 fonty sú načítané implicitne.

file:../../../../texmf/doc/html/dvips/dvips_toc.html

8 POUŽÍVATEĽSKÁ PRÍRUČKA KU SYSTÉMU WEB2C 28

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-Rkdebug:start search(file=aliases, must_exist=1, find_all=1,path=~/tex:/usr/local/texmf).

kdebug:search(aliases) => /usr/local/texmf/aliaseskdebug: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.pskdebug: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: Hľadanie konfiguračných súborov

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

Obr. 13: Hľadanie ,prolog‘ súboru

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.tfmkdebug:start search(file=texps.pro, must\_exist=0, find\_all=0,

...

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) => /