Przewodnik po TEX Live
TEX Live 2008

Redakcja: Karl Berry
http://tug.org/texlive/

Sierpień 2008

Spis treści

1 Wstęp
 1.1 TEX Live i TEX Collection
 1.2 Obsługiwane systemy operacyjne
 1.3 Podstawy instalacji TEX Live
 1.4 Dostępna pomoc
2 Struktura TEX Live
 2.1 The TEX Collection: TEX Live, proTEXt, MacTEX
 2.2 Główne katalogi TEX Live
 2.3 Predefiniowane drzewa katalogów texmf
 2.4 Rozszerzenia TEX-a
 2.5 Inne ważniejsze programy TEX Live
 2.6 Pakiety i ich zestawy
 2.7 Fonty w TEX Live
3 Instalacja
 3.1 Start instalacji
  3.1.1 Unix
  3.1.2 Mac OS X
  3.1.3 Windows
  3.1.4 Instalator w trybie tekstowym
  3.1.5 Instalator w trybie graficznym
 3.2 Podczas instalacji
  3.2.1 Menu: binary systems (tylko Unix)
  3.2.2 Wybór tego, co ma być zainstalowane
  3.2.3 Katalogi
  3.2.4 Opcje
  3.2.5 Uruchamianie bezpośrednio z DVD (tylko w trybie tekstowym)
 3.3 Parametry instalacji z linii poleceń
  3.3.1 Parametr location
 3.4 Czynności poinstalacyjne
  3.4.1 Gdy zastosujemy dowiązania symboliczne
  3.4.2 Zmienne środowiska dla Unix
  3.4.3 Gdy uruchamiamy programy z DVD
  3.4.4 ConTEXt Mark IV
  3.4.5 Integracja lokalnych i prywatnych pakietów makr
  3.4.6 Integracja fontów z innych źródeł
 3.5 Testowanie instalacji
4 Instalacje sieciowe
5 Maksymalnie przenośny TEX Live na DVD i USB
6 tlmgr: zarządzanie instalacją
 6.1 tlmgr – tryb graficzny (GUI)
 6.2 Przykładowe wywołania tlmgr z linii poleceń
7 Uwagi dotyczące Windows
 7.1 Cechy specyficzne w systemie Windows
 7.2 Programy pomocnicze dla Windows
 7.3 Program Dviout
 7.4 User Profile to inaczej Home (katalog domowy)
 7.5 Rejestr Windows
 7.6 Uprawnienia w Windows
 7.7 WinShell
  7.7.1 Użycie plików „projektu”
  7.7.2 Drukowanie z WinShell na drukarce PostScriptowej
 7.8 W razie problemów
  7.8.1 Co zrobić gdy latex nie może znaleźć potrzebnych plików?
8 Instrukcja obsługi systemu Web2C
 8.1 Przeszukiwanie ścieżek przez Kpathsea
  8.1.1 Źródła ścieżek
  8.1.2 Pliki konfiguracyjne
  8.1.3 Rozwijanie ścieżek
  8.1.4 Rozwijanie domyślne
  8.1.5 Rozwijanie nawiasów
  8.1.6 Rozwijanie podkatalogów
  8.1.7 Lista znaków specjalnych i ich znaczeń – podsumowanie
 8.2 Bazy nazw plików
  8.2.1 Baza nazw plików
  8.2.2 kpsewhich – program do przeszukiwania ścieżek
  8.2.3 Przykłady użycia
  8.2.4 Diagnostyka błędów
 8.3 Parametry kontrolujące działanie programów
9 Budowa systemu na nowej platformie uniksowej
 9.1 Warunki wstępne
 9.2 Konfiguracja
 9.3 Uruchamianie make
 9.4 Końcowe kroki konfiguracyjne
10 Podziękowania
11 Historia
 11.1 Poprzednie wersje
 11.2 Edycja 2004
 11.3 Edycja 2005
 11.4 Edycja 2007
 11.5 Wydanie obecne
 11.6 Przyszłe wersje

1. Wstęp

1.1. TEX Live i TEX Collection

Niniejsza dokumentacja opisuje oprogramowanie TEX Live – dystrybucję TEX-a wraz z programami pomocniczymi, dostępną dla systemów GNU/Linux, różnych wersji Unix (w tym Mac OS X) oraz Windows.

TEX Live można ściągnąć z sieci bądź otrzymać na płytce DVD TEX Collection, dostarczanej swoim członkom przez Grupy Użytkowników Systemu TEX . Część 2.1 omawia pokrótce zawartość tej płytki. Zarówno TEX Live, jak i TEX Collection powstały dzięki zbiorowemu wysiłkowi Grup. W tym dokumencie omówimy głównie samą dystrybucję TEX Live.

TEX Live zawiera skompilowane programy: TEX, LaTeX2e, Metafont, MetaPost, BibTeX i wiele innych oraz bogaty zestaw pakietów makr o wielorakim zastosowaniu, a także fonty i dokumentacje. Wszystko to umożliwia skład publikacji w wielu językach.

Pakiety zawarte w TEX Live są regularnie aktualizowane z serwerów CTAN: http://www.ctan.org.

Lista najważniejszych zmian dokonanych w tej edycji TEX Live znajduje się w części 11.5, na str. 92.

Nie opisujemy tu, czym jest system TEX, a jedynie kwestię instalacji i konfiguracji oprogramowania TEX Live. Początkujący użytkownicy mogą się zapoznać z podstawowymi pojęciami np. w artykule Przewodnik po systemie TEX: texmf-doc/doc/polish/tex-virtual-academy-pl/cototex.html.

1.2. Obsługiwane systemy operacyjne

TEX Live zawiera oprogramowanie dla wielu platform linuksowych i uniksowych, w tym Mac OS X. Załączone pliki źródłowe pozwalają też na instalację na dodatkowych platformach.

Spośród systemów Windows obsługiwane są tylko wersje 2000 i nowsze. Zaniechano wsparcia dla Windows 9x, ME oraz NT, których obsługa była bardzo pracochłonna (w porównaniu z Linux/Unix). Wprawdzie brak jest oprogramowania na wersje 64-bitowe, ale aplikacje 32-bitowe powinny na nich działać.

W części 2.1 omówiono alternatywne dystrybucje, przeznaczone dla Windows oraz Mac OS X.

1.3. Podstawy instalacji TEX Live

TEX Live można zainstalować z płytki DVD lub internetu. Program instalacyjny jest niewielki i pozwala pobrać z sieci wszystkie potrzebne pakiety. Jest to wygodne, gdy potrzebujemy jedynie części oprogramowania TEX Live.

Posiadając płytkę DVD, możemy nie tylko zaistalować TEX Live na twardym dysku, ale i uruchomić programy bezpośrednio z niej (a nawet z obrazu DVD, jeśli nasz system pozwala na jego zamontowanie).

Szczegółowy opis instalacji TEX Live znajduje się w dalszych rozdziałach tego dokumentu, tu podamy jedynie skrócony przepis:

1.4. Dostępna pomoc

Społeczność TEX-owa jest bardzo aktywna i pomocna, stąd też większość poważnych zapytań nie pozostaje bez odpowiedzi. Przed zadaniem pytania warto je uprzednio dobrze przemyśleć i sformułować, ponieważ respondenci to wolontariusze, wśród których znaleźć się mogą mniej lub bardziej doświadczeni użytkownicy. (Jeśli preferujemy komercyjne wsparcie techniczne, możemy zamiast TEX Live zakupić system u jednego z dostawców, których listę można znaleźć na http://tug.org/interest.html#vendors.)

Oto lista źródeł pomocy, w kolejności przez nas rekomendowanej:

TEX FAQ
TEX-owy FAQ jest obszernym zbiorem odpowiedzi na wszelkie rodzaje pytań, od najprostszych do najbardziej zaawansowanych. Jest on załączony na TEX Live w katalogu texmf-doc/doc/english/FAQ-en, a także dostępny w sieci: http://www.tex.ac.uk/faq. Proponujemy zajrzeć najpierw tam. Uruchomiono też serwis FAQ w języku polskim: http://faq.gust.org.pl.
TEX Catalogue
Jeśli poszukujemy konkretnego pakietu, fontu, programu itp., to polecamy TEX Catalogue. Jest to obszerne zestawienie wszelkich pakietów dotyczących TEX-a. Patrz: http://www.ctan.org/help/Catalogue/.
TEX Web Resources
Strona http://tug.org/interest.html zawiera wiele odsyłaczy, w szczególności do książek, podręczników i artykułów poświęconych wszelkim aspektom pracy z systemem TEX.
archiwa pomocy
Dwa główne fora pomocy to grupa Usenet news:comp.text.tex oraz lista dyskusyjna texhax@tug.org. Warto przeszukać archiwa list dyskusyjnych, zawierające mnóstwo pytań i odpowiedzi zbieranych przez wiele lat: http://groups.google.com/group/comp.text.tex/topics oraz http://tug.org/mail-archives/texhax. Nie zaszkodzi skorzystanie z wyszukiwarki, np. http://www.google.com.
wysyłanie pytań
Jeśli nadal nie znajdujemy rozwiązania problemu, to możemy wysłać pytanie do comp.text.tex, korzystając z Google, czytnika wiadomości bądź pisząc list na adres texhax@tug.org. Przedtem jednak należy się zapoznać z poradami dotyczącymi sposobu zadawania pytań, zawartymi w FAQ: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion. Polscy użytkownicy mają do dyspozycji listę dyskusyjną GUST (polskiej Grupy Użytkowników Systemu TEX); informacje o niej znajdziemy na stronie http://www.gust.org.pl.
wsparcie TEX Live
Gdy chcemy zgłosić błąd bądź sugestie i komentarze dotyczące dystrybucji TEX Live, instalacji lub dokumentacji, mamy do dyspozycji listę dyskusyjną tex-live@tug.org. Jeśli kwestia dotyczy konkretnego programu (pakietu makr itp.) z TEX Live, to lepiej jednak skierować pytanie do osoby opiekującej się danym programem lub na specjalistyczną listę dyskusyjną.

Druga strona medalu to pomaganie tym, którzy mają problemy. Zarówno comp.text.tex, jak i texhax (oraz lista dyskusyjna GUST) są otwarte dla każdego, tak więc zapraszamy do włączenia się, czytania wiadomości i pomagania innym w miarę własnych możliwości. Witamy wśród użytkowników systemu TEX!

2. Struktura TEX Live

Omówimy tutaj strukturę i zawartość dystrybucji TEX Live, a także TEX Collection – płytki DVD, w skład której wchodzi TEX Live.

2.1. The TEX Collection: TEX Live, proTEXt, MacTEX

The TEX Collection DVD zawiera:

TEX Live
kompletny system na DVD, z możliwością uruchamiania bezpośrednio z płyty bądź instalacji na twardym dysku;
MacTEX
dla systemu Mac OS X; posiada on własny program instalacyjny i dodatkowe programy dla tego systemu; strona domowa projektu: http://www.tug.org/mactex/;
proTEXt
dystrybucja dla Windows, oparta na dystrybucji MiKTEX, rozszerzonej o dodatkowe narzędzia; całkowicie niezależna od TEX Live; ProTEXt posiada własny, łatwy w obsłudze program instalacyjny; strona domowa projektu: http://tug.org/protext;
CTAN
zrzut zawartości archiwów CTAN;
texmf-extra
katalog z wybranymi pakietami dodatkowymi.

CTAN, protext, i texmf-extra nie spełniają przyjętych dla TEX Live wymogów dotyczących swobody kopiowania, wobec tego należy ten fakt uwzględnić przy redystrybucji bądź modyfikacji zawartości wymienionych katalogów.

2.2. Główne katalogi TEX Live

Poniżej wymieniono ważniejsze podkatalogi głównego katalogu dystrybucji TEX Live. Na płytce live DVD cała dystrybucja TEX Live została umieszczona w katalogu texlive, nie zaś w katalogu głównym (poniżej traktujemy go jako katalog główny we wszystkich odniesieniach do TEX Live).

bin

skompilowane programy TEX-owe, zorganizowane w podkatalogach według platform systemowych;

readme.html

krótki wstęp z użytecznymi odnośnikami;

source

źródła wszystkich programów, włącznie z głównymi dystrybucjami Web2C TEX-a i Metafont-a;

support

różne programy pomocnicze związane z TEX-em, które nie są domyślnie instalowane; dla użytkowników systemów Windows dołączono ponadto szereg programów (edytory, „shelle TeX-owe”), których zwykle brak w typowej instalacji Windows (programy te mogą być szczególnie przydatne dla początkujących);

texmf

drzewo katalogów plików pomocniczych i dokumentacji dla programów (patrz: TEXMFMAIN w następnej części);

texmf-dist

główne drzewo katalogów formatów i pakietów (zawiera makra, fonty i dokumentacje; patrz: TEXMDIST w następnej części);

texmf-doc

drzewo samodzielnych dokumentacji (m.in. podręczniki itp.), niezwiązane z konkretnymi pakietami, zorganizowane według języków.

tlpkg

skrypty, programy i inne dane potrzebne do instalacji; katalog zawiera także „prywatne” dla TEX Live kopie systemów Perl i Ghostscript dla Windows (nie kolidują one z posiadanymi przez użytkownika podobnymi programami i działają tylko w ramach instalacji); poza tym dołączono szybki i wygodny program do podglądu plików postscriptowych (a także PDF) – PS_View dla Windows.

Prócz podkatalogów wymienionych powyżej, katalog główny zawiera skrypty instalacyjne oraz pliki README, w formacie tekstowym lub HTML, w kilku językach (również polskim).

Katalog texmf-doc zawiera, jak wspomniano wyżej, dokumentacje ogólne, np. podręczniki (także po polsku). Dokumentacje programów (man, info, także w formacie PDF) znajdują się w katalogu texmf/doc, zaś dokumentacje pakietów makr, fontów i formatów w katalogu texmf-dist/doc. W odszukaniu konkretnej dokumentacji w dowolnym z wymienionych katalogów mogą pomóc programy texdoc lub texdoctk. Pomocnym może też być plik doc.html, który znajdziemy w głównym katalogu.

Niniejsza dokumentacja w kilku językach znajduje się w katalogu texmf-doc:

2.3. Predefiniowane drzewa katalogów texmf

W tej części wymieniono wszystkie używane przez system, predefiniowane zmienne specyfikujące drzewa katalogów texmf, omówiono też ich przeznaczenie. Uruchomiając polecenie texconfig conf, zobaczymy wartości tych zmiennych, dzięki czemu łatwo ustalimy, które katalogi w naszej instalacji są przypisane do konkretnych zmiennych.

TEXMFMAIN

Drzewo katalogów zawierające podstawowe dla dystrybucji elementy systemu, jak skrypty (np. web2c/mktexdir), i inne pliki pomocnicze oraz ich dokumentację (nie zawiera zatem pakietów makr ani formatów).

TEXMFDIST

Drzewo katalogów zawierające pakiety makr, fontów itp., tak jak są one oryginalnie dystrybuowane; drzewo to może być współdzielone z dowolną dystybucją.

TEXMFLOCAL

Drzewo katalogów, które administratorzy mogą wykorzystać do przechowywania lokalnych makr, fontów itp., dostępnych dla wszystkich użytkowników serwera.

TEXMFHOME

Drzewo katalogów dla prywatnych makr, fontów itp. użytkownika. Rozwinięcie tej zmiennej zależy domyślnie od wartości przypisanej zmiennej systemowej $HOME (w Windows %USERPROFILE%).

TEXMFCONFIG

Drzewo katalogów wykorzystywane przez narzędzia texconfig, updmap oraz fmtutil do przechowywania danych konfiguracyjnych (domyślnie w ramach TEXMFHOME).

TEXMFSYSCONFIG

Drzewo katalogów wykorzystywane przez narzędzia texconfig-sys, updmap-sys oraz fmtutil-sys do przechowywania danych konfiguracyjnych dla całej instalacji.

TEXMFVAR

Drzewo katalogów wykorzystywane przez texconfig, updmapfmtutil do przechowywania wygenerowanych plików formatów i map fontowych (domyślnie w ramach TEXMFHOME).

TEXMFSYSVAR

Drzewo katalogów wykorzystywane przez texconfig-sys, updmap-sys oraz fmtutil-sys, a także przez program tlmgr do przechowywania wygenerowanych plików formatów i map fontowych dla całej instalacji.

Domyślny układ katalogów:

ogólnosystemowy katalog instalacji
może zawierać kilka wydań TEX Live:
2007

poprzednie wydanie,

...

2008

wydanie aktualne:

bin

 

i386-linux

programy dla GNU/Linux

...

universal-darwin

programy dla Mac OS X

win32

programy dla Windows

texmf

określany zmienną TEXMFMAIN

texmf-dist

TEXMFDIST

texmf-doc

TEXMFDOC

texmf-var

TEXMFSYSVAR

texmf-config

TEXMFSYSCONFIG

texmf-local

TEXMFLOCAL, katalog zachowywany od wydania do wydania,

katalog domowy użytkownika
($HOME lub %USERPROFILE%)
.texlive2007

prywatne pliki konfiguracyjne poprzedniego wydania:

.texlive2008

prywatne pliki konfiguracyjne dla bieżącego wydania:

texmf-var

TEXMFVAR

texmf-config

TEXMFCONFIG

texmf

TEXMFHOME prywatne makra, fonty itp.

2.4. Rozszerzenia TEX-a

Standardowy TEX został zamrożony, ale jest i będzie w przyszłości dostępny w dystrybucji. TEX Live zawiera ponadto kilka wersji rozszerzonych standardowego TEX-a:

e-TEX
wersja programu TEX, w której dodano pożyteczny zestaw nowych poleceń wbudowanych (dotyczących głównie rozwijania makr, leksemów znakowych, interpretacji znaczników itp.) oraz rozszerzenie TEX--XE T dla składu od prawej do lewej. W trybie domyślnym e-TEX jest w 100% zgodny ze standardowym programem TEX. Więcej szczegółów można znaleźć w texmf-dist/doc/etex/base/etex_man.pdf.
pdfTEX
program zawierający silnik e-TEX, umożliwiający tworzenie plików zarówno w formacie PDF, jak i DVI. Jest on domyślnym programem dla większości formatów (prócz plain TEX), nie ma więc obecnie rozróżnienia na „maszyny” pdftex i pdfetex, jak to miało miejsce w poprzednich wersjach programów i w poprzednich dystrybucjach TEX Live. Podręczniki znajdziemy w katalogu texmf-dist/doc/pdftex/manual/pdftex-a.pdf, zaś przykład wykorzystania – w pliku texmf-dist/doc/pdftex/manual/samplepdf/samplepdf.tex.
LuaTEX
docelowo sukcesor pdfTEX-a, z którym ma być zgodny wstecz. Powinien także zastąpić Aleph (patrz niżej). Załączony interpreter Lua (patrz strona domowa http://www.lua.org/) pozwala na eleganckie rozwiązanie wielu trudnych problemów TEX-a. Program texlua ma funkcjonalność samodzielnego interpretera Lua, co sprawia, że jest używany w TEX Live do wielu zadań. Patrz http://www.luatex.org/ i na DVD texmf-dist/doc/luatex/luatexref-t.pdf.
XeTEX
umożliwia kodowanie tekstów w Unicode oraz korzystanie z fontów OpenType (także tych dostępnych w systemie operacyjnym), przy czym stosuje biblioteki obce, patrz texmf-dist/doc/xetex/XeTeX-reference.pdf lub http://scripts.sil.org/xetex.
(Omega)
program, który pracuje wewnętrznie ze znakami kodowanymi 16-bitowo (Unicode), pozwalając składać jednocześnie większość tekstów spotykanych na świecie. Wspomaga dynamicznie ładowane tzw. „procesy tłumaczenia ” (OTP), co pozwala użytkownikowi definiować złożone transformacje, wykonywane na dowolnych strumieniach wejściowych. Więcej szczegółów znaleźć można na DVD: texmf-dist/doc/omega/base/doc-1.8.tex (dokumentacja niezbyt aktualna; sam program też od dawna nie jest aktualizowany).
Aleph
łączy rozszerzenia  i e-TEX; powstał jako niezależny projekt z potrzeby stabilnej „używalności” programu Omega, w sytuacji gdy ten jest ciągle w fazie eksperymentalnej. Minimalna dokumentacja: texmf-dist/doc/aleph/base.

2.5. Inne ważniejsze programy TEX Live

Poniżej zestawiono inne najczęściej używane programy dostępne w dystrybucji TEX Live:

bibtex

tworzenie spisów bibliograficznych;

makeindex

tworzenie posortowanych skorowidzów;

dvips

konwersja DVI do PostScript;

xdvi

przeglądarka plików DVI dla X Window;

dvilj

sterownik dla drukarek HP LaserJet;

dv2dt, dt2dv

konwerter DVI do/z tekstu ASCII;

dviconcat, dviselect

programy do manipulacji stronami w plikach DVI;

dvipdfmx

konwersja DVI do PDF, metoda alternatywna w stosunku do wspomnianego wyżej programu pdfTEX (pakiety ps4pdf pdftricks dostarczają kolejnych możliwości);

psselect, psnup,

narzędzia do manipulacji na plikach postscriptowych;

lacheck

kontrola syntaktyki plików LATEX-owych;

texexec, texmfstart

programy uruchamiające dla ConTEXt;

tex4ht

postprocesor dla TEX-a konwersji do HTML i XML.

2.6. Pakiety i ich zestawy

Zawartość drzew texmf na TEX Live została do celów instalacji zorganizowana w szereg „zestawów” (collections), z których każdy posiada zbiór „pakietów” (packages; jest ich obecnie ponad 2500). Normalna instalacja pozwala użytkownikowi skopiować z DVD na twardy dysk jeden lub więcej zestawów, można też zainstalować jedynie pojedynczy pakiet.

Zestawy pozwalają lepiej dobrać instalowane składniki, a także określić, jakie języki będą obsługiwane po instalacji. Najważniejszy zestaw, wymagany dla większości zastosowań, to „basic”. Zestawy „latex” i „pdftex” są rekomendowane dla większości użytkowników. Pozostałe zestawy są opcjonalne.

Oto dostępne zestawy i krótki opis ich zawartości:

basic
podstawowe programy, pakiety makr i fontów systemu TEX, pliki konfiguracyjne dla podstawowych sterowników;
bibtexextra
dodatkowa, obszerna biblioteka stylów BibTEX-owych i bazy danych bibliograficznych (podstawowe style znajdują się w zestawie „basic”);
chemistry
pakiety makr do składu wzorów chemicznych;
context
pakiet makr do ConTEXt – „dialektu” TEX-a autorstwa Hansa Hagena;
documentation
dodatkowe, użyteczne dokumentacje;
etex
pliki pomocnicze dla programu e-TEX;
extrabin
różne programy pomocnicze; zestaw zawiera m.in. programy i makra dla systemu texinfo, programy do manipulacji na plikach DVI itp.;
fontbin
programy do konwersji plików fontowych oraz testowania i instalacji fontów (zestaw do tworzenia fontów wirtualnych, manipulacji plikami .gf i .pk, programy mft, fontinst itp.);
fontsrecommended
obszerna biblioteka częściej używanych fontów w postaci źródłowej (.mf) bądź fontów obwiedniowych oraz pliki z definicjami i stylami LATEX-a dla tych fontów;
fontsextra
biblioteka różnych rzadziej używanych fontów;
formatsextra
pliki pomocnicze do generowania dodatkowych „formatów” (tj. obszerne zestawy makr służące do wstępnego przetworzenia i utworzenia pliku .fmt);
games
pakiety do prezentacji zapisu różnych gier (szachy, brydż itp.);
genericextra
obszerna biblioteka makr, trudnych do sklasyfikowania, działających z różnymi formatami (Plain, LATEX itp.);
htmlxml
pakiety konwersji LATEX-a do XML/HTML oraz do składu dokumentów XML/SGML;
lang
wsparcie poszczególnych języków; zestawy zawierają wzorce przenoszenia wyrazów i makra obsługi danych języków, czasem też specyficzne fonty itp., przykładowo:
langpolish
zawiera polskie pakiety: makra do tworzenia formatu MeX, pakiety polski, mwcls, fonty i makra dodatkowe, przydatne dla polskich użytkowników, dokumentacje w języku polskim;
latex
podstawowe pakiety LATEX-a;
latexrecommended
rekomendowany zestaw często używanych pakietów dodatkowych;
latex3
pakiety-„zwiastuny” LATEX3, działające z LaTeX2e;
latexextra
bogaty wybór dodatkowych pakietów dla LATEX-a;
mathextra
dodatkowe pakiety do składu zaawansowanej matematyki;
metapost
MetaPost i pakiety do tworzenia rysunków z użyciem MetaFonta;
music
makra do składu nutowego;
omega
rozszerzenie TEXa autorstwa Johna Plaice’a i Yannisa Haralambousa, działające ze znakami kodowanymi 16-bitowo;
pdftex
pliki pomocnicze dla pdfTEX-a, wersji programu TEX tworzącej pliki w formacie PDF;
pictures
pakiety do tworzenia diagramów i innych obiektów graficznych;
plainextra
dodatkowe biblioteki makr dla Plain TEX;
psutils
narzędzia do manipulacji plikami PostScript-owymi;
publishers
pakiety makr pochodzące od różnych wydawnictw;
t1utils
narzędzia do obsługi fontów w formacie Type 1;
texbooks
przykłady i inne materiały autorstwa D.E. Knutha;
ttfutils
narzędzia do konwersji fontów True Type.

Plik tlpdb/texlive.tlpdb (wykorzystywany podczas instalacji) zawiera spis wszystkich plików w każdym pakiecie.

2.7. Fonty w TEX Live

TEX Live zawiera wiele wysokiej jakości fontów skalowanych. Patrz http://tug.org/fonts oraz texmf-doc/doc/english/free-math-fonts-survey.

3. Instalacja

3.1. Start instalacji

Instalację TEX Live uruchamiamy skryptem install-tl (install-tl.bat dla Windows) z płytki TEX Collection DVD bądź dostępnym w pobranym z sieci pakiecie instalacyjnym.

Instalator z sieci:
z archiwum CTAN, z katalogu systems/texlive/tlnet (http://mirror.ctan.org/systems/texlive/tlnet automatycznie przekierowuje do najbliższej kopii CTAN) należy pobrać plik install-tl.zip (dla Unix i Windows) lub znacznie mniejszy install-unx.tar.gz (tylko dla Unix). Po rozpakowaniu, w katalogu install-tl/ znajdziemy skrypty instalacyjne install-tl install-tl.bat.
TEX Collection DVD:
po zamontowaniu płytki należy zmienić katalog bieżący na texlive (w Windows program instalacyjny powinien uruchomić się automatycznie). DVD otrzymamy w ramach członkowstwa w dowolnej Grupie Użytkowników Systemu TEX (kontakt w Polsce http://www.gust.org.pl).

Dalsze kroki omówiono dokładniej w następnych częściach.

3.1.1. Unix

Poniżej > oznacza prompt systemu; to, co wpisuje użytkownik, zaznaczono pogrubieniem. W systemach zgodnych z Unix należy wykonać w oknie terminala:

> cd /path/to/installer
> perl install-tl
(można także uruchomić perl /path/to/installer/install-tl lub ./install-tl; w dalszej części nie będziemy powtarzać wszelkich możliwych kombinacji).

Do uruchomienia w trybie graficznym (GUI) wymagany jest w systemie moduł Perl/TK:

> perl install-tl -gui

Kompletny wykaz dostępnych opcji otrzymamy, uruchamiając:

> perl install-tl -help

Uwaga dotycząca uprawnień w Unix: program instalacyjny będzie respektował aktualną wartość umask. Jeśli więc chcemy, aby instalacja była dostępna dla innych, to musimy ustawić wartość np. umask 002. Więcej informacji na temat umask znajdziemy w podręcznikach systemu operacyjnego.


  ======================> TeX Live installation procedure <=====================
  
  =======> Note: Letters/digits in <angle brackets> indicate menu items <=======
  =======>       for commands or configurable options                   <=======
  
  
   Detected platform: Intel x86 with GNU/Linux
  
   <B> binary systems: 1 out of 16
  
   <S> Installation scheme (scheme-full)
  
   Customizing installation scheme:
     <C> standard collections
     <L> language collections
     83 collections out of 84, disk space required: 1666 MB
  
   <D> directories:
     TEXDIR (the main TeX directory):
       !! default location: /usr/local/texlive/2008
       !! is not writable, please select a different one!
     TEXMFLOCAL (directory for site-wide local files):
       /usr/local/texlive/texmf-local
     TEXMFSYSVAR (directory for variable and automatically generated data):
       /usr/local/texlive/2008/texmf-var
     TEXMFSYSCONFIG (directory for local config):
       /usr/local/texlive/2008/texmf-config
     TEXMFHOME (directory for user-specific files):
       ~/texmf
  
   <O> 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 in standard directories
  
   <V> Install for running from DVD
  
  Other actions:
   <I> start installation to HD
   <H> help
   <Q> quit
  
  Enter command:

Rysunek 1: Główny ekran instalatora w trybie tekstowym (GNU/Linux)



pict

Rysunek 2: Główny ekran instalatora GUI (Windows)


3.1.2. Mac OS X

Jak wspomniano w części 2.1, dla Mac OS X przygotowano odrębną dystrybucję MacTEX (http://tug.org/mactex), w tym wypadku należy użyć dedykowanego programu instalacyjnego, gdyż zmienia on w specyficzny sposób ustawienia systemu, w szczególności pozwala na łatwe przełączanie pomiędzy różnymi dystrybucjami TEX-a dla Mac OS X: MacTEX, gwTEX, Fink, MacPorts,…

MacTEX jest oparty na TEX Live i główne drzewa katalogów są dokładnie te same, jedynie dodawane są katalogi ze specyficznymi dla systemu Mac OS X dokumentacjami i aplikacjami.

3.1.3. Windows

Gdy używamy instalatora pobranego z sieci (bądź program ten nie uruchamia się automatycznie po włożeniu DVD do napędu), należy uruchomić install-tl.bat (np. podwójnym kliknięciem myszy). Można to uczynić także z linii poleceń – gdy katalog zawierający ten plik jest bieżącym, wystarczy uruchomić:

> install-tl

W linii poleceń można też podać ścieżkę do programu, np.:

> D:\texlive\install-tl
dla TEX Collection DVD, zakładając, że D: jest napędem DVD.

Instalacja w trybie tekstowym wymaga podania:

> install-tl -no-gui

Wszystkie dostępne opcje wyświetlimy uruchamiając:

> install-tl -help

3.1.4. Instalator w trybie tekstowym

Rysunek 1 przedstawia główny ekran programu install-tl w trybie tekstowym w systemie Unix. W tym trybie nie używamy ani klawiszy kursora, ani myszy, tylko wyłącznie klawiszy cyfr i liter (uwaga: duże i małe litery są rozróżniane!). Wybraną opcję zatwierdzamy klawiszem Enter. Instalator w trybie tekstowym jest dlatego tak prosty, by działał na możliwie wielu platformach, nawet wyposażonych w ubogie biblioteki Perla (dla Windows załączono taki właśnie podzbiór dystrybucji Perla).

3.1.5. Instalator w trybie graficznym

Rysunek 2 pokazuje instalator w trybie graficznym (zrzut ekranu w systemie Windows).

3.2. Podczas instalacji

Program instalacyjny jest z założenia na tyle prosty, że szczegółowe wyjaśnienia są zbędne. Podamy jednak kilka uwag dotyczących różnych opcji i dostępnych podmenu.

3.2.1. Menu: binary systems (tylko Unix)


  Available sets of binaries: (Dostępne zestawy programów dla:)
  ===============================================================================
  
     a [ ] alpha-linux      DEC Alpha with GNU/Linux
     b [ ] amd64-freebsd    x86_64 with FreeBSD
     c [ ] hppa-hpux        HP-UX
     d [ ] i386-freebsd     Intel x86 with FreeBSD
     e [X] i386-linux       Intel x86 with GNU/Linux
     f [ ] i386-openbsd     Intel x86 with OpenBSD
     g [ ] i386-solaris     Intel x86 with Sun Solaris
     h [ ] mips-irix        SGI IRIX
     i [ ] powerpc-aix      PowerPC with AIX
     j [ ] powerpc-linux    PowerPC with GNU/Linux
     k [ ] sparc-linux      Sparc with GNU/Linux
     l [ ] sparc-solaris    Sparc with Solaris
     m [ ] universal-darwin universal binaries for MacOSX/Darwin
     o [ ] win32            Windows
     p [ ] x86_64-linux     x86_64 with GNU/Linux

Rysunek 3: Wybór platformy (systemu operacyjnego)


Rysunek 3 pokazuje (w trybie tekstowym) wybór platformy (systemu operacyjnego). Domyślnie instalowane są tylko programy dla bieżącej platformy, ale menu to pozwala wybrać także zestaw dla innych platform. Może być to przydatne do instalacji na serwerze i współdzielenia zasobów w sieci dla różnych systemów operacyjnych bądź dla instalacji dla kilku systemów na tej samej maszynie.

3.2.2. Wybór tego, co ma być zainstalowane


  Select a scheme: (Wybór schematu do instalacji:)
  ===============================================================================
  
   a [ ] TeX Live basic scheme
   b [ ] TeX Live scheme for ConTeXt
   c [X] TeX Live full scheme
   d [ ] GUST TeX Live scheme
   e [ ] GUTenberg TeX Live scheme
   f [ ] TeX Live medium scheme
   g [ ] TeX Live minimal scheme
   h [ ] TeX Live for Omega users
   i [ ] teTeX scheme
   j [ ] XML typesetting scheme

Rysunek 4: Menu: wybór schematów


Rysunek 4 pokazuje menu „Wybór schematów”. Schematy to obszerne zestawy pakietów, przeznaczone do wstępnego wyboru instalowanych komponentów. Mamy tu schematy do instalacji: podstawowej (basic), typowej (medium) i pełnej (full; jest ona domyślna), pozostałe przygotowano z myślą o wybranych grupach użytkowników (np. GUST i GUTenberg przygotowały schematy dla swoich członków) lub zastosowaniach (np. XML lub Omega).


pict

Rysunek 5: Menu Standard Collections (Kolekcje standardowe) (Linux)


Wstępnie wybrane schematy można modyfikować. W skład ,schematów” wchodzą tzw. „kolekcje”, które można wybrać w kolejnych menu o nazwach: „Kolekcje standardowe” i „Kolekcje językowe” (rysunek 5). Kolekcje stanowią niższy poziom niż schematy, a same składają się z „pakietów”. Dopiero pakiety zawierają właściwe pliki makr, fontów itp. Jeśli chcemy dodać lub usunąć pakiet, to po instalacji właściwej użyjemy programu tlmgr (patrz część 6).

3.2.3. Katalogi

Domyślny układ katalogów opisano w części 2.3 na str. 9. Położenie domyślne całej instalacji (TEXDIR) różni się w Windows (%PROGRAMFILES%\texlive\2008) i w Unix (/usr/local/texlive/2008).

Głównym powodem, dla którego zmieniamy domyślne położenie TEXDIR, może być brak uprawnień. Aby zainstalować TEX Live, nie musimy być administratorem systemu, musimy jednak posiadać uprawnienia do zapisu w docelowym katalogu. Logiczną alternatywą może być wtedy instalacja w katalogu domowym, szczególnie wtedy, gdy będziemy jedynym użytkownikiem. Stosujemy tu zapis „~” do zaznaczenia takiego wyboru, np. ~/texlive/2008. Zalecamy stosowanie katalogu z nazwą odzwierciedlającą rok wydania, co pozwoli na zainstalowanie obok siebie różnych wydań TEX Live.

Zmiana TEXDIR w programie instalacyjnym zmieni także ścieżki katalogów określone przez zmienne TEXMFLOCAL, TEXMFSYSVAR TEXMFSYSCONFIG.

TEXMFHOME jest zalecanym położeniem dla prywatnych makr i fontów użytkownika. Domyślnym katalogiem jest ~/texmf. W odróżnieniu od TEXDIR, znak ~ jest zachowywany w generowanych plikach konfiguracyjnych, ponieważ w wygodny sposób odnosi się do katalogu domowego podczas każdego uruchamiania programów. Znak ten rozwijany jest do zmiennej $HOME w Unix i %USERPROFILE% w Windows.

3.2.4. Opcje


  <P> use letter size instead of A4 by default: [ ]
  <F> create all format files:                  [X]
  <D> install font/macro doc tree:              [X]
  <S> install font/macro source tree:           [X]
  <L> create symlinks in standard directories:  [ ]
             binaries to:
             manpages to:
                 info to:

Rysunek 6: Menu: Options (Opcje) w Unix


Rysunek 6 pokazuje menu (w trybie tekstowym) z dodatkowymi opcjami. Warto tu wspomnieć o trzech z nich:

use letter size instead of A4 by default
(użyj domyślnego formatu papieru letter zamiast A4): pozwala określić domyślny format papieru dla wielu programów. Oczywiście format papieru można specyfikować potem dla ka