3 Instalace na Unixu

Jak již bylo zmíněno v oddíle 1.1 na straně 8, TeX Live má tři základní užití:

  1. použití přímo z média,
  2. instalace na disk, nebo
  3. integrace konkrétního balíku či kolekce do vaší existující TeXové instalace.

V následujících sekcích popíšeme Unixu specifické postupy pro každé výše zmíněné užití.



Varování: Kolekce na CD i DVD jsou ve formátu ISO 9660 (High Sierra), včetně rozšíření Rock Ridge (a Joliet, pro Windows). Proto váš unixový systém musí být schopen využívat rozšíření Rock Ridge. Ověřte tedy v dokumentaci příkazu mount jak toho docílit. Pokud máte na vaší lokální síti několik různých strojů, namontujte média na takovém stroji, který Rock Ridge podporuje, a použijte je na ostatních. Linux, FreeBSD, Sun, SGI a Alpha systémy by měly používat CD bez problémů. Budeme vděčni za detailní doporučení od uživatelů na dalších platformách, pro další verze této dokumentace.

V dalším předpokládáme, že jste schopni namontovat Rock Ridge kompatibilní CD.



3.1 Spouštění TeX Live přímo z média (Unix)

Na demo CD najdete binárky pouze pro Linux, Mac OS X, a Windows; pro spouštění na dalších unixových systémech budete potřebovat DVD.

Na začátku musíte namontovat CD resp. DVD, a povolit rozšíření Rock Ridge. Konkrétní příkaz se liší systém od systému; následující funguje pod Linuxem (název zařízení /dev/cdrom se může lišit, stejně tak název filesystému: Solaris například pro ISO 9660 používá název hsfs — High Sierra filesystem). Všechny příklady používají > jako prompt shellu; vstup uživatele je podtržený.)

> mount -t iso9660 /dev/cdrom /mnt/cdrom

Změňte aktuální adresář do právě namontovaného adresáře:

> cd /mnt/cdrom

Pod Mac OS X, adresář je typicky pod /Volumes, a zařízení bude namontováno automaticky.

Spusťte instalační dávku install-tl.sh:


> sh install-tl.sh
Welcome to TeX Live...

Po několika uvítacích zprávách a zobrazení základního menu vás systém žádá o zadání volby. To učiníte stiskem vybraného znaku zmáčknutím klávesy Enter. Nezáleží, zda používáte malá či velká písmena; v ukázkách jsou použita malá.

Pro spouštění z média bude prvním příkazem d a následně příkaz 1 pro nastavení adresářů. I v tomto případě musíme nastavit adresář na lokálním disku kam bude TeX zapisovat soubory, které generuje, jako fonty, formátové soubory, a také upravené konfigurační soubory. V tomto příkladě použijeme /usr/local/texmf-local. (Pokud jste spokojeni s implicitní hodnotou /usr/TeX můžete pokračovat dalším krokem.)


Enter command: d
Current directories setup:
<1>  TEXDIR:     /usr/TeX
...
Enter command: 1
New value for TEXDIR [/usr/TeX]: /usr/local/texmf-local
...
Enter command: r

Zpátky v hlavním menu, naším dalším a posledním příkazem bude r, pro nastavení běhu z média bez instalace na disk:


Enter command: r
Preparing destination directories...
...
Welcome to the TeX Live system!
>

Jak vidíte, jsme zpět v hlavním menu.

Dalším krokem je nastavení dvou proměnných prostředí: PATH, pro adresář programů závislých na architektuře OS (abychom mohli spouštět programy), a VARTEXMF, na hodnoty specifikované výše. V tabulce 1 vidíte seznam jmen architektur pro různé systémy, a také zda jsou k dispozici na demo CD. (Na distribucích inst and live je k dispozici vše). Kromě názvů obsahujících verzi jsou k dispozici i názvy bez verzí: například sparc-solaris je odkaz na adresář sparc-solaris2.7. Generická jména mohou pomoci při upgradech v budoucnu.

Jakmile byla dokončena základní instalace, a byly nastaveny proměnné prostředí, na řadě je spuštění programu texconfig pro přizpůsobení instalace specifickým potřebám. To je popsáno v oddíle 4.1, na straně 31.


Tabulka 1: Podporované systémové architektury.



alpha-linux Compaq Alpha Linux
alphaev5-osf4.0d HP Alphaev5 OSF
i386-freebsd4.8 Intel x86 FreeBSD
i386-linux Intel x86 GNU/Linux demo CD
i386-openbsd3.3 Intel x86 OpenBSD
i386-solaris2.8 Intel x86 Solaris
mips-irix6.5 SGI IRIX
powerpc-aix4.3.3.0 IBM RS/6000 AIX
powerpc-darwin6.3 Mac OS X demo CD
sparc-solaris2.7 Sun Sparc Solaris
sparc64-linux Sun Sparc Linux
win32 Windows (32-bit) demo CD




Syntax pro nastavení proměnných prostředí, a nastavení inicializačního souboru, který je obsahuje, závisí na používaném shellu. Pokud používáte Bourne-kompatibilní shell (sh, bash, ksh, apod.), dejte si do svého $HOME/.profile souboru:


PATH=/mnt/cdrom/bin/archname:$PATH; export PATH
VARTEXMF=/usr/local/texmf-local/texmf-var; export VARTEXMF

Pro C shell-kompatibilní shelly (csh, tcsh), dejte si do $HOME/.cshrc toto:


setenv PATH /mnt/cdrom/bin/archname:$PATH
setenv VARTEXMF /usr/local/texmf-local/texmf-var

Pak se odhlašte, přihlašte s novým nastavením, a otestujte svou instalaci (viz oddíl 4.2 na straně 32).

Pokud narazíte na problémy, pokuste se je řešit se svým místním systémovým administrátorem; například jak namontovat média TeX Live, jaké adresáře používat. Také detaily změn osobních konfiguračních souborů se mohou systém od systému lišit.

3.2 Instalace TeX Live na disk

Pokud je to možné, a dnes již typické, je instalace systému TeX Live na disk. To lze provést buď z live DVD, nebo z inst CD. Také lze použít demo CD, pokud nepotřebujete na CD vynechané balíky a systémy. (Viz oddíl 2.1 na straně 11 pro popis rozdílů různých distribucí.)

Na začátku musíte namontovat CD resp. DVD, a povolit rozšíření Rock Ridge. Konkrétní příkaz se liší systém od systému; následující funguje pod Linuxem (název zařízení /dev/cdrom se může lišit, stejně tak název filesystému: Solaris například pro ISO 9660 používá název hsfs — High Sierra filesystem). Všechny příklady používají > jako prompt shellu; vstup uživatele je podtržený.)

> mount -t iso9660 /dev/cdrom /mnt/cdrom

Změňte aktuální adresář do právě namontovaného adresáře:

> cd /mnt/cdrom

Pod Mac OS X, adresář je typicky pod /Volumes, a zařízení bude namontováno automaticky.

Spusťte instalační dávku install-tl.sh:


> sh install-tl.sh
Welcome to TeX Live...

Po několika uvítacích zprávách a zobrazení základního menu vás systém žádá o zadání volby. To učiníte stiskem vybraného znaku zmáčknutím klávesy Enter. Nezáleží, zda používáte malá či velká písmena; v ukázkách jsou použita malá.

Objeví se úvodní seznam možností hlavního menu. Pořadí, ve kterém zvolíte jednotlivé možnosti nehraje roli, jen volba i musí být poslední. Je smysluplné projít možnosti ve zde prezentovaném pořadí.


Tabulka 2: Volby hlavního menu pro instalaci.
p Operační systém, který používáme.
b Instalované architektury.
s Základní instalační schéma k užití (minimal, recommended, full, apod.)
c Prioritní volba jednotlivých kolekcí (nezávislá na schématu).
l Prioritní volba jazykových kolekcí.
d Adresáře kam instalovat.
o Obecné volby.
i Vlastní instalace.

Zde je detailní popis jednotlivých voleb.

p – používaná platforma. Jelikož instalační skript automaticky hádá na jaké platformě běží, tato volba se většinou nemusí přenastavovat a je potřeba pouze tehdy, když automatická detekce selže.

b – Instalované architektury. Implicitně se instalují binárky pouze pro právě používanou platformu. Je zde ale možnost si vybrat i další podporované platformy (anebo zrušit výběr právě používané platformy). To je vhodné při sdílení TeXového stromu v heterogenní síti. Pro seznam podporovaných architektur viz tabulku 1 na straně 20.

s – Základní instalační schéma. Z tohoto menu můžete vybrat některou z předpřipravených množin instalovaných balíků (instalačních schémat). Implicitní je doporučená množina pro typické potřeby, ale můžete zvolit minimální schéma pro úsporu místa na disku, anebo úplné schéma pro instalaci všech balíků na médiu. Najdete zde také schémata pro uživatele Omegy a XML. Schéma Live je používáno pro vytváření dalších TeX Live distribucí, a obvykle není vhodné pro výběr na běžnou instalaci.

c – Prioritní volba jednotlivých kolekcí. Z tohoto menu vyberete jednotlivé kolekce k instalaci, které jsou výjimkami ze zvoleného instalačního schématu. Každá kolekce — makra TeXu, fonty METAFONT, atd. — sestává z několika balíčků. V tomto menu hraje při výběru roli volba malých a velkých písmen.

l – Prioritní volba jazykových kolekcí. Toto menu má stejné určení jako c, a to určit výjimky základního instalačního schématu. přičemž kolekce jsou utříděny dle podpory sazby různých jazyků. Malá a velká písmena jsou opět při volbách odlišována. Seznam jazykových kolekcí na TeX Live:

(some) African scripts Armenian Chinese, Japanese, Korean Croatian
Cyrillic Czech/Slovak Danish Dutch
Finnish French German Greek
Hungarian Indic Italian Latin
Manju Mongolian Norwegian Polish
Portuguese Spanish Swedish Tibetan
UK English Vietnamese

Jazykové kolekce typicky obsahují fonty, makra, vzory dělení, a další pomocné soubory. (Například frenchle.sty je instalován pokud zvolíte volbu French.) Navíc, instalací jazykové kolekce bude změnen obsah konfiguračního souboru language.dat, který určuje jaké vzory dělení budou vloženy do formátů.

d – Instalační adresáře. Tyto adresáře mohou být změněny takto:

TEXDIR
Kořenový adresář, do kterého bude vše instalováno. Implicitní hodnota je /usr/ TeX, a je obvykle měněna. Zvolíte-li například adresář /usr/local/texlive2003, umožní vám to mít několik různých verzí TeX Live vedle sebe. Pak si můžete udělat symbolický odkaz /usr/local/texlive na vhodnou verzi po otestování nové verze.

Pod Mac OS X obvykle TeXové nadstavby hledají TeX v /usr/local/teTeX, což je proto na tomto OS doporučený adresář pro instalaci.

TEXMFLOCAL
Do tohoto adresáře budou TeXvé instalační dávky instalovat soubory nezávislé na verzi distribuce, například fonty. Implicitní hodnota je TEXDIR/ texmf-local. Také doporučujeme zde ukládat všechny lokální balíky a lokální konfigurační soubory. Proto by umístění mělo být nezávislé na aktuální verzi TeX Live; například /usr/local/texmf-local.
VARTEXMF
Do tohoto podstromu budou instalovány a ukládány soubory, které jsou specifické pro danou verzi distribuce, například formátové soubory, konfigurační soubory modifikované konfiguračním programem texconfig (viz oddíl 4.1, strana 31). Implicitní hodnota je TEXDIR/texmf-var, a obvykle není důvod ji měnit.

o - Obecné volby. Zde můžete zvolit ze tří možností ovlivňujících instalaci:

a
Volba alternativního adresáře pro generované fonty. Standardně je použit podstrom VARTEXMF, zmíněný výše. Nastavení je užitečné pokud plánujete montovat hlavní strom pouze pro čtení, a proto jiný adresář (například specifický pro daný stroj) musí být použit pro dynamicky generované fonty.
l
Volba vytváření symbolických odkazů pro binárky, manové stránky a/nebo soubory GNU Info v dalších adresářích. Například, můžete chtít mít manové stránky v /usr/local/man a Info soubory v /usr/local/info. (Samozřejmě musíte mít oprávnění zápisu do těchto adresářů.)
d
Volba pro vynechání instalace stromu dokumentace fontů a maker. To je užitečné pokud jste dokumentaci již instalovali, nebo chcete ušetřit místo.
s
Volba pro vynechání instalace hlavního podstromu s makry a fonty. To je užitečné pokud instalujete na různých architekturách se sdíleným hlavním stromem přes NFS nebo automount.

i - Vlastní instalace. Pokud jste si ověřili všechna nastavení a možnosti konfigurace, zvolte i pro spuštění instalace do vybraných adresářů.

Posledním krokem je umístění (na architektuře závislého) podadresáře adresáře TEXDIR/bin do proměnné prostředí PATH, aby se nově instalované programy našly. Seznam názvů architektur najdete v tabulce 1 na straně 20, nebo si vypište obsah adresáře TEXDIR/bin.

Přesná syntaxe pro provedení výše popsané změny a její zapsání do startovací dávky uživatele záleží na shellu, který používáte. Pokud je to Bourne-kompatibilní shell (sh, bash, ksh, apod.), přidejte si do svého souboru $HOME/.profile toto:


PATH=/TEXDIR/bin/archname:$PATH; export PATH

Pro C shell-kompatibilní shelly (csh, tcsh) si dejte do svého $HOME/.cshrc tohle:


setenv PATH /TEXDIR/bin/archname:$PATH

Jakmile byla dokončena základní instalace, a byly nastaveny proměnné prostředí, na řadě je spuštění programu texconfig pro přizpůsobení instalace specifickým potřebám. To je popsáno v oddíle 4.1, na straně 31.

Níže uvádíme krátce okomentovaný příklad plné instalace, s binárkami pouze pro aktuální OS, se změnami, které doporučujeme výše. Výpis výzev a mačkání klávesy RETURN pro zestručnění vynecháváme.


> sh install-tl.sh
s b r                     # plné inst. schéma, návrat do hl. menu
d                         # změny adresářů
1 /usr/local/texlive2003  # kořenový adresář
2 /usr/local/texmf-local  # TEXMFLOCAL mimo TEXDIR
r                         # návrat do hl. menu
i                         # proveď instalaci
> texconfig ...
# nastavení PATH, předpokládaje Linux:
> PATH=/usr/local/texlive2003/bin/i386-linux:$PATH; export PATH

Pokud narazíte na problémy, pokuste se je řešit se svým místním systémovým administrátorem; například jak namontovat média TeX Live, jaké adresáře používat. Také detaily změn osobních konfiguračních souborů se mohou systém od systému lišit.

3.3 Instalace jednotlivých balíků na disk

Pokud chcete přidat jednotlivé balíky či kolekce z nové distribuce do existující předchozí instalace TeX Live nebo i jiné instalace TeXu, mající jinou adresářovou strukturu, můžete tak učinit z demo CD nebo z live DVD, ale ne inst CD. (Viz oddíl 2.1 na straně 11.)

Na začátku musíte namontovat CD resp. DVD, a povolit rozšíření Rock Ridge. Konkrétní příkaz se liší systém od systému; následující funguje pod Linuxem (název zařízení /dev/cdrom se může lišit, stejně tak název filesystému: Solaris například pro ISO 9660 používá název hsfs — High Sierra filesystem). Všechny příklady používají > jako prompt shellu; vstup uživatele je podtržený.)

> mount -t iso9660 /dev/cdrom /mnt/cdrom

Změňte aktuální adresář do právě namontovaného adresáře:

> cd /mnt/cdrom

Pod Mac OS X, adresář je typicky pod /Volumes, a zařízení bude namontováno automaticky.

Spusťte instalační dávku install-pkg.sh (ne install-tl.sh, která je určena pouze pro úplnou instalaci):


> sh install-pkg.sh options

První sada voleb určuje co se načte:

--package=pkgname
Jednotlivý balík k instalaci.
--collection=colname
Kolekce k instalaci.
--nodoc
Neinstalovat dokumentaci.
--nosrc
Neinstalovat zdrojové soubory.
--cddir=dir
Zdrojový adresář pro čtení; implicitně je to běžný adresář. Pokud jste postupovali podle výše uvedených instrukcí, bude to distribuční adresář a není potřeba ho měnit.
--listdir=dir
Tak zvaný ‘lists’ adresář pod cddir odkud se čtou informace o balících. Implicitní hodnota je cddir/texmf/tpm/lists; jediný důvod ji měnit je pokud děláte změny přimo do TeX Live.

Co se provede je určeno následujícími přepínači. Pokud není žádný specifikován, implicitní akcí je instalace vybraných souborů. Hlavní výstupní adresář je určen expanzí proměnné $TEXMFMAIN pomocí programu kpsewhich. Můžete to změnit nastavením proměnných prostředí TEXMFMAIN nebo TEXMF.

--listonly
Pouze vypíše soubory, které by se instalovaly, ale nic neinstaluje.
--archive=tarfile
Místo instalace souborů do TeXového systému vytváří tar archív.

Další volby:

--config
Po instalaci spusť texconfig init.
--nohash
Po instalaci nespouštěj mktexlsr pro aktualizaci databáze souborů.
--verbose
Detailní výpisy při běhu dávek.

Zde je pár příkladů:

  1. Prohlédnutí souborů v balíku fancyhdr bez jeho instalace:

    > sh install-pkg.sh --package=fancyhdr --listonly

    texmf/doc/latex/fancyhdr/README
    texmf/doc/latex/fancyhdr/fancyhdr.dvi
    texmf/doc/latex/fancyhdr/fancyhdr.pdf
    ...
  2. Instalace LaTeXovského balíku natbib:

    > sh install-pkg.sh --package=natbib
  3. Instalulace LaTeXovského balíku alg bez zdrojových souborů a dokumentace:

    > sh install-pkg.sh  --package=alg --nosrc --nodoc
  4. Instalace všech balíků z kolekce dodatečných maker pro plain TeX:

    > sh install-pkg.sh --collection=tex-plainextra
  5. Zapsání všech souborů balíku pstricks do souboru tar v /tmp:

    > sh install-pkg.sh --package=pstricks --archive=/tmp/pstricks.tar

Pokud narazíte na problémy, pokuste se je řešit se svým místním systémovým administrátorem; například jak namontovat média TeX Live, jaké adresáře používat. Také detaily změn osobních konfiguračních souborů se mohou systém od systému lišit.