summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/texlive/texlive-de/texlive-de-new.tex
blob: eb8ea421e103bc5142027226b05535f4c60409f4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959
1960
1961
1962
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
2027
2028
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
2048
2049
2050
2051
2052
2053
2054
2055
2056
2057
2058
2059
2060
2061
2062
2063
2064
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
%\pdfoutput=0
\documentclass[12pt,ngerman,a4paper,fullparskip]{scrreprt}

\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{booktabs}
\usepackage{babel}
\usepackage{graphicx}
\usepackage{csquotes}
\usepackage{paralist}
\usepackage{xcolor}
\usepackage{xspace}
\usepackage{url}
\usepackage{multicol}
\usepackage{showlabels}
\usepackage[tocindentauto]{tocstyle}
\usepackage{alltt}


\usepackage{bera}
\usepackage[]{ulem}

\newcommand{\tlcurrentyear}{2013}
\newcommand{\TL}{\TeX\ Live\xspace}
\newcommand{\email}[1]{\texttt{#1}}
\newcommand{\acro}[1]{\texttt{#1}}
\newcommand{\cmdname}[1]{\texttt{#1}}
\newcommand{\code}[1]{\texttt{#1}}
\newcommand{\prog}[1]{\texttt{#1}}
\newcommand{\optname}[1]{\texttt{#1}}
\newcommand{\OnCD}[1]{\texttt{#1}}
\newcommand{\file}[1]{\texttt{#1}}
\renewcommand{\filename}[1]{\texttt{#1}}
\newcommand{\dirname}[1]{\texttt{#1}}
\newcommand{\pkgname}[1]{\texttt{#1}}
\newcommand{\Webc}[1]{\texttt{#1}}
\newcommand{\envname}[1]{\texttt{#1}}
\newcommand{\TeXXeT}{TeXXeT}
\newcommand{\KPS}{Kpathsea\xspace}
\newcommand{\var}[1]{\texttt{#1}}


\newcommand{\samp}[1]{\texttt{#1}}
\newcommand{\Ucom}[1]{\textbf{\texttt{#1}}}
\newcommand{\bs}{\protect\normalfont\ttfamily\char'134}

\usepackage{fancyvrb}
\DefineVerbatimEnvironment{boxedverbatim}{Verbatim}{fontsize=\footnotesize,frame=single}


\setlength{\parskip}{1em}
\setlength{\parindent}{0pt}


\def\TK{\TeX\ Collection}

\newcommand\ConTeXt{C\kern-.0333emon\-\kern-.0667em\TeX\kern-.0333emt}
\newcommand\MIKTEX{MiK\kern-.025em \TeX}% per www.miktex.org

\def\MP{MetaPost}
\def\MF{MetaFont}
\def\BibTeX{Bib\TeX}

\providecommand*{\CD}{\acro{CD}\xspace}
\providecommand*{\CTAN}{\acro{CTAN}\xspace}
\providecommand*{\DVD}{\texorpdfstring{\acro{DVD}}{DVD}\xspace}
\providecommand*{\GNU}{\acro{GNU}\xspace}
\providecommand*{\HTML}{\acro{HTML}\xspace}
\providecommand*{\ISO}{\texorpdfstring{\acro{ISO}}{ISO}\xspace}
\providecommand*{\MacOSX}{Mac\,\acro{OS\,X}\xspace}
\providecommand*{\PS}{Post\-Script\xspace}
\providecommand*{\TDS}{\acro{TDS}\xspace}
\providecommand*{\USB}{\texorpdfstring{\acro{USB}}{USB}\xspace}
\providecommand*{\dvi}{\acro{DVI}\xspace}
\providecommand*{\web}{\texttt{WEB}\xspace}
\providecommand*{\XeTeX}{xe\TeX\xspace}


\newcommand{\dante}{DANTE~e.\,V\kern-0.15em.}

\usepackage{hyperref}
\usepackage[]{url}
\hypersetup{%
  colorlinks=true,   % aktiviert farbige Referenzen
  linkcolor = blue,  % Linkfarbe blau
  citecolor = blue,  % cite-Farbe blau
  urlcolor = blue,  % cite-Farbe blau
  pdfpagemode=UseNone,  % PDF-Viewer startet ohne Inhaltsverzeichnis et.al.
  pdfstartview=FitH} % PDF-Viewer benutzt beim Start bestimmte Seitenbreite

\hypersetup{%
  pdftitle={TeX Live Anleitung},%
  pdfauthor={Uwe Ziegenhagen, ww.uweziegenhagen.de},%
  pdfsubject={TeX Live },%
  pdfkeywords={TeX, LaTeX, TeX Live}%
}

\begin{document}

\begin{titlepage}

\begin{center}
\vspace*{3cm}

 \Huge Anleitung zu \TL\vspace*{1cm}

\Large Version \tlcurrentyear

\end{center}

\vfill \noindent Karl Berry (Herausgeber) \\
verantwortlich für die deutsche Ausgabe:\\ 
Uwe Ziegenhagen, \href{mailto:ziegenhagen@gmail.com}{ziegenhagen@gmail.com} \\
Köln, den \today
\end{titlepage}

\tableofcontents

\listoffigures

\listoftables


%
%
%\section{Einleitung}\label{sec:intro}
%\subsection{\TL\ und die \TeX-Collection}


\chapter{Einleitung}\label{sec:intro}
\section{\TL und die \TL-Collection}

Diese Anleitung beschreibt das \TL-System an sich, nicht die Arbeit mit \TeX/\LaTeX. 

Die {\TL} Distribution enthält \TeX/\LaTeX-Systeme für Linux, verschiedene \acro{UNIX}-Plattformen, {\MacOSX} und Windows. Sowohl \TL{} als auch die \TK{} sind durch das Engagement vieler Freiwilliger aus vielen \TeX-Vereinen  entstanden. 

Wahrscheinlich haben Sie \TL{} auf einem von zwei Wegen bezogen, entweder
per direktem Download von \TL{} oder als Teil der \DVD{} \TK, die von
vielen \TeX-Vereinen (u.\,a. \dante) an ihre Mitglieder verschickt werden
und in Deutschland über die Fachbuchhandlung Lehmanns (\url{http://www.lob.de})
vertrieben wird. Abschnitt~\ref{sec:tl-coll-dists} beschreibt kurz den
Inhalt der \TK-\DVD. 



{\TL} enthält lauf"|fähige Versionen von \TeX, \LaTeXe, \ConTeXt, \MF, \MP, {\BibTeX}  und vielen 
anderen Programmen, sowie eine umfassende Auswahl an Makros, Zeichensätzen und
Beschreibungen, die gemäß der Standard"=\TeX"=Verzeichnisstruktur (\TDS) abgelegt sind.

Eine kurze Zusammenfassung der wesentlichen Änderungen der aktuellen \TL-Version
gegenüber der Vorgängerversion finden Sie im Abschnitt~\ref{sec:tlcurrent} auf
Seite~\pageref{sec:tlcurrent}.

\section{Unterstützung verschiedener Betriebssysteme}\label{sec:os-support}

\TL{} enthält direkt ausführbare Programme für viele Unix-basierte Betriebssysteme, insbesondere GNU/Linux und \MacOSX\ und Cygwin. Selbst wenn für Ihr Unix-System wider Erwarten keine ausführbaren Programme enthalten sind, sollten Sie in der Lage sein, aus den mitgelieferten Programm-Quellen ein funktionierendes \TeX-System zu kompilieren.

Bezüglich Microsoft Windows werden Versionen ab Windows~XP unterstützt, frühere Versionen werden nicht unterstützt. Es existieren zwar keine  64-Bit-Ver\-sionen der Programme, allerdings sollten die 32-Bit-Programme problemlos auf 64-Bit-Systemen funktionieren.

\section{Einsatzmöglichkeiten des \TL-Systems der \TeX\ Collection}\label{sec:basic}

Sie können das \TL-System wahlweise von der \DVD oder über das
Internet (\url{http://tug.org/texlive/acquire.html}) installieren.
Der \prog{Net Installer} ist ein kleines Programm,
das die benötigten Teile aus dem Internet nachlädt. Dieser Weg bietet
sich an (eine schnelle und stabile Internetverbindung voraus gesetzt),
wenn Sie kein komplettes \TL{} installieren wollen, sondern Ihr System nur
aus bestimmten Paketen bestehen soll.

Wenn Sie die \DVD{} besitzen (oder das ISO-Image der \DVD{} herunter
geladen haben -- dieses kann auf einigen Systemen sogar direkt als
virtuelles Medium \enquote{gemountet} werden), können Sie \TL{} nach
Wunsch auf Ihrer Festplatte installieren. Im Gegensatz zu früher ist
\TL{} nicht mehr direkt von der \DVD{} lauffähig. Sie können aber
eine portable Version z.\,B. auf einem USB-Stick installieren, wie im
Abschnitt~\ref{sec:portable-tl} beschrieben.

Beide Methoden werden in den Abschnitten zur Installation beschrieben.
Hier daher nur die kurze Zusammenfassung:

\begin{itemize}
\item Das Hauptinstallationsskript ist \cmdname{install-tl}. Es bietet
eine grafische Benutzeroberfläche (GUI) für die Standardinstallation
(den sogenannten \enquote{wizard mode}), einen  Textmodus und eine grafische Oberfläche im Expertenmodus.
Unter Windows ist der grafische \enquote{wizard mode} der Standard, auf allen anderen
Systemen ist es der Textmodus. Durch die Optionen \code{-gui=wizard}, \code{-gui=text} und \code{-gui=perltk} können Sie gezielt auswählen, ob das Installationsprogramm
im ">wizard mode"<, Textmodus oder mit der grafischen Oberfläche im Expertenmodus
starten soll.
\item \TL installiert u.\,a. den ">\TL Manager"< mit dem Namen
\prog{tlmgr}. Auch dieser unterstützt Text- und GUI-Mode. Mit diesem
Programm können Sie einerseits Pakete von \TL installieren oder deinstallieren,
andererseits \TL konfigurieren.
\end{itemize}

\section{\TL und Sicherheit}

Nach bestem Wissen und Gewissen kann man sagen, dass die \TeX-Kernprogramme selbst sehr robust sind. Dieses Maß an Robustheit und Sicherheit wird jedoch möglicherweise nicht von allen Programmen erreicht, die Teil von \TL sind. Daher gilt für \TL das, was auch für alle anderen Programme gilt: Vorsicht bei der Verarbeitung von Quellcode, den man nicht genau kennt, zur maximalen Sicherheit sollte man in diesen Fällen die entsprechenden Dateien in einem neuen Unterverzeichnis verarbeiten.

Die Sorge um die Sicherheit gilt vor allem für MS Windows, da Windows-Programme zuerst im aktuellen Verzeichnis suchen, egal wie Pfad-Angaben gesetzt sind. Theoretisch ermöglicht dies eine Reihe von Angriffsszenarien. Viele Sicherheitslücken in Programmen von \TL wurden geschlossen, andere bestehen auch weiterhin, besonders im Umgang mit Drittanbieter-Software. 

Aus diesem Grund empfehlen wir bei der Verarbeitung von unbekanntem Quellcode, auf das Vorhandensein von ausführbaren Dateien im Quellcode-Verzeichnis zu achten. Diese sollten nicht vorhanden sein und erst recht nicht durch die Verarbeitung von \TeX-Quellcode erzeugt worden sein. 

\TeX und seine Begleitprogramme können in Dateien schreiben, wenn ein Dokument übersetzt wird. Diese Funktion kann auch missbräuchlich eingesetzt werden. Daher ist bei der Verarbeitung von unbekannten Quellen die Nutzung eines neuen Unterverzeichnisses der sicherste Weg!

\section{Hilfe zu \TeX, \LaTeX\ \& Co}\label{sec:help}

Die \TeX-Gemeinschaft ist ebenso aktiv wie hilfsbereit, und es wird
praktisch jede ernst gemeinte Frage beantwortet. Diese Hilfe ist allerdings
nicht formal organisiert, sondern wird von Freiwilligen in ihrer
Freizeit geleistet. Es ist daher wichtig, dass Sie vor einer
Fragestellung Ihre \enquote{Hausaufgaben}  erledigen. 


Die folgende Liste stellt die leicht zugänglichen Hilfe-Quellen in der
empfohlenen Reihenfolge vor:

\begin{description}
\item [Einführung:] Wenn Sie \TeX-Anfänger sind und eine englische Einführung in das System benötigen, sollten Sie \url{http://tug.org/begin.html} lesen.

Für deutschsprachige \LaTeX-Anfänger ist die \enquote{\LaTeXe-Kurzbeschreibung} von großem Nutzen 
 (\OnCD{texmf-doc/doc/german/lshort-german/l2kurz.pdf}).

\item [\TeX-\acro{FAQ}s:]
      Die \TeX-\acro{FAQ} (im Deutschen \file{de-tex-faq} über
      das Textsatzsystem TeX und Dante, die Deutschsprachige
      Anwendervereinigung TeX e.V., ist ein riesiges Kompendium
      mit Fragen (und Antworten) aller Art, von der einfachsten
      Anfängerfrage bis zu Expertenwissen.

      Sie finden die deutschsprachige FAQ unter \url{http://www.dante.de/FAQ.html}. Des Weiteren existiert eine englischsprachige FAQ,  die im Internet unter \url{http://www.tex.ac.uk/faq} verfügbar ist.

Bitte schauen Sie bei auftretenden Problemen, insbesondere wenn Sie als Anfänger mit \TeX/\LaTeX\ arbeiten, zuerst diese beiden Möglichkeiten.

\item [\TeX-Catalogue:] Wenn Sie auf der Suche nach einem bestimmten Paket,
      Font, Programm u.\,ä. sind, empfiehlt sich ein Blick in den \TeX-Catalogue unter \url{http://www.ctan.org/tex-archive/help/Catalogue/catalogue.html}. Dieser Katalog enthält eine Liste aller verfügbaren \TeX-spezifischen Dinge.

\item [\TeX-\acro{WWW}-Ressourcen:] Unter \url{http://tug.org/interest.html} finden Sie eine große Anzahl \TeX-spezifischer Links zu Büchern, Handbüchern und Artikeln zu allen Aspekten des \TeX-Systems.

\item [Archive:] Ein Forum für die Hilfestellung sind die Usenet-News-Gruppen\footnote{Für eine Einführung zum Usenet siehe \url{http://de.wikipedia.org/wiki/Usenet}.}
      \url{news:de.comp.text.tex} (Deutsch), \url{news:comp.text.tex} (Englisch)
      und die Mailing-Liste \email{texhax@tug.org}. 


In deren Archiven finden sich die Fragen und Antworten vieler Jahre. Ihre Suche können Sie in Google
      beispielsweise mit \url{http://groups.google.de/group/de.comp.text.tex/topics}
      starten -- oder auch in \url{http://tug.org/mail-archives/texhax} durchführen.

      Im Allgemeinen ist es recht erfolgversprechend, eine generelle Suche über Google
      \url{http://www.google.de/} durchzuführen (entweder im Internet allgemein
      oder in den o.\,g. News-Gruppen); dies insbesondere, wenn es sich um Fragen über
      \PS/PDF, \cmdname{Ghostscript} u.\,ä. handelt.

\item [Online-Foren:] Neben den bereits genannten Quellen gibt es Foren im Internet, in denen Sie Ihre Frage stellen können: \url{http://tex.stackexchange.com}, \url{http://golatex.de}, \url{http://mrunix.de/forums/forumdisplay.php?f=38} \\ sind nur einige, die Hilfe zu \TeX\ \& \LaTeX\ anbieten.

Auch hier gilt: Je mehr Mühe Sie sich mit dem Stellen von Fragen geben, desto besser kann Ihnen geholfen werden.

\item [Fragen stellen:]
      Wenn Sie mit den oben aufgezeigten Möglichkeiten immer noch keine Antwort auf Ihre Frage gefunden haben, können Sie die Frage auch in einer News-Gruppe stellen (neudeutsch: \emph{posten}). Hier bietet sich für den deutschsprachigen Raum die News-Gruppe \url{news:de.comp.text.tex} an. 
      Benutzen Sie am besten für Anfragen Google 
      (\url{http://groups.google.de/group/de.comp.text.tex/topics})
      oder einen Newsreader. Fragen an die englischsprachige Gruppe
      \url{news:comp.text.tex} 
      (bei Google: \url{http://groups.google.de/group/comp.text.tex/topics}) 
      sollten Sie bitte nur auf Englisch stellen.

      Zusätzlich existieren E-Mail-Listen, wobei hier die deutschsprachige Liste
      \email{TeX-D-L@listserv.dfn.de} zu nennen ist (das englischsprachige Äquivalent 
      ist \email{texhax@tug.org}). Darüber hinaus bietet sich für Mitglieder
      von Dante~e.V. der Beraterkreis an (\email{beraterkreis@dante.de}).
      Wie Sie sich in die E-Mail-Liste \dirname{TeX-D-L} eintragen können,
      finden Sie in der FAQ unter \enquote{1.3.2 Was ist TeX-D-L?}.

      Bevor Sie eine Frage absenden, lesen Sie \emph{bitte} die entsprechenden
      Einträge der FAQ zum Thema \enquote{Wie stelle ich eine Frage in einer
      Newsgroup, damit ich mit hoher Wahrscheinlichkeit eine Antwort bekomme?}, wie 
      z.\,B. \enquote{1.3.1 Was ist 'de.comp.text.tex'?}  und \enquote{1.3.7 Was
      sollte ich gelesen haben, bevor ich eine Frage in 'de.comp.text.tex' oder der
      Diskussionsliste TeX-D-L stelle?}.

\item [Mithilfe:]
      Wenn Sie einen Fehler melden wollen oder Empfehlungen und Kommentare
      zur \TL-Verteilung, -Installation oder -Dokumentation geben möchten, sollten Sie die
      E-Mail-Liste \email{tex-live@tug.org} nutzen. 
      Korrekturen, Anmerkungen und Erweiterungen für die deutsche Übersetzung können Sie auch
      an \email{ziegenhagen@gmail.com} direkt senden.

      Fragen zu Programmen, die Sie in der {\TK} finden, sollten Sie besser auf
      einer der oben genannten Mailing-Listen stellen oder direkt an den Programmautor
      richten.
\end{description}

\noindent Auf der anderen Seite können auch Sie mit Ihrem Wissen helfen. Die News-Gruppen
\url{news:de.comp.text.tex} (in Deutsch), \url{news:comp.text.tex} (in Englisch) und
die Mailing-Liste \email{TeX-D-L@listserv.dfn.de} (Deutsch) und \email{texhax@tug.org} (Englisch)
stehen allen offen. Wenn Sie also dort mitlesen, scheuen Sie sich nicht, Fragen,
zu denen Sie eine Antwort wissen, zu beantworten und damit anderen zu helfen.

Falls Sie auf eine garantierte kommerzielle Unterstützung angewiesen sind oder eine solche
bevorzugen, sollten Sie die Finger komplett vom \TL-System lassen und in der Liste unter \url{http://tug.org/interest.html#vendors} nach einem geeigneten Händler suchen.

\chapter{Überblick zum \TL-System}\label{sec:overview-tl}

In diesem Abschnitt beschreiben wir die Struktur und den Inhalt des \TL-Systems und der \TK-\DVD.

\subsection[Die \protect\TeX\protect\ Collection: \TL, pro\TeX{}t, Mac\TeX]{Die \protect\TeX\protect\ Collection: \TL, pro\TeX{}t, Mac\TeX}\label{sec:tl-coll-dists}

Die \DVD besteht aus:

\begin{description}
\item[\TL] Ein komplettes \TeX-System, wahlweise zur Installation auf einer Festplatte oder einem Wechselmedium (USB-Stick). Die Homepage des \TL-Projektes finden Sie unter \url{http://tug.org/texlive/}.
\item[Mac\TeX] für \MacOSX. Dieses enthält das komplette \TL, bietet zusätzlich aber ein Installationsprogramm für Mac und einige Zusatzprogramme. Nähere Informationen finden Sie auf der Homepage von Mac\TeX{} unter \url{http://tug.org/mactex/}.
\item[pro\TeX{}t] basiert auf der \MIKTEX-Distribution für Windows. Es enthält noch einige Zusatzprogramme und stellt eine einfache Installationsanleitung bereit, die Schritt für Schritt den Weg zu einem kompletten \TeX-System beschreibt. Die Homepage von pro\TeX{}t findet sich unter \url{http://tug.org/protext}. 
\item[CTAN] Weiterhin ist auf der \DVD{} ein Teil der \TeX-bezogenen Software enthalten, die sich
in CTAN, dem \emph{Comprehensive \TeX{} Archive Network} (\url{http://www.ctan.org}) befinden.
\item [\texttt{texmf-extra}] In diesem Verzeichnis befinden sich zusätzliche Pakete, die kein Teil von
\TL sind.
\end{description}

\CTAN{}, \pkgname{protext} und \dirname{texmf-extra} unterliegen nicht denselben Lizenzregeln wie \TL. Daher können für Teile hieraus andere Lizenzbedingungen bezüglich einer Weiterverteilung oder
Modifikation gelten, die Sie unbedingt beachten sollten!

\section{Basisverzeichnisse von \TL}\label{sec:tld}

In diesem Abschnitt beschreiben wir die Basisverzeichnisse einer \TL-Installation.

\begin{center}
\begin{tabular}{rp{0.8\textwidth}}
bin        &  ausführbare Programme des \TeX-Systems. Jeweils für die verschiedenen Rechnerplattformen
              in Unterverzeichnissen zusammengefasst\\
readme-*.dir & in diesen Verzeichnissen (!) befinden sich Text- bzw. HTML-Dateien
              in verschiedenen Sprachen, die als schneller
              Einstieg in \TL empfehlenswert sind.\\
source     &  Quelldateien aller Programme inklusive der
              \Webc-Quellen für die \TeX-Pakete\\
texmf      &  Verzeichnisbaum für Programme mit zugehörigen Hilfsdateien und Anleitungen; enthält keine \TeX-Formate und Pakete (siehe \texttt{TEXMFMAIN} im nächsten Abschnitt).\\
texmf-dist &  Hauptbaum mit Formaten und Paketen (siehe \texttt{TEXMFDIST} im nächsten Abschnitt).\\
tlpkg      &  Skripte, Programme und Daten die für die Installation benutzt werden, sowie einige Dinge, die speziell für Windows benötigt werden.

\end{tabular}
\end{center}

Zusätzlich zu den oben aufgeführten Verzeichnissen finden Sie
im Wurzelverzeichnis der Distribution
auch noch die Installationsskripte.

Wenn Sie nach Dokumentation suchen, bietet Ihnen die Datei \OnCD{doc.html} wichtige Links.
Die Dokumentation für Programme (Handbücher, ">man~pages"<, \acro{GNU}-\acro{info}-Dateien) beispielsweise finden Sie 
im Verzeichnis \OnCD{texmf/doc}. Ähnliches 
gilt für die Dokumentation der \TeX-Pakete und -Formate im Verzeichnis \OnCD{texmf-dist/doc}. 

Benutzen Sie das Programm \cmdname{texdoc}, wenn Sie auf der Suche nach irgendeiner 
Dokumentationsdatei sind. Hilfreich in diesem Zusammenhang könnte auch die Link-Sammlung \filename{doc.html} im Wurzelverzeichnis sein.

Die Anleitung zu \TL ist in verschiedenen Sprachen verfügbar auf der \DVD verfügbar:
\begin{description}
\item[Deutsch:]                \OnCD{texmf/doc/german/texlive-de/texlive-de} (dieses Dokument)
\item[Englisch:]               \OnCD{texmf/doc/english/texlive-en/texlive-en}
\item[Französisch:]            \OnCD{texmf/doc/french/texlive-fr/texlive-fr}
\item[Italienisch:]              \OnCD{texmf/doc/italian/texlive-it/texlive-it}
\item[Polnisch:]               \OnCD{texmf/doc/polish/texlive-pl/texlive-pl}
\item[Russisch:]               \OnCD{texmf/doc/russian/texlive-ru/texlive-ru}
\item[Serbisch:]               \OnCD{texmf/doc/serbian/texlive-sr/texlive-sr}
\item[Tschechisch/Slowakisch:] \OnCD{texmf/doc/czechslovak/texlive-cz/live}
\item[Chinesisch:]             \OnCD{texmf/doc/chinese/texlive-zh-cn/texlive-zh-cn}
\end{description}

\section{Überblick über die vordefinierten texmf-Bäume}\label{sec:texmftrees}


Dieser Abschnitt listet die vordefinierten texmf-Bäume, die vom System benutzt
werden, und deren Bedeutung auf. Das Kommando \texttt{tlmgr~conf}
zeigt Ihnen die aktuellen Einstellungen dieser Variablen an.

\begin{description}
\item [TEXMFMAIN] In diesem Baum befinden sich wichtige Teile des Systems,
  wie Konfigurationsdateien, Hilfsprogramme und die Dokumentation.
\item [TEXMFDIST] In diesem Baum befinden sich die wesentlichen Makro-Pakete,
  Fonts usw. Dieser Baum enthält systemunabhängige Daten, die prinzipiell
  von jedem TDS-kompatiblem \TeX-System nutzbar sein sollten.
\item [TEXMFLOCAL] Dieser Baum ist für Ergänzungen oder Aktualisierungen
  von Makros, Fonts etc. gedacht, die Administratoren für alle Nutzer
  installieren.
\item [TEXMFHOME] In diesem Baum können einzelne Nutzer Ergänzungen oder
  Aktualisierungen von Makros, Fonts etc. ablegen. Standardmäßig befindet
  sich dieser Baum unterhalb von \verb+$HOME+, so dass andere Nutzer von
  Änderungen hier nicht beeinflusst werden.
\item [TEXMFCONFIG] Dieser benutzerspezifische (!) Baum wird von den Hilfsprogrammen von \TeX{}
  wie \verb+texconfig+, \verb+updmap+ und \verb+fmtutil+ verwendet.
  Standardmäßig befindet sich dieser Baum unterhalb von \verb+$HOME+,
  so dass andere Nutzer von Änderungen hier nicht beeinflusst werden.
\item [TEXMFSYSCONFIG] Systemweiter Baum, wird von den Hilfsprogrammen
  \verb+texconfig-sys+, \verb+updmap-sys+ und \verb+fmtutil-sys+
  verwendet, so dass hier das Verhalten des \TL-Systems für alle Nutzer
  beeinflusst werden kann.
\item [TEXMFSYSVAR] Dieser Baum wird von den systemweiten Hilfsprogrammen
  wie \verb+texconfig-sys+, \verb+updmap-sys+ und \verb+fmtutil-sys+
  verwendet, um automatisch generierte Konfigurations-Dateien abzulegen.
\item [TEXMFVAR] Dieser benutzerspezifische Baum wird von Hilfsprogrammen wie \verb+texconfig+,
  \verb+updmap+ und \verb+fmtutil+ benutzt, um automatisch generierte
  Konfigurations-Dateien abzulegen.
\item [TEXMFCACHE] Dieser Baum wird von \ConTeXt\ Mk\acro{IV} genutzt, um Cache-Daten abzulegen.
\end{description}

Der Standard der Verzeichnisstruktur von \TL sieht wie folgt aus:
\begin{description}
  \item[Systemweites Wurzelverzeichnis] kann \TL{}-Versionen aus mehreren Jahren beinhalten:
  \begin{description}
    \item[2011] Eine Vorversion von \TL.
    \item[2012] Die aktuelle Version.
    \begin{description}
      \item [bin] ~
      \begin{description}
        \item [i386-linux] \GNU/Linux binaries
        \item [...]
        \item [universal-darwin] \MacOSX\ binaries
        \item [win32] Windows binaries
      \end{description}
      \item [texmf\ \ \ \ \ \ \ ] Hierauf verweist \envname{TEXMFMAIN}.
      \item [texmf-dist\ \ ] \envname{TEXMFDIST}
      \item [texmf-var\ \ ] \envname{TEXMFSYSVAR}
      \item [texmf-config \ \ ] \envname{TEXMFSYSCONFIG}
    \end{description}
    \item [texmf-local] \envname{TEXMFLOCAL}, dieses Verzeichnis gilt für alle installierten \TL-Versionen
         (aktuelle Version und Vorgängerversion), so dass hier durchgeführte lokale Änderungen über die
         Jahre hinweg erhalten bleiben.
  \end{description}
  \item[Home-Verzeichnis des Benutzers]
      (\texttt{\$HOME} oder \texttt{\%USERPROFILE\%}):
    \begin{description}
      \item[.texlive2011] Vom Nutzer privat erzeugte Dateien und Konfigurationsdaten
        der Vorversion.
      \item[.texlive2012] Vom Nutzer privat erzeugte Dateien und Konfigurationsdaten
        für die aktuelle Version von \TL.
      \begin{description}
        \item [texmf-var\ \ \ ] \envname{TEXMFVAR}
        \item [texmf-config] \envname{TEXMFCONFIG}
      \end{description}
    \item[texmf] \envname{TEXMFHOME} Persönliche Makros, Fonts usw. des Nutzers.
  \end{description}
\end{description}


\section{\TeX\ Erweiterungen}\label{sec:tex-extensions}


Unter den \TeX-Systemen der {\TL} befinden sich verschiedene
\TeX"=Erweiterungen:

\begin{description}
\item [\eTeX]\label{text:etex} stellt bei 100\%-iger Kompatibilität zum
      ursprünglichen {\TeX} einen kleinen, aber mächtigen Satz neuer Befehle
      bereit (für Makroexpansion, Character-Scanning, erweiterte Debug-Möglichkeiten u.\,a.).
      Zusätzlich gibt es noch die \TeXXeT-Erweiterungen für den bidirektionalen Textsatz, 
      wie er beispielsweise im Arabischen gebraucht wird.
      Im voreingestellten Modus ist {\eTeX} 100\%-ig kompatibel mit dem ">normalen"< \TeX.
      Die Dokumentation zu {\eTeX} finden Sie in der Datei
      \OnCD{texmf-dist/doc/etex/base/etex\textunderscore man.pdf}.
\item [pdf\TeX] enthält die \eTeX\ Erweiterungen und erlaubt -- neben der Ausgabe in PDF-Dateien -- auch die Erstellung von DVI-Dateien.  Für die meisten \TeX-Formate (wie \prog{etex}, \prog{latex}, \prog{pdflatex}) wird tatsächlich pdf\TeX\ aufgerufen. Die Webseite von pdf\TeX\ lautet
      \url{http://www.pdftex.org}.
      
Die Dokumentation zu pdf\TeX{} finden Sie unter  \OnCD{texmf-dist/doc/pdftex/ manual/pdftex-a.pdf}. 

\item [Lua\TeX] befindet sich noch in Entwicklung und ist als zukünftiger Nachfolger von pdf\TeX\ vorgesehen, zu dem es weitgehend abwärtskompatibel bleiben soll. Weiterhin soll es auch Aleph\footnote{\url{http://en.wikipedia.org/wiki/Omega_(TeX)}} ersetzen, auch wenn es nicht kompatibel dazu sein wird. Durch den enthaltenen Lua-Interpreter (siehe \url{http://www.lua.org/})
können satztechnische Herausforderungen, die in \TeX{} selbst nur mühsam lösbar sind, einfach und elegant gelöst werden.

Wird es unter dem Namen \filename{texlua} aufgerufen, verhält es sich wie ein eigenständiger Lua-Interpreter -- und wird als solcher in vielen Skripten von \TL bereits benutzt. Für weitere Informationen siehe \url{http://www.luatex.org} und \OnCD{texmf-dist/doc/luatex/luatexref-t.pdf}.

\item [XeTeX] bietet die Unterstützung von Unicode-Zeichensätzen und Open\-Type-Schriften, mehr Informationen sind unter \url{http://tug.org/xetex} verfügbar.

\item [OMEGA] (Omega) ist ein \TeX-System, das intern mit Unicode (16-Bit"=Unicode"=Zeichen) arbeitet und damit das gleichzeitige Arbeiten mit nahezu allen auf der Welt eingesetzten Schriften
      und deren Zeichenkodierungen erlaubt. Außerdem werden über dynamisch
      geladene, sogenannte \enquote{OMEGA~Translation~Processes} Transformationen zur Verfügung gestellt, die beliebige Eingaben vor der Bearbeitung durch {\TeX} nach bestimmten Regeln
      umformen. Omega ist nicht länger als eigenständiges Programm Teil von \TL; es wird nur noch Aleph mitgeliefert.

\item [$\aleph$] (Aleph) vereinigt die OMEGA- und \eTeX-Erweiterungen.  Eine Minimaldokumentation finden Sie in \OnCD{texmf-dist/doc/aleph/base}.
\end{description}

\section{Weitere Programme von \TL}

\TL enthält eine ganze Reihe unterstützender Programme wie


\begin{description}
\item[\cmdname{bibtex}, \cmdname{bibtex8}]   zum Verwalten von Bibliographien                  
\item[\cmdname{biber}], zum Verwalten von Bibliographien, soll \cmdname{bibtex} ablösen
\item[\cmdname{dviconcat}]      Zusammenfügen von DVI-Dateien                 
\item[\cmdname{dvips}]          Konversion von DVI in {\PS}     
\item[\cmdname{dviselect}]     Ausschneiden von Seiten aus DVI-Dateien       
\item[\cmdname{dvipdfmx}]       DVI-nach-PDF-Konverter (erzeugt auch \acro{CJK}-konformes PDF aus
               DVI-Dateien mit OMEGA Erweiterungen)
\item[\cmdname{dvilj}]          Druckertreiber für die HP-LaserJet"=Familie    
\item[\cmdname{makeindex}, \cmdname{xindy}] Erzeugen eines Stichwortverzeichnisses         
\item[\cmdname{mpost}]          \MF-ähnliches Grafikprogramm                   
\item[\cmdname{psnup}, \cmdname{psselect}]          \PS-Tools
\item[\cmdname{pdfjam}, \cmdname{pdfjoin}]          \acro{PDF}-Tools
\item[\cmdname{tex4ht}]         \TeX-nach-\HTML-Konvertierung                
\item[\cmdname{texexec, texmfstart}]  \ConTeXt- und PDF"=Prozessor               
\item[\cmdname{xdvi}]           DVI-Bildschirmausgabe im X-Window-System      
\end{description}

\section{Fonts in \TL}\label{sec:tl-fonts}

\TL enthält eine Vielzahl qualitativ hochwertiger Vektorschriften. Weitere Informationen hierzu finden sich unter \url{http://tug.org/fonts} und auf dieser DVD unter \OnCD{texmf-dist/doc/fonts/free-math-font-survey/survey}.

\chapter{Installation von \TL}\label{sec:install}

\section{Das Installationsprogramm}\label{sec:inst-start}

Zur Installation von \TL benötigen Sie die \TK-\DVD oder den \enquote{\TL{} Net Installer} aus dem Internet.

\begin{description}
\item [Net Installer:] Verfügbar von \CTAN, unter
\dirname{systems/texlive/tlnet}; die URL
\url{http://mirror.ctan.org/systems/texlive/tlnet} leitet Sie automatisch
an einen nahe gelegenen Server des \CTAN-Netzwerks weiter.
Sie können entweder die Datei \filename{install-tl.zip} herunter laden,
die sowohl für Unix als auch Windows gedacht ist,
oder die deutlich kleinere Datei \filename{install-unx.tar.gz},
die aber nur den Installer für Unix enthält.
Nach dem Auspacken finden Sie die Dateien \filename{install-tl} (Unix)
bzw.\ \filename{install-tl.bat} (Windows) im Verzeichnis \dirname{install-tl}.

\item [\TeX{} Collection \DVD:] Hier finden Sie die Dateien \filename{install-tl} (Unix)
bzw.\  unter Windows \filename{install-tl.bat} im Verzeichnis \dirname{texlive}
der \DVD. Unter Windows startet beim Einlegen der DVD im Allgemeinen automatisch 
ein Programm, bei dem Sie unter anderem das Installationsprogramm von \TL auswählen können.  Die \DVD\ erhalten Sie als Mitglied eines \TeX-Vereins (wie \url{http://www.dante.de} für den deutschsprachigen Raum, von der Fachbuchhandlung Lehmanns (\url{http://www.lob.de}) oder international von der \TeX{} Users Group (\url{http://tug.org/store}). 

Alternativ können Sie das \ISO-Image der \TL aus dem Internet laden. Nach der Installation von der DVD sollten Sie die Internet-Aktualisierung aktivieren, für Details siehe Abschnitt \ref{sec:dvd-install-net-updates}.
\end{description}

Egal welche Quelle verwendet wird, es wird der gleiche Installer genutzt. Der hauptsächliche Unterschied ist, dass man bei der Verwendung des Net-Installers die neuesten verfügbaren Pakete direkt aus dem Internet erhält. Bei der Verwendung von \DVD\ and \ISO\ Images erhält man den Stand des letzten Major Release. Zwischen zwei Major Releases gibt es keine Aktualisierung der \DVD\ oder \ISO\ Images.

Die folgenden Abschnitte beschreiben die Installation für die einzelnen Betriebssysteme.

\section{Unix}

Im Folgenden werden die Eingaben des Benutzers nach dem Kommando-Prompt \samp{>} \Ucom{fett} dargestellt.

Das Skript \filename{install-tl} ist ein Perl-Skript. Am Einfachsten starten
Sie es auf einem Unix-System in der Kommandozeile mit
\begin{alltt}
> \Ucom{cd /pfad/zum/installer}
> \Ucom{perl install-tl}
\end{alltt}

(Sie können auch direkt \Ucom{perl /pfad/zum/installer/install-tl} eingeben. Wenn Ihre \DVD so gemountet ist, dass als ausführbar gekennzeichnete Skripte direkt gestartet werden können, können Sie im Verzeichnis des Installers auch direkt \Ucom{./install-tl} eingeben.) Eventuell müssen Sie Ihr Terminalfenster
größer machen, damit Sie den kompletten Text sehen (Abb.~\ref{fig:text-main})

Zum Installieren mit Hilfe einer Benutzeroberfläche (Abb.~\ref{fig:gui-main}) verwenden Sie

\begin{alltt}
> \Ucom{perl install-tl -gui}
\end{alltt}

Hierfür muss das \dirname{Perl/TK}-Modul mit \acro{XFT}-Unterstützung (diese ist bei \GNU/Linux in der Regel mit einkompiliert) auf Ihrem System installiert sein.

Alle Optionen des Installationsprogramms werden mit
\begin{alltt}
> \Ucom{perl install-tl -help}
\end{alltt}
angezeigt.

\textbf{Wichtiger Hinweis zu den Zugriffsrechten unter Unix:} Ihre aktuelle Einstellung von \code{umask} wird bei der Installation von \TL berücksichtigt.  Daher müssen Sie darauf achten, dass Sie hierfür einen sinnvollen Wert einstellen (z.\,B. \code{umask002}), wenn Ihre Installation auch durch andere Nutzer als Sie benutzt werden soll. Falls Sie unsicher sind, was dies bedeutet, schauen Sie bitte in die Anleitung zu \code{umask} (indem Sie das Kommando \code{man umask} eingeben oder im Internet danach suchen).

\textbf{Besonderheit bei Cygwin:} Im Gegensatz zu anderen Unix-basierten
Systemen fehlen bei Cygwin im Allgemeinen einige Programme, die vom Installationsprogramm von \TL vorausgesetzt werden. Bitte lesen Sie den Abschnitt \ref{sec:cygwin}.


\section{MacOSX}

Wie in Abschnitt~\ref{sec:tl-coll-dists} bereits erwähnt wurde, existiert mit Mac\TeX{} (\url{http://tug.org/mactex}) ein eigenes \TeX-System für \MacOSX. Dieses enthält ein komplettes \TL mit einem Installationsprogramm, das in Funktionalität und Aussehen  der üblichen Installation von Software unter \MacOSX\ entspricht. Weiterhin sind einige Zusatzprogramme enthalten.

Wenn Sie die \TK-\DVD besitzen, empfiehlt es sich daher, Mac\TeX{} zu verwenden.

\section{Windows}

Wenn Sie den \emph{Net Installer} verwenden, oder auf Ihrem System beim Einlegen der \DVD das Installationsprogramm nicht automatisch gestartet wurde, können Sie die Installation von \TL im Windows-Explorer durch einen Doppelklick auf \filename{install-tl.bat} (auf der \DVD befindet sich diese Datei im Verzeichnis \texttt{texlive}) starten.

Falls Sie bei der Installation mehr Optionen benötigen (z.\,B. die Auswahl
spezifischer Paketgruppen), starten Sie stattdessen \filename{install-tl-advanced.bat}.

Alternativ können Sie eine cmd-Eingabeaufforderung verwenden, dort in das Verzeichnis wechseln, in dem sich das Installationsprogramm befindet und 

\begin{alltt}
D:\bs{}texlive\bs{}> \Ucom{install-tl}
\end{alltt}

eingeben -- \texttt{...>} kennzeichnet hierbei den Eingabeprompt. Ihre Eingabe ist \Ucom{\texttt{bold/fett}} dargestellt.

Alternativ können Sie die Installation auch aus einem beliebigen Verzeichnis heraus starten:

\begin{alltt}
> \Ucom{D:\bs{}texlive\bs{}install-tl}
\end{alltt}

wobei wir hier annehmen, dass sich ihre \TK-\DVD im Laufwerk D: befindet.
Abb.~\ref{fig:wizard-w32} zeigt das grafische Installationsprogramm im
">wizard mode"<, das unter Windows standardmäßig verwendet wird.

Zur Installation im Textmodus verwenden Sie:
\begin{alltt}
> \Ucom{install-tl -no-gui}
\end{alltt}

\noindent Alle vorhandenen Optionen, die beim Starten des Installationsprogramms verwendet werden können, werden
wie folgt angezeigt:

\begin{alltt}
> \Ucom{install-tl -help}
\end{alltt}

\begin{figure}[tb]
\begin{boxedverbatim}
Installing TeX Live 2012 from: ...
Platform: i386-linux => 'Intel x86 with GNU/Linux'
Distribution: inst (compressed)
...
 Detected platform: Intel x86 with GNU/Linux

 <B> platforms: 1 out of 19

 <S> installation scheme (scheme-full)
     84 collections out of 85, disk space required: 3091 MB

 Customizing installation scheme:
   <C> standard collections
   <L> language collections

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

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

 <V>  set up for portable installation 

Actions:
 <I> start installation to hard disk
 <H> help
 <Q> quit
\end{boxedverbatim}
\caption{Hauptmenü des Installationsprogramms (\GNU/Linux).}\label{fig:text-main}
\end{figure}

\begin{figure}[tb]
\includegraphics[width={\linewidth}]{install-lnx-main}
\caption{Grafische Installation im Expertenmodus (\GNU/Linux).}\label{fig:gui-main}
\end{figure}

\begin{figure}[tb]
\includegraphics[width={\linewidth}]{wizard-w32}
\caption{Wizard mode (Windows)}\label{fig:wizard-w32}
\end{figure}

\section{Cygwin}\label{sec:cygwin}

Das Installationsskript von \TL\ unterstützt nur Version~1.7 von Cygwin.
Bevor Sie mit der Installation von \TL\ beginnen, verwenden Sie das
Installationsprogramm von Cygwin (\filename{setup.exe}) um die Pakete
\filename{perl} und \filename{wget} gegebenenfalls nachzuinstallieren.
Wir empfehlen weiterhin die Installation folgender Cygwin-Pakete:

\begin{description}
\item[fontconfig] für \XeTeX
\item[ghostscript] wird von verschiedenen Teilen von \TL\ benötigt
\item[libXaw7] für \code{xdvi}
\item[ncurses] damit der 'clear'-Befehl im Installer funktioniert
\end{description}

\section{Installation im Textmodus}

Abb.~\ref{fig:text-main} zeigt den Eingangsbildschirm des Installationsprogramms im Textmodus (Standard unter Unix). Dieser ist ein reiner Textmodus, was zur Folge hatt dass es keine Unterstützung zum Wandern durch die einzelnen Menüpunkte mit den Cursor-Tasten gibt. Alle Befehle wie zum Beispiel die Auswahl von Menüpunkten werden durch Eingabe der entsprechenden Befehle bzw.\ Menükürzel über die Tastatur eingegeben und dann durch Drücken von \emph{Enter} übernommen. Hierbei wird zwischen Groß- und Kleinschreibung unterschieden!

Die Installation im Textmodus ist so spartanisch, weil dieser Modus überall funktionieren soll, selbst mit einer Basisinstallation von Perl (für Windows enthält\TL\ eine Minimalversion von Perl).

\section{Installation mit Benutzeroberfläche im Expertenmodus}

Abb.~\ref{fig:gui-main} zeigt die grafische Installation im Expertenmodus
unter GNU/Linux. Funktionell unterscheided sich dieser nicht wesentlich
vom Textmodus, außer dass natürlich mit
Menüs, Auswahlboxen etc. gearbeitet wird.

Dieser Modus muss explizit mit
\begin{alltt}
> \Ucom{install-tl -gui=perltk}
\end{alltt}
gestartet werden.


\section{Installation mit einfacher Benutzeroberfläche (wizard mode)}

Unter Windows wird automatisch diese einfache Form der Installation verwendet,
der so genannte ">wizard mode"< (Abb.~\ref{fig:wizard-w32}). Dieser zeichnet sich dadurch aus, dass er \TL\ komplett installiert und dabei vom Benutzer nur wenige Angaben gemacht werden müssen. Falls Sie eine individuell angepasste Version von \TL\ benötigen, verwenden Sie daher bitte einen der beiden anderen Installationsmodi.

Um die Installation explizit im ">wizard mode"< zu starten (insbesondere unter
Unix), verwenden Sie:
\begin{alltt}
> \Ucom{install-tl -gui=wizard}
\end{alltt}


\section{Benutzung des Installationsprogramms}\label{sec:runinstall}

Das Installationsprogramm sollte (wenn Sie die vorherigen Abschnitte zum Aufbau von \TL und der verwendeten Verzeichnisstruktur gelesen haben) weitgehend selbsterklärend sein. Trotzdem wollen wir auf einige Punkte näher eingehen.


\section{Auswahl der Binaries (nur für Unix)}\label{sec:binary}


\begin{figure}[tb]
\begin{boxedverbatim}
Available platforms:
===============================================================================
   a [ ] alpha-linux      DEC Alpha with GNU/Linux
   b [ ] amd64-freebsd    x86_64 with FreeBSD
   c [ ] amd64-kfreebsd   x86_64 with GNU/kFreeBSD
   d [ ] armel-linux      ARM with GNU/Linux
   e [ ] i386-cygwin      Intel x86 with Cygwin
   f [ ] i386-freebsd     Intel x86 with FreeBSD
   g [ ] i386-kfreebsd    Intel x86 with GNU/kFreeBSD
   h [X] i386-linux       Intel x86 with GNU/Linux
   i [ ] i386-solaris     Intel x86 with Solaris
   j [ ] mips-irix        SGI IRIX
   k [ ] mipsel-linux     mipsel with Linux
   l [ ] powerpc-aix      PowerPC with AIX
   m [ ] powerpc-linux    PowerPC with GNU/Linux
   o [ ] sparc-solaris    Sparc with Solaris
   p [ ] universal-darwin universal binaries for MacOSX/Darwin
   s [ ] win32            Windows
   t [ ] x86_64-darwin    x86_64 with MacOSX/Darwin
   u [ ] x86_64-linux     x86_64 with GNU/Linux
   v [ ] x86_64-solaris   x86_64 with Solaris
\end{boxedverbatim}
\caption{Auswahlmenü für Binaries}\label{fig:bin-text}
\end{figure}

\noindent Abb.~\ref{fig:bin-text} zeigt das Auswahlmenü für die Binaries der einzelnen Betriebssysteme im Textmodus. Im Allgemeinen sollte hier schon das richtige System ausgewählt sein. Sie können aber problemlos Binaries
für verschiedene Systeme parallel auswählen. Dies bietet sich an, wenn Ihre Installation auf verschiedenen Rechnern in einem heterogenen Netzwerk sichtbar ist und von dort aus benutzt werden soll.

\section{Auswahl der zu installierenden Komponenten}\label{sec:components}

\begin{figure}[tbh]
\begin{boxedverbatim}
Select a scheme:
===============================================================================
 a [X] full scheme (everything)
 b [ ] medium scheme (small + more packages and languages)
 c [ ] small scheme (basic + xetex, metapost, a few languages)
 d [ ] basic scheme (plain and latex)
 e [ ] minimal scheme (plain only)
 f [ ] ConTeXt scheme
 g [ ] GUST TeX Live scheme
 h [ ] teTeX scheme (more than medium, but nowhere near full)
 i [ ] XML scheme
 j [ ] custom selection of collections
\end{boxedverbatim}
\caption{Menü zur Auswahl des Schemas}\label{fig:scheme-text}
\end{figure}


\noindent Abb.~\ref{fig:scheme-text} zeigt das Auswahlmenü für ein grundsätzliches Installationsschema der
\TL. Durch die Auswahl eines Schemas werden automatisch die Komponenten zur Installation ausgewählt, die
für das gewünschte Schema notwendig bzw.\ sinnvoll sind. Mit einer vollständigen Installation von \TL
(\emph{full scheme}) sind Sie auf der sicheren Seite, da hier einfach alles installiert wird. Sie können
aber auch eines der abgespeckten Schemas wie \emph{basic} (für ein sehr schlankes System), \emph{medium}
oder \emph{minimal} (dies empfiehlt sich aber nur für Testsysteme und weniger zum ernsthaften Arbeiten)
auswählen. Weiter stehen einige Schemas für spezielle Zwecke oder Sprachen zur Verfügung.

\begin{figure}[tb]
\includegraphics[width=.7\linewidth]{stdcoll}
\caption{Menü zur Aus- oder Abwahl von Collections.}\label{fig:collections-gui}
\end{figure}

Wenn Sie das Schema ausgewählt haben, können Sie dieses in den Menüpunkten \emph{standard collections} und
\emph{language collections} (s.\,Abb.~\ref{fig:collections-gui}, diesmal zur Abwechslung im GUI-Modus)
individuell nach Ihren Wünschen anpassen.

Während das Schema nur den grundlegenden Funktionsumfang vorgibt, ist die Auswahl von Komponenten auf der
Ebene der \emph{Collections} viel feiner. Eine Collection besteht dabei aus mehreren Paketen zu einem Thema,
wobei jedes der Pakete aus bestimmten Makrodateien, Fontdateien usw. bestehen kann.

Noch mehr Kontrolle über die Komponenten Ihres Systems haben Sie nach der Installation mit dem \TeX\ Live Manager (\prog{tlmgr}), das in Abschnitt~\ref{sec:tlmgr} beschrieben wird. Hier können Sie gezielt einzelne
Pakete installieren oder entfernen.

\section{Verzeichnisse}\label{sec:directories}


Die Verzeichnisstruktur von \TL wurde bereits im Abschnitt~\ref{sec:texmftrees} auf S.~\pageref{sec:texmftrees}
beschrieben. Als Wurzelverzeichnis für \TL (\dirname{TEXDIR}) wird unter Windows
(|%SystemDrive%\texlive\2012|) und unter Unix (\dirname{/usr/local/texlive/2012}) angenommen. 

Prinzipiell können Sie diesen Pfad problemlos ändern, z.\,B. wenn Sie \TL als normaler Nutzer installieren
wollen und kein Schreibrecht in dem oben angegebenen Verzeichnis besitzen.

Auf Wunsch können Sie \TL also auch in Ihrem Home-Verzeichnis installieren, wenn Sie sowieso der einzige
Verwender von \TL sind. Für Ihr Home-Verzeichnis können Sie den Pfad ">|~|"< verwenden und so
beispielsweise \TL nach  |~/texlive/2012| installieren.

Wir empfehlen Ihnen, die Jahreszahl im Verzeichnisnamen beizubehalten. So können Sie von Jahr zu Jahr
einfach die neue Version testen, ohne die alte zu entsorgen. Bei Bedarf können Sie einen symbolischen
Link (z.B. \dirname{/usr/local/texlive-cur}) verwenden, der jeweils auf das Verzeichnis der aktuellen
Version von \TL verweist.

Wenn Sie die Einstellung \dirname{TEXDIR} im Installationsprogramm ändern, werden die Werte für
\dirname{TEXMFLOCAL}, \dirname{TEXMFSYSVAR} und
\dirname{TEXMFSYSCONFIG} automatisch angepasst.

Das als \dirname{TEXMFHOME} bezeichnete Verzeichnis ist der Ort, in dem persönliche Makrodateien,
Schriften o.\,ä. abgelegt werden können. Vorgabewert ist |~/texmf|. Im Gegensatz zu \dirname{TEXDIR}
wird |~| hier nicht direkt zum Pfad des Home-Verzeichnisses aufgelöst, sondern unverändert in die
Konfigurationsdateien von \TL übernommen und erst zur Laufzeit aufgelöst. Somit kann jeder Nutzer
des Systems seinen komplett eigenen Pfad haben, der von \TL verwendet wird, und so nach Wunsch auch
eigene Konfigurationsänderungen durchführen.
Zur Laufzeit wird |~| unter Unix durch \dirname{\$HOME} und unter Windows durch \verb|%USERPROFILE%| ersetzt.

Die Variable \dirname{TEXMFVAR} verweist auf das Verzeichnis mit benutzerspezifisch
erzeugten Konfigurationsdateien, z.\,B. den Konfigurations-Cache von \ConTeXt\ Mk\acro{IV}.



\section{Optionen}\label{sec:options}


\begin{figure}[tbh]
\begin{boxedverbatim}
 <P> use letter size instead of A4 by default: [ ]
 <E> execution of restricted list of programs: [X]
 <F> create format files:                      [X]
 <D> install font/macro doc tree:              [X]
 <S> install font/macro source tree:           [X]
 <L> create symlinks in standard directories:  [ ]
           binaries to:
           manpages to:
               info to:
 <Y> after installation, get package updates from CTAN: [X]
\end{boxedverbatim}
\caption{Auswahlmenü für weitere Optionen (Unix).}\label{fig:options-text}
\end{figure}

\noindent Abb.~\ref{fig:options-text} zeigt das Menü, in dem weitere Einstellungen für die Installation von
\TL möglich sind. Zur Erläuterung:
\begin{description}
\item[use letter size instead of A4 by default:] Verwendung von Letter anstatt DIN\,A4 als
Standard\-papier\-größe. Natürlich können Sie später unabhängig davon für einzelne Dokumente eine
beliebige Papiergröße wählen.

\item[execution of restricted list of programs:] Ab \TL\ 2011 können bei einem
\TeX-Lauf standardmäßig einige externe Programme aufgerufen werden. Die (kurze) 
Liste der erlaubten Programme wird in der Datei \filename{texmf.cnf} definiert.
Für weitere Informationen siehe Abschnitt~\ref{sec:2011news} über Neuerungen in 
\TL\ 2011.

\item[create format files:] Auch wenn das Erzeugen von Formatdateien für Makropakete, die Sie gar
  nicht benötigen, Zeit und Platz kostet, empfehlen wir trotzdem, diese Option ausgewählt zu belassen.
  Falls Sie diese Option abwählen, werden Formatdateien jeweils bei Bedarf erzeugt, und dann
  im persönlichen \dirname{TEXMFVAR}-Baum des aktuellen Benutzers abgelegt. Dort liegende Formate werden allerdings
  nicht automatisch neu generiert, wenn z.\,B. Programme oder Silbentrennmuster aktualisiert werden, so dass
  im Extremfall nach einem Update Inkompatibilitäten entstehen können.

\item[install font/macro \ldots\ tree:] Mit dieser Option können Sie
 verhindern, dass die Dokumentation und die Quelldateien der Pakete
 installiert werden. Wir raten aber, die Vorgabe zu übernehmen, also
 die Dokumentation und Quelldateien zu installieren.

\item[create symlinks in standard directories] (nur unter Unix):
  Mit dieser Option können Sie symbolische Links für Programme und Dokumentation in den Standard\-verzeichnissen
  Ihres Systems anlegen, so dass Sie Ihre Umgebungsvariablen \envname{PATH}, \envname{MANPATH} und    
  \envname{INFOPATH} nicht anpassen müssen. Natürlich benötigen Sie für diese Option Schreibrechte in
  den entsprechenden Verzeichnissen. Hinweis: Diese Option ist nicht dazu gedacht, ein vorhandenes \TeX-System, das
  z.\,B. als Teil Ihrer Linux-Distribution installiert wurde, zu überschreiben! Sie dient vielmehr dazu, 
  dass Links in Verzeichnissen angelegt werden, wo die Nutzer sie erwarten -- beispielsweise in   
  \dirname{/usr/local/bin} --, aber sich dort noch keine \TeX-Programme befinden.

\item[after installation \dots{} CTAN:] Diese Option ist bei der Installation von DVD standardmäßig gesetzt. Sie sorgt dafür, dass nach der Installation Paket-Ak\-tuali\-sie\-rungen aus dem Internet geladen werden. Es gibt nur einen sinnvollen Grund, diese Option nicht zu aktivieren: wenn nur ein Untermenge von \TL\ installiert wurde und Pakete nach der Installation manuell hinzugefügt werden sollen.

\end{description}

\noindent Wenn Sie alle gewünschten Einstellungen für die Installation vorgenommen haben, können Sie im Hauptmenü nun ">I"< eintippen, um diese zu starten. Lesen Sie dann anschließend Abschnitt~\ref{sec:postinstall} für
eventuell notwendige Arbeiten zum Abschluss der Installation.

\section{Kommandozeilenoptionen für die Installation}\label{sec:cmdline}


Nach Eingabe von
\begin{alltt}
> \Ucom{install-tl -help}
\end{alltt}
erhalten Sie eine Liste der vorhanden Kommando\-zeilen\-optionen.  Sie können diese entweder mit |-| oder |--|
verwenden. Die wichtigsten sind:

\begin{description}
\item[-gui] Installation im grafischen Modus. Hierfür muss unter Unix Perl/Tk (mit \acro{XFT}-Unterstützung) installiert sein 
  (\url{http://tug.org/texlive/distro.html#perltk}). Falls dies nicht der Fall ist, wird die Installation
  im Textmodus durchgeführt.

\item[-no-gui] Installation im Textmodus. Da dies unter Unix Standard ist, wirkt sich diese Option nur
  unter Windows aus. Da die Installation zum Benutzen von \TL direkt von \DVD im grafischen Modus nicht
  verfügbar ist, brauchen Sie in diesem Fall unbedingt den Textmodus.

\item[-lang {\sl LL}] Sprache des Installationsprogramms als Sprach-Code in zwei Buchstaben (\textsl{LL}).
  Derzeit werden unterstützt. Das Installationsprogramm versucht, die gewünschte Sprache anhand des
  Systems herauszufinden. Falls dies scheitert oder die betreffende Sprache nicht verfügbar ist, wird als
  Fallback-Sprache Englisch genutzt.

\item[-in-place] Sollten Sie schon ein rsync, svn, oder eine andere Kopie von 
  \TL{} haben (siehe \url{http://tug.org/texlive/acquire-mirror.html}), dann wird diese Option genau das nutzen, was Sie schon haben und nur die notwendigen post-install Operationen durchführen. Eine Warnung: Die Datei \filename{tlpkg/texlive.tlpdb} kann dadurch überschrieben werden; machen Sie vorher gegebenenfalls eine Sicherheitskopie. Die Entfernung von Paketen muss auch manuell vorgenommen werden. 
	
Diese Option kann nicht über die Installer-Schnittstelle gesetzt werden.

\item[-portable] Die Option \code{-portable} (\code{V} im Text-Installer oder die entsprechende Option im grafischen Installer);  dient der Installation auf einem USB-Stick oder einer DVD-R. Siehe Abschnitt \ref{sec:portable-tl} für Informationen über die portable Installation von \TL.

\item[-profile {\sl profile}] Das Installationsprogramm schreibt die ausgewählten Optionen in eine Datei
  \filename{texlive.profile}. Mit dieser Option können
  Sie eine bereits vorhandene Datei bei der Installation weiter verwenden, z.\,B. wenn Sie äquivalente
  Installationen auf mehreren Rechnern realisieren wollen, ohne alle Auswahlschritte der Installation immer
  wieder neu durchführen zu müssen.

\item [-repository {\sl url/path}] zur Auswahl einer Installationsquelle,
  für weitere Erläuterung siehe den nächsten Abschnitt.
\end{description}


\section{Die Option repository}\label{sec:location}


Als Standardquelle für die Installation wird ein \CTAN-Knoten verwendet, der automatisch von \url{http://mirror.ctan.org} ermittelt wird.

Falls Sie eine andere Installationsquelle verwenden wollen, geben Sie eine neue Quelle an, die entweder mit \texttt{ftp:}, \texttt{http:} oder \texttt{file:/} beginnt oder ein Verzeichnispfad auf Ihrem System ist.
Falls Sie \texttt{http:} oder \texttt{ftp:} verwenden, werden ">\texttt{/}"<-Zeichen am Ende ignoriert.

Sie können also z.\,B. einen bestimmten \CTAN-Knoten auswählen, so etwa
\url{http://ctan.example.org/tex-archive/systems/texlive/tlnet/},
wobei Sie natürlich statt |ctan.example.org| einen echten Servernamen
verwenden und wahrscheinlich auch den Rest der URL anpassen müssen.
Eine Auflistung von \CTAN-Servern finden Sie unter \url{http://ctan.org/mirrors}.

Falls Sie ein lokales Repository verwenden (also entweder direkt einen
Verzeichnispfad oder eine mit \texttt{file:/}-URL angeben), so werden
bevorzugt Archivdateien in einem Unterverzeichnis \dirname{archive} des
Repository verwendet, selbst wenn ausgepackte Dateien vorhanden sind.

\section{Aufgaben im Anschluss an die Installation}\label{sec:postinstall}

Je nach System kann es notwendig sein, dass im Anschluss an die Installation noch einige Kleinigkeiten erledigt werden müssen.

\subsection{Windows}

Benutzer von Windows sind hier in der glücklichen Position, dass das Installationsprogramm alles komplett erledigt haben sollte.

\subsection{Unix, falls symbolische Links angelegt wurden}

Wenn Sie bei der Installation angegeben haben, dass und wo symbolische Links angelegt werden sollten (s.\,Abschnitt~\ref{sec:options}), dann sollten hier auch keine Nacharbeiten mehr notwendig sein.

\subsection{Umgebungsvariablen für Unix}
\label{sec:env}

Das Verzeichnis mit den ausführbaren Programmen von \TL muss sich im Suchpfad des Systems befinden.
Jedes unterstützte System besitzt ein eigenes Verzeichnis unterhalb von \dirname{TEXDIR/bin}, deren
Namen Sie in Abb.~\ref{fig:bin-text} finden.

Weiterhin können Sie die Verzeichnisse mit den Manual-Pages und Info-Dateien zu den entsprechenden
Suchpfaden für Dokumentation hinzufügen.

Für Systeme mit einer Bourne-kompatiblen Shell wie \prog{bash} ist hier am Beispiel von GNU/Linux
aufgeführt, wie die Befehle zum Setzen der Umgebungsvariablen (z.\,B. in \filename{\$HOME/.profile})
aussehen könnten:

\begin{verbatim}
export PATH=/usr/local/texlive/2012/bin/i386-linux:$PATH
export MANPATH=/usr/local/texlive/2012/texmf/doc/man:$MANPATH
export INFOPATH=/usr/local/texlive/2012/texmf/doc/info:$INFOPATH
\end{verbatim}

\noindent Für \prog{csh} oder \prog{tcsh} erfolgt die Konfiguration in der Regel in der Datei~\filename{\$HOME/.cshrc}
und könnte so aussehen:

\begin{verbatim}
setenv PATH /usr/local/texlive/2012/bin/i386-linux:$PATH
setenv MANPATH /usr/local/texlive/2012/texmf/doc/man:$MANPATH
setenv INFOPATH /usr/local/texlive/2012/texmf/doc/info:$INFOPATH
\end{verbatim}

\subsection{Systemweites Setzen von Umgebungsvariablen}
\label{sec:envglobal}


Wenn Sie als Administrator die Umgebungsvariablen global für das gesamte System setzen wollen,
gehen wir davon aus, dass Sie sich mit der grundlegenden Systemadministration auskennen.

Daher hier nur zwei Hinweise: 

\begin{enumerate}
\item Schauen Sie nach einer Datei
\filename{/etc/manpath.config}. Falls diese vorhanden ist, sollte es reichen, folgende Zeilen
hinzu zu fügen:

\begin{verbatim}
MANPATH_MAP /usr/local/texlive/2012/bin/i386-linux \
            /usr/local/texlive/2012/texmf/doc/man
\end{verbatim}

\item Prüfen Sie, ob es auf Ihrem System eine Datei \filename{/etc/environment} gibt, in der die
systemweiten Umgebungsvariablen definiert werden.

Zusätzlich wird ein symbolischer Link \code{man} im binary-Verzeichnis unter
Unix angelegt, der auf \dirname{texmf/doc/man} berweist. Einige Versionen von \code{man}, so z.\,B. unter \MacOSX,
finden so verlinkte Man-Pages automatisch, so dass hier keine spezielle
Konfiguration für die Man-Pages mehr erforderlich ist.

\end{enumerate}

\subsection{Internet-Updates nach der Installation von DVD}
\label{sec:dvd-install-net-updates}


Wenn Sie von DVD installiert haben, können Sie mittels des folgenden Befehls die Aktualisierung über das Internet aktivieren. Zuerst müssen Sie, wie im letzten Abschnitt beschrieben, den Suchpfad angepasst haben:

\begin{alltt}
> \Ucom{tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet}
\end{alltt}

\noindent Dadurch nutzt \cmdname{tlmgr} beim nächsten Update einen \CTAN\ Mirror. Sollte es Probleme bei der automatischen Wahl eines Mirror-Servers geben, kann ein bestimmter \CTAN\ Server von der unter \url{http://ctan.org/mirrors} verfügbaren Liste ausgewählt werden. Benutzen Sie diesen Pfad dann mit dem oben genannten Befehl.

\subsection{Font configuration für xe\TeX}\label{sec:font-conf-xetex}


\XeTeX\  und Lua\TeX\ können nicht nur die Schriften in den \TeX\ Bäumen nutzen, sondern auch die auf dem System vorhandenen Fonts. Die Methoden, wie sie dies tun, ähneln sich, sind aber verschieden.

Unter Windows sind die auf dem System vorhandenen Schriften automatisch nutzbar. Auf einem Unix/Linux System sind Anpassungen notwendig, damit die Schriften per Systemname und nicht nur Dateiname gefunden werden können.

Hierfür wird bei der Installation des \filename{xetex} Pakets die Datei \filename{TEXMFSYSVAR/fonts/conf/texlive-fontconfig.conf}
erzeugt.

Um die mitgelieferten \TL-Schriften systemweit verwenden zu können,
gehen Sie bitte folgendermaßen vor:

\begin{enumerate}
\item Kopieren Sie als root-User \filename{texlive-fontconfig.conf} nach
\dirname{/etc/fonts/conf.d/09-texlive.conf}.
\item Führen Sie \Ucom{fc-cache -fsv} aus. 
\end{enumerate}

\noindent Falls Ihnen als normaler Nutzer die entsprechenden Privilegien für die
obigen Schritte fehlen, können Sie die \TL-Schriften für sich selbst
als \XeTeX-Nutzer verwendbar machen:
\begin{enumerate}
\item Kopieren Sie \filename{texlive-fontconfig.conf} in das Unterverzeichnis
      \filename{~/.fonts.conf}, wobei \filename{~} Ihr Home-Verzeichnis ist.
\item Führen Sie \Ucom{fc-cache -fv} aus.
\end{enumerate}

Führen Sie \code{fc-list} aus, um eine Liste der Systemschriften mit hilfreichen Informationen zu erhalten.

\subsection{Con\TeX t Mark IV}
\label{sec:context-mkiv}

Sowohl das \enquote{alte} \ConTeXt{} (Mark \acro{II}) als auch das `neue' \ConTeXt{} (Mark \acro{IV}) sollten problemlos nach der \TL{} Installation funktionieren und brauchen keine besondere Aufmerksamkeit, sofern \verb+tlmgr+ für den Update-Prozess genutzt wird.

Da \ConTeXt{} Mk\acro{IV} jedoch nicht die kpathsea-Bibliothek nutzt, ist
ein wenig manuelle Nacharbeit notwendig, wenn neue Dateien manuell installiert werden (also ohne die Nutzung von 
\verb+tlmgr+).

Nach einer jeden solchen Installation muss jeder Nutzer das das folgende Kommando ausführen, um den \ConTeXt{} Cache zu aktualisieren:

\begin{verbatim}
context --generate
\end{verbatim}

Die erzeugten Dateien werden in \code{TEXMFCACHE} gespeichert, dessen Standardwert \verb+TEXMSYSVAR;TEXMFVAR+ ist. 

\ConTeXt\ Mk\acro{IV} liest aus allen Pfaden, die in \verb+TEXMFCACHE+ aufgeführt sind und schreibt in die erste Pfadangabe, bei der Schreibrechte existieren. Im Fall identischer Cache-Daten hat der letzte gefundene Pfad Vorrang vor allen anderen Pfaden.

Für weitere Informationen siehe
\url{http://wiki.contextgarden.net/Running_Mark_IV} und
\url{http://wiki.contextgarden.net/TeX_Live_2012}.

\subsection{Integrieren lokaler bzw. nutzer-spezifischer Makros}
\label{sec:local-personal-macros}

Wie bereits in Abschnitt~\ref{sec:texmftrees} erwähnt, ist der Verzeichnisbaum \dirname{TEXMFLOCAL} (im Normalfall \dirname{/usr/local/texlive/texmf-local} oder \verb|%SystemDrive%\texlive\texmf-local|) für lokale Ergänzungen wie Makros und Schriften gedacht, die anschließend allen Benutzern des Systems zur Verfügung stehen. Weiterhin können Benutzer den Verzeichnisbaum \dirname{TEXMFHOME} (im Normalfall \dirname{\$HOME/texmf} oder \verb|%USERPROFILE%\texmf|) für persönliche Ergänzungen verwenden, ohne dass andere Benutzer davon beeinflusst werden.

Diese Verzeichnisse sollen über verschiedene Versionen von \TL hinweg identisch sein, so dass ein Update von \TL auf eine neue Version einfach möglich ist, ohne dass Sie Ihre lokalen Ergänzungen verlieren. Wir empfehlen Ihnen daher, von der vorgegebenen Verzeichnisstruktur nicht abzuweichen.

Für beide oben genannte Verzeichnisbäume erwartet \TL eine Verzeichnisstruktur innerhalb des Baums, die dem \emph{\TeX{} Directory Standard} entspricht, wie er in \url{http://tug.org/tds} bzw. \filename{texmf/web2c/texmf.cnf} definiert ist.
So gehören Dokumentklassen für \LaTeX{} zum Beispiel in ein Verzeichnis
unterhalb von \dirname{TEXMFLOCAL/tex/latex} oder \dirname{TEXMFHOME/tex/latex}.

Der Verzeichnisbaum \dirname{TEXMFLOCAL} wird zur Laufzeit nicht direkt nach Dateien durchsucht. Stattdessen wird eine Liste von Dateinamen verwendet, sich sich in einer Datei mit dem Namen~\filename{ls-R} befindet. Denken Sie also daran, nach Änderungen in diesem Baum diese Dateiliste zu aktualisieren. Dies tun Sie
entweder mit dem Befehl \cmdname{mktexlsr} oder über die Schaltfläche \emph{Reinit file database} in dem Konfigurationsreiter des \TeX\ Live Managers (GUI-Modus).

\subsection{Integrieren von Schriften}

Die Installation von Schriften, die nicht von \TL sind, ist eine recht komplexe Angelegenheit. Sie sollten sich bereits gut mit dem System auskennen, bevor Sie diese Aufgabe beginnen. Schauen Sie vielleicht vorher in Abschnitt~\ref{sec:tl-fonts} nach, welche Schriften bereits bei \TL mitgeliefert werden.

Eine Alternative besteht im Benutzen von \XeTeX\ oder Lua\TeX\ (s.\,Abschnitt~\ref{sec:tex-extensions}), bei dem direkt alle vom Betriebssystem installierten Schriften verwendet werden können, ohne dass die Installation
einer \TeX-Unterstützung notwendig ist.

Falls Sie wirklich weitere Schriften benötigen, finden Sie unter \url{http://tug.org/fonts/fontinstall.html} eine Beschreibung zur
Installation weiterer Schriften.

\section{Testen der Installation}
\label{sec:test-install}


Nach der Installation von \TL wollen Sie es natürlich benutzen, um möglichst schöne Dokumente zu setzen.

Dieser Abschnitt beschreibt, wie Sie prüfen können, ob Ihr \TL-System funktioniert.
Die folgenden Beispiele sind für Unix, sollten unter Windows und \MacOSX aber sehr ähnlich sein. Der Unterschied kann sein, dass Sie dort eventuell eine grafische Benutzeroberfläche verwenden.

\begin{enumerate}

\item Prüfen Sie, ob Sie das Programm \cmdname{tex} ausführen können:

\begin{alltt}
> \Ucom{tex -{}-version}
TeX 3.1415926 (TeX Live 2012)
kpathsea version 5.0.0
Copyright 2011 D.E. Knuth.
...
\end{alltt}

Erhalten Sie als Resultat statt der Versionsnummer die Meldung, dass der Befehl nicht gefunden wurde,
so haben Sie wahrscheinlich vergessen, das Verzeichnis mit den ausführbaren Programmen
in Ihren \envname{PATH} aufzunehmen, s.\,Abschnitt~\ref{sec:env} auf S.\,\pageref{sec:env}.

\item Eine einfache \LaTeX{}-Datei übersetzen:
\begin{alltt}
> \Ucom{latex sample2e.tex}
pdfTeX 3.1415926-1.40.11-2.2 (TeX Live 2012)
...
Output written on sample2e.dvi (3 pages, 7484 bytes).
Transcript written on sample2e.log.
\end{alltt}

Falls dies schief geht, sind wahrscheinlich noch alte Umgebungsvariablen einer vorigen \TeX-Installation
übrig geblieben. Wir empfehlen, die Umgebungsvariablen, die sich auf \TeX{} beziehen, zu entfernen.
Für eine weitere Analyse können Sie \TeX{} anzeigen lassen, wo es bestimmte Dateien sucht,
siehe ">Fehlersuche"< auf Seite~\pageref{sec:debugging}.

\item Ergebnis auf dem Bildschirm anschauen:
\begin{alltt}
> \Ucom{xdvi sample2e.dvi}    # Unix
> \Ucom{dviout sample2e.dvi}  # Windows
\end{alltt}
Nun sollte
sich ein Vorschaufenster mit dem soeben gesetzten Beispieldokument öffnen, das die Grundlagen von
\LaTeX{} erläutert (und das Anfänger tatsächlich auch einmal lesen sollten).
Unter Unix muss ein X-Server laufen, damit \cmdname{xdvi} funktioniert;
falls dies nicht der Fall ist oder die Umgebungsvariable \envname{DISPLAY} falsch gesetzt ist,
erhalten Sie die Fehlermeldung \samp{Can't open display}.

\item Eine \PS{}-Datei erzeugen:
\begin{alltt}
> \Ucom{dvips sample2e.dvi -o sample2e.ps}
\end{alltt}

\item Direkt eine \acro{PDF}-Datei erzeugen (statt \dvi{}):
\begin{alltt}
> \Ucom{pdflatex sample2e.tex}
\end{alltt}

\item Eine \acro{PDF}-Datei anschauen:
\begin{alltt}
> \Ucom{gv sample2e.pdf}
\textrm{or:}
> \Ucom{xpdf sample2e.pdf}
\end{alltt}
Weder \cmdname{gv} noch \cmdname{xpdf} sind in \TL{} enthalten, daher müssen diese separat installiert
werden, siehe \url{http://www.gnu.org/software/gv} bzw.
\url{http://www.foolabs.com/xpdf}.
Sie können natürlich auch andere PDF-Viewer verwenden, beispielsweise den Adobe Reader, der allerdings unter Windows das Problem hat dass geöffnete PDF-Dateien
nicht überschrieben werden können, was zu Fehlern von pdf\TeX\ führt, wenn
Sie ein Dokument übersetzten wollen und vergessen haben, es vorher im
Acrobat Reader zu schließen. Unter Windows sollten Sie auch einmal
Sumatra PDF (\url{http://blog.kowalczyk.info/software/sumatrapdf}) ausprobieren.

\item Weitere nützliche Test-Dateien außer
\filename{sample2e.tex}:

\begin{description}
\item [small2e.tex] Einfachere Version von \filename{sample2e}, um den Fehler einzugrenzen, wenn Sie
beim Übersetzen von \filename{sample2e} Probleme haben.
\item [testpage.tex] Hiermit können Sie prüfen, ob Ihr Drucker Ihren Ausdruck horizontal oder vertikal verschiebt.
\item [nfssfont.tex] Zum Testen von Fonts und Erzeugen von Schrifttabellen.
\item [testfont.tex] Erzeugen von Schrifttabellen, aber mit plain \TeX.
\item [story.tex] Das einfachste Testdokument von allen (in plain \TeX{}).
Geben Sie am Ende \samp{\bs bye} ein, wenn nach dem Aufruf von \samp{tex
story.tex} der \code{*} erscheint.
\end{description}

\item Falls Sie das \filename{xetex}-Paket installiert haben, können Sie
das Verwenden von Systemschriften folgendermaßen testen:
\begin{alltt}
+> \Ucom{xetex opentype-info.tex}
This is XeTeX, Version 3.1415926\dots
...
Output written on opentype-info.pdf (1 page).
Transcript written on opentype-info.log.
\end{alltt}

(Oder das gleiche für \filename{luatex}.)

Falls Sie die Fehlermeldung ">Invalid fontname \glq Latin Modern
Roman\grq\dots"< erhalten, muss Ihr System so konfiguriert werden, dass
es die von \TL\ mitgelieferten Schriften findet (siehe Abschnitt~\ref{sec:font-conf-xetex}).
\end{enumerate}


\section{Hinweise auf weitere Software}

In vielen Fällen ist die Installation weiterer Software sinnvoll:
\begin{description}
\item[Ghostscript] \url{http://www.cs.wisc.edu/~ghost/}
\item[Perl] \url{http://www.perl.org/} mit Zusatzpaketen von
      \acro{CPAN}, \url{http://www.cpan.org/}
\item[ImageMagick] \url{http://www.imagemagick.com}, für die Bearbeitung
      und Umwandlung von Bildern in andere Formate,
\item[NetPBM] \url{http://netpbm.sourceforge.net/}, ebenfalls für Bilder.

\item[\TeX-Oberflächen] Es gibt eine breite Auswahl von Oberflächen bzw.
     Editoren, die \TeX\ unterstützen, je nach persönlichem Geschmack des
     Benutzers. Hier ist eine Auswahl, wobei einige davon nur für Windows verfügbar sind:
  \begin{itemize}
  \item \cmdname{GNU Emacs} gibt es auch für Windows, siehe
        \url{http://www.gnu.org/software/emacs/windows/ntemacs.html}.
  \item \cmdname{Emacs} mit Auc\TeX\ für Windows findet man auf der Homepage  \url{http://www.gnu.org/software/auctex}.
  \item \cmdname{Emacs} mit Auc\TeX\ für Windows findet man auf der Homepage  \url{http://www.gnu.org/software/auctex}.
  \item \cmdname{LEd} findet sich unter \url{http://www.ctan.org/support/LEd}.
  \item \cmdname{SciTE} findet sich unter
        \url{http://www.scintilla.org/SciTE.html}.
  \item \cmdname{Texmaker} ist Freie Software, verfügbar über
        \url{http://www.xm1math.net/texmaker/}.
  \item \cmdname{TexMakerX} \url{http://texmakerx.sourceforge.net/}
        ist eine Version von \cmdname{Texmaker} mit zusätzlichen Features
  \item \cmdname{TeXnicCenter} ist Freie Software, verfügbar über
        \url{http://www.texniccenter.org} und als Teil von pro\TeX{}t.
  \item \cmdname{TeXworks} ist Freie Software, verfügbar über
        \url{http://tug.org/texworks}. Wird unter Windows und
        \MacOSX\ als Teil von \TL\  mitinstalliert.
  \item \cmdname{Vim} ist Freie Software, verfügbar über
        \url{http://www.vim.org}.
  \item \cmdname{WinShell} findet sich unter \url{http://www.winshell.de}.
  \item \cmdname{WinEdt} ist Shareware, verfügbar über
        \url{http://tug.org/winedt} oder \url{http://www.winedt.com}.
        Bitte beachten Sie, dass es für Mitglieder von \dante\ ein
        Lizenzabkommen mit WinEdt zu sehr günstigen Preisen gibt. 
  \end{itemize}
\end{description}
Für weitere Programme siehe \url{http://tug.org/interest.html}.

\chapter{Installation für mehrere Maschinen oder Nutzer (Netz-Installation)}
\label{sec:sharedinstall}

Bei \TL ist nicht nur vorgesehen, dass es von mehreren Benutzern auf einem System verwendet werden kann, sondern auch in einem Netzwerk. In der normalen Konfiguration von \TL werden nur relative und keine absoluten Pfade verwendet. Dies erkennt man an Einstellungen in der Datei \filename{\$TEXMFMAIN/web2c/texmf.cnf}, die Zeilen wie die folgenden enthält, in denen Verzeichnisse relativ zu den Verzeichnissen lokalisiert werden,
in denen sich die Programme befinden:

\begin{verbatim}
TEXMFMAIN = $SELFAUTOPARENT/texmf
...
TEXMFLOCAL = $SELFAUTOPARENT/../texmf-local
\end{verbatim}

Daher ist es im Normalfall ausreichend, das Programm-Verzeichnis in den Suchpfad des Systems aufzunehmen, alles weitere bestimmt \TL dann automatisch.

Daher ist es kein Problem, wenn das Grundverzeichnis von \TL als Netzlaufwerk eingebunden ist. Tatsächlich können Sie \TL\ sogar zunächst lokal installieren und dann auf ein Netzlaufwerk verschieben.

Benutzer von Windows können ein Installationsskript namens \filename{w32client}
für eine Netzwerkinstallation von \url{http://tug.org/texlive/w32client.html} (siehe auch Abschnitt \ref{sec:sharedinstall}) herunterladen. Dieses nimmt die Einstellungen im Startmenü von Windows für das Verwenden von \TL über Netzwerk vor, weiterhin wird ein Skript zur Deinstallation mitgeliefert. Lesen Sie bitte die Beschreibung auf der angegebenen Webseite.

\chapter{Portables \TL  auf DVD oder USB-Stick}\label{sec:portable-tl}

Wenn Sie \TL\ im portablen Modus verwenden wollen (z.\,B. auf einem Rechner,
auf dem Sie "`Gast"' sind), können Sie \TL\ mit der Option \optname{-portable} (bzw. der Option \code{V} im Text-Installer oder der entsprechenden Option im grafischen Installer) auf einem USB-Stick installieren (siehe Abschnitt \ref{sec:cmdline}). 

Um \TeX\ von dieser portablen Installation ausführen zu können, muss das entsprechenden Verzeichnis mit den Binaries dem Suchpfad hinzugefügt werden. Unter Windows kann man \filename{tl-tray-menu} im Stammverzeichnis der Installation doppelt klicken, um zwischen verschiedenen Aufgaben zu wählen.

\medskip
\includegraphics[width=4cm]{tray-menu}
\smallskip

\noindent Der Eintrag `More\ldots' erläutert, wie Sie dieses Menü anpassen können.

\chapter{tlmgr: Installation verwalten}\label{sec:tlmgr}


\begin{figure}[tb]
\includegraphics[width=\linewidth]{tlmgr-gui}
\caption{\prog{tlmgr} im GUI-Modus. Hauptfenster nach dem Klicken auf ">Load"<.}\label{fig:tlmgr-gui}
\end{figure}

\begin{figure}[tb]
    \includegraphics[width=0.65\linewidth]{tlmgr-general-options}
    \caption{\texttt{tlmgr} im GUI-Modus: Allgemeine Optionen}
    \label{fig:tlmgr-general-options}
\end{figure}

\begin{figure}
\includegraphics[width=0.65\linewidth]{tlmgr-paper-options}
    \caption{\texttt{tlmgr} im GUI-Modus: Optionen zur Papiergröße}
    \label{fig:tlmgr-paper-options}
\end{figure}

Bei der Installation von \TL wird auch das Programm~\prog{tlmgr} installiert, mit dem Sie anschließend Ihr \TL-System verwalten können. Die hierfür bisher verwendeten Programme~\prog{updmap}, \prog{fmtutil} und \prog{texconfig} sind zwar noch vorhanden, aber inzwischen ist \prog{tlmgr} die vorgesehene Oberfläche zur Konfiguration von \TL. Mit \prog{tlmgr} können Sie folgende Aufgaben erledigen:

\begin{itemize}
\item Verfügbare Schemas, Collections und Pakete installieren, aktualisieren, wieder
     herstellen, sichern, deinstallieren, auf Wunsch mit
  Berücksichtigung von Paketabhängigkeiten.
\item Suchen nach Paketen.
\item Anzeigen der Systeme, unter denen \TL läuft; (de)installieren von Binaries für weitere Systeme.
\item Anpassen der Installation, wie Ändern der Papiergröße oder des Quellverzeichnisses für Komponenten
 (s.\,Abschnitt~\ref{sec:location}).
\end{itemize}

\textit{Achtung:} \prog{tlmgr} ist für die Installation im portablen Modus (Abschnitt \ref{sec:portable-tl}) weder gedacht noch getestet.

\section{tlmgr im grafischen Modus}

\prog{tlmgr} im GUI-Modus (siehe Abbildung \ref{fig:tlmgr-gui}) wird durch
\begin{alltt}
> \Ucom{tlmgr -gui}
\end{alltt}

gestartet. Unter Windows finden Sie das Programm im Start menu: \texttt{Start}, \texttt{Programme}, \texttt{TeX Live 2012}, \texttt{TeX Live Manager}. Nach Klicken auf ">Load"< wird eine Liste aller verfügbaren und installierten (letztere durch ">(i)"< gekennzeichnet) angezeigt. Dies setzt voraus, dass das Verzeichnis, aus dem \TL die Pakete lädt, vorhanden bzw.\ erreichbar ist.

Abb.~\ref{fig:tlmgr-general-options} und \ref{fig:tlmgr-paper-options} zeigen die Reiter zur allgemeinen Konfiguration von \TL\ und zur Einstellung der Papiergröße.


\section{Beispiel zur Verwendung von tlmgr über Kommandozeile}


Nachdem Sie \TL\ installiert haben, können Sie Ihr \TL-System auf den
neuesten Stand aktualisieren:
\begin{alltt}
> \Ucom{tlmgr update -all}
\end{alltt}
Falls Sie vorher wissen wollen, was passiert, können Sie zunächst
\begin{alltt}
> \Ucom{tlmgr update -all -dry-run}
\end{alltt}
oder (weniger ausführlich)
\begin{alltt}
> \Ucom{tlmgr update -list}
\end{alltt}
verwenden.

Das folgende Beispiel demonstriert, wie die Collection für \XeTeX\ installiert
wird, wobei sich die Installationsdateien in einem lokalen Verzeichnis
befinden:
 
\begin{alltt}
\Ucom{tlmgr -repository /local/mirror/tlnet install collection-xetex}
\end{alltt}
Dies liefert die folgende Ausgabe:

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

Wie man sieht, beachtet \prog{tlmgr} die Abhängigkeiten von Paketen und installiert im obigen Beispiel von \XeTeX{} benötigte Komponenten nach. Weiterhin werden automatisch im Anschluss die Dateilisten der Verzeichnisbäume aktualisiert und fehlende Formate generiert.

Informationen zu einem Paket (oder einer Collection oder einem Schema) anzeigen:

\begin{alltt}
Ucom{tlmgr show collection-latexextra}
\end{alltt}

Hier erhält man folgende Ausgabe:

\begin{verbatim}
package:    collection-latexextra
category:   Collection
shortdesc:  LaTeX supplementary packages
longdesc:   A large collection of add-on packages for LaTeX.
installed:  Yes
revision:   14675
\end{verbatim}

\noindent Die komplette Dokumentation finden Sie unter \url{http://tug.org/texlive/tlmgr.html}
oder mit
\begin{alltt}
> \Ucom{tlmgr -help}
\end{alltt}

\chapter{Hinweise zu Windows}
\label{sec:windows}

Das Installationsprogramm von \TL\ läuft sowohl unter Windows als auch Unix.  Dies war nur dadurch möglich, dass ältere Versionen von Windows nicht mehr unterstützt werden. Daher kann \TL\ nur noch ab Windows XP oder später installiert werden.

\section{Windows-spezifische Dinge}
\label{sec:winfeatures}


Unter Windows kümmert sich das Installationsprogramm auch um folgende Dinge:
\begin{description}
\item[Menüs und Verknüpfungen.] Im Startmenü wird ein Menü ">\TL{}"< hinzu gefügt. Hier sind Einträge für
  die grafischen Anwendungen (\prog{tlmgr}, \prog{texdoctk}, den PS\_View (\prog{psv}) PostScript-Previewer)
  und einige Verknüpfungen zur Dokumentation vorhanden. Für PS\_View wird eine Verknüpfung auf dem
  Desktop angelegt, auf die Sie \PS-Dateien per Drag~\& Drop ziehen können, um diese zu betrachten.
\item[Automatisches Setzen der Umgebungsvariablen.] Hierdurch ist das Setzen dieser Variablen
  von Hand überflüssig geworden.
\item[Uninstaller.] Es wird ein Eintrag zum Entfernen von \TL in der Systemsteuerung im Punkt Software angelegt.
  Alternativ können Sie \TL über die GUI \TeX\ Live Manager deinstallieren.
\item[Dateiverknüpfungen] Wenn diese Option aktiviert wird, werden \prog{TeXworks}, \prog{Dviout}
  und \prog{PS\_view} entweder die Standard-Programme für die entsprechenden Dateitypen oder erhalten einen Eintrag im `Öffnen mit' Dialog.
\item[Bitmap nach eps Konverter] Verschiedene Bitmap-Formate erhalten einen Eintrag \cmdname{bitmap2eps} in ihr `Öffnen mit' Menü. Bitmap2eps ist ein einfaches Skript, das im Hintergrund \cmdname{sam2p} oder \cmdname{bmeps} aufruft.
\item[Automatische Pfad-Anpassung] Erfordert keine manuellen Anpassungen.
\end{description}

\section{Zusätzlich enthaltene Programme unter Windows}

Zusätzlich werden unter Windows einige Programme installiert, die unter Windows meist noch nicht verfügbar sind:

\begin{description}
\item[Perl und Ghostscript.] Da Perl und Ghostscript für \TL sehr wichtig ist, werden diese   unter Windows mitgeliefert und werden intern von \TL benutzt. Die in \TL enthaltenen Programme, die diese Komponenten benötigen, ">wissen"< wo sich diese befinden, ohne dass diese im System durch   Umgebungsvariablen oder Einträge in der Registry sichtbar sind. Es handelt sich um für \TL abgespeckte
  Versionen, die zu keinen Konflikten mit eventuell bereits vorhandenen Installationen von Perl und Ghostscript führen sollten.

\item[PS\_View.] Weiterhin wird PS\_View installiert, ein neuer PostScript- und PDF-Viewer, der Freie Software ist, s.\,Abb.~\ref{fig:psview}.

\begin{figure}[tb]
\includegraphics[width=.6\linewidth]{psview}
\caption{PS\_View: sogar sehr extreme Vergrößerungen sind möglich.}\label{fig:psview}
\end{figure}

\item[dviout] Weiterhin wird \prog{dviout}, ein \acro{DVI}-Viewer installiert.
Wenn Sie am Anfang Dokumente mit \cmdname{dviout} anschauen, werden häufig noch Fonts generiert, da keine fertigen Fontdateien für den Bildschirm mitgeliefert werden. Je mehr Fonts generiert wurden, desto seltener müssen Schriften nachgeneriert werden, so dass dieser Effekt nach einiger Zeit nur noch selten
auftreten wird. Weitere Informationen finden Sie in der (sehr guten) Online-Hilfe.

\item[TeXworks] \TeX{}works ist eine Oberfläche für \TeX\ mit Editor und
   integriertem \acro{PDF}-Viewer.

\item[Tools für die Kommandozeile.] Für einige unter Unix übliche Programme werden Portierungen für Windows
   mitgeliefert. Dies sind z.\,B. \cmdname{gzip}, \cmdname{unzip} und einige Programme für die Kommandozeile aus der
   \cmdname{xpdf}-Suite, wie \cmdname{pdfinfo} und \cmdname{pdffonts}.  (Vom
   \cmdname{xpdf}-Viewer selbst gibt es keine Version für Windows, aber der
   Sumatra \acro{PDF}-Viewer basiert auf \cmdname{xpdf}:
   \url{http://blog.kowalczyk.info/software/sumatrapdf}.)
 \item[\texttt{fc-cache}, \texttt{fc-list} etc.] dienen \XeTeX{} zur effizienteren Benutzung von Schriften. Mit \prog{fc-list} können Sie die Namen der
   verfügbaren Schriften anzeigen, die Sie dann unter \XeTeX\ mit dem
   Kommando \texttt{font} benutzen können. Mit \prog{fc-cache} kann die Liste
   der verfügbaren Schriften aktualisiert werden.
\end{description}


\section{Nutzerprofile unter Windows}
\label{sec:winhome}

Das Gegenstück von Windows zum HOME-Verzeichnis unter Unix ist das
Verzeichnis \verb|%USERPROFILE%|.  

Unter Windows 7 oder Windows Vista liegt es meist in \verb|C:\Users\<username>|, 
unter Windows XP im Verzeichnis \verb|C:/Dokumente und Einstellungen/<username>|.

In der Datei  \filename{texmf.cnf} und in \KPS{} allgemein wird \verb|~| 
sowohl unter Unix und Windows korrekt aufgelöst.

\section{Die Windows-Registry}
\label{sec:registry}


Windows verwaltet fast all seine Konfigurationseinstellungen in der Registry. Diese besteht aus einem hierarchisch aufgebauten Baum von Schlüsseln, wobei mehrere dieser Registry-Bäume existieren. Die wichtigsten sind \path{HKEY_CURRENT_USER} und \path{HKEY_LOCAL_MACHINE}, oft abgekürzt als \path{HKCU} bzw.\ \path{HKLM}. Der \path{HKCU}-Teil der Registry wird im Home-Verzeichnis des Benutzers gespeichert (siehe Abschnitt~\ref{sec:winhome}). \path{HKLM} liegt im
Normalfall in einem Unterverzeichnis des Windows-Verzeichnisses.

In einigen Fällen sind Systeminformationen aus Umgebungsvariablen ersichtlich, in vielen anderen Fällen liegen diese Informationen aber in der Registry.

\section{Windows Permissions}
\label{sec:winpermissions}


In neueren Versionen von Windows wird zwischen normalen Benutzern und
Administratoren unterschieden, wobei nur letztere freien Zugang auf
alle Teile des Betriebsystems haben. Im Gegensatz zu Unix ist es in der
Praxis allerdings häufig so, dass Benutzer zur Klasse der Administratoren
gehören und daher doch alle Freiheiten haben. Trotzdem haben wir einigen
Aufwand getrieben, damit \TL auch unter Windows ohne Administrator-Rechte
installiert werden kann.

Falls der Benutzer, der \TL installiert, Administrator-Rechte besitzt,
kann \TL für alle Benutzer des Systems installiert werden, d.\,h. Verknüpfungen,
Menüs und Systemeinträge werden für alle Nutzer angelegt. Ansonsten werden diese
nur für den aktuellen Benutzer angelegt.

Unabhängig davon wird grundsätzlich angenommen, dass das Wurzelverzeichnis
von \TL unter \verb|%SystemDrive%| liegen soll. Allerdings testet das
Installationsprogramm, ob dieses Verzeichnis für den aktuellen Benutzer
schreibbar ist.

Ein Problem entsteht, wenn \TL ohne Administrator-Rechte installiert
wird und sich bereits ein \TeX{}-System im systemweiten Suchpfad
befindet. Windows benutzt zuerst den Suchpfad des Systems, erst dann
den spezifischen Suchpfad des Nutzers, so dass hier immer zuerst
das alte \TeX-System gefunden wird. Als Workaround wird hier eine
Verknüpfung mit einer Eingabeaufforderung erzeugt, in der das
Programmverzeichnis von \TL im Suchpfad vor den Standard\-such\-pfad
geschrieben wird. Dies bedeutet, dass in diesem Fall nur in einer
Eingabeaufforderung verfügbar ist, die über diese Verknüpfung gestartet
wird. Die Verknüpfung für \TeX{}works (falls Sie dieses installieren)
fügt ebenfalls automatisch \TL{} am Anfang des Suchpfades ein, so dass
es direkt benutzbar ist.

Unter Windows Vista gibt es einen weiteren Fallstrick. Selbst wenn Sie als
Administrator angemeldet sind, müssen Sie Programme trotzdem explizit
mit Administratorrechten starten. Insofern ist es tatsächlich nicht sehr
sinnvoll, sich als Administrator anzumelden. Klicken Sie stattdessen
auf das gewünschte Programm (bzw. die gewünschte Verknüpfung) mit der
rechten Maustaste, damit Sie die Option erhalten, dieses mit
Administratorrechten auszuführen.

\section{Erhöhen des maximal verfügbaren Speichers unter Windows und Cygwin}
\label{sec:cygwin-maxmem}


Unter Windows und Cygwin (s. Abschnitt \ref{sec:cygwin} für die Installation unter
Cygwin) kann es vorkommen, dass der den in \TL\ enthaltenen Programmen zur
Verfügung gestellte Speicher nicht ausreicht. Dies kann z.\,B. passieren, wenn
in \prog{asy} ein Array von 25 Millionen Gleitkommazahlen allokiert wird oder
ein Dokument mit umfangreichen Schriften mit Lua\TeX\ übersetzt wird.

Für Cygwin ist die Erhöhung des Maximalspeichers im Cygwin-Hanbuch beschrieben
(\url{http://www.cygwin.com/cygwin-ug-net/setup-maxmem.html}).

Unter Windows können Sie eine Datei \code{moremem.reg} mit folgenden vier
Zeilen anlegen:

\begin{verbatim}
Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\Software\Cygwin]
"heap_chunk_in_mb"=dword:ffffff00
\end{verbatim}

Führen Sie dann als Administrator \code{regedit /s moremem.reg} aus.
(Falls der zur Verfügung stehende Speicher nur für den aktuellen Nutzer
erhöht werden soll, verwenden Sie stattdessen einfach \code{HKEY\_CURRENT\_USER}).

\chapter{Anleitung zum Web2C-System}

Web2C besteht aus einer Reihe von Programmen, die zusammen ein komplettes
\TeX-System darstellen. Dazu gehören natürlich \TeX, \MF, \MP, {\BibTeX} usw.

Die erste Implementierung eines \TeX-Systems in der Programmiersprache C stammt von Tomas~Rokicki und datiert zurück in das Jahr 1987. Rokicki benutzte als Basis sog. Change-Files unter \acro{UNIX}, die ursprünglich von Howard~Trickey und Pavel~Curtis entwickelt wurden. Tim~Morgan hat dieses System, für das der Name  Web-to-C\@ eingeführt wurde, gepflegt. 1990 hat Karl~Berry mit Unterstützung vieler Helfer die Weiterentwicklung übernommen und 1997 an Olaf~Weber weitergegeben, der es 2006 wieder an Karl zurück gab.

Web2C läuft unter \acro{UNIX}, 32-bit-Versionen von Windows, \MacOSX{}
und auf weiteren Betriebssystemen. Es benutzt die
Original-Quelldateien von Donald E.~Knuth und weitere in der
Sprache \texttt{WEB} entwickelte Programme als Basis und übersetzt diese
in C-Quell-Code. Darüber hinaus bietet das System viele Makros und
Funktionen zur Nutzung der originalen \TeX-Software. Hier eine
Liste der Basisprogramme eines \TeX-Systems:

\begin{description}
\item[bibtex]   Verwalten von Bibliographien
\item[dvicopy]  Umwandeln von virtuellen Zeichensätzen in DVI-Dateien
\item[dvitomp]  DVI-nach-MPX-Konverter (\MP-Bilder)
\item[dvitype]  Textanzeige aus DVI-Dateien
\item[gftodvi]  Erzeugen von Prüfausgaben für Zeichensätze
\item[gftopk]   Packen von Zeichensätzen
\item[gftype]   Anzeige von Zeichensätzen als ASCII-Graphik
\item[mf]       Zeichensatzerzeugung
\item[mft]      formatierte Ausgabe von \MF-Quellen
\item[mpost]    \MF-ähnliches Grafikprogramm
\item[patgen]   Erzeugen von Trennmustern
\item[pktogf]   Entpacken von Zeichensätzen
\item[pktype]   Anzeige gepackter Zeichensätze
\item[pltotf]   Umwandeln von Property-Listen in \file{.tfm}-Dateien
\item[pooltype] Anzeige der Bildschirmtexte eines WEB-Programms
\item[tangle]   Konverter {\web} nach Pascal
\item[tex]      \TeX-Programm
\item[tftopl]   Umwandeln einer \file{.tfm}-Datei in eine Property-Liste
\item[vftovp]   Umwandeln eines virtuellen Zeichensatzes in eine Property-Liste
\item[vptovf]   Umwandeln einer Property-Liste in einen virtuellen Zeichensatz
\item[weave]    \web-Code als \TeX-Dokumentation
\end{description}

Die genaue Funktionsweise und die möglichen Parameter sind der
Beschreibung der jeweiligen Pakete bzw.\ der Web2C-Dokumentation zu entnehmen.
Trotzdem wird ein Überblick über Zusammenspiel und Funktionsweise der
Web2C-Programme Ihnen sicherlich helfen, besser mit dem System zurechtzukommen.

Zunächst verstehen alle Programme die grundlegenden Parameter der
\acro{GNU}-Software:

\begin{description}
\item[\texttt{-{}-help}] kurzer Hilfstext
\item[\texttt{-{}-verbose}] ausführliche Ausgaben beim Programmablauf
\item[\texttt{-{}-version}] Ausgabe der Versionsnummer
\end{description}

\noindent Die Programme des Web2C-Systems benutzen zum Lokalisieren der benötigten
Dateien im Dateisystem die \KPS-Bibliothek (\url{http://tug.org/kpathsea}). Diese Bibliothek optimiert und
beschleunigt den Suchprozess im Dateisystem. Ihre Arbeitsweise wird durch
einige Umgebungsvariablen und eine Kon"-fi"-gu"-ra"-tions"-da"-tei gesteuert.
Web2C~7.5 kann mehr als einen Dateibaum gleichzeitig verwalten und ermöglicht
somit die schon beschriebene \TL-Installation unter Verwendung der
{\DVD} mit der Ablage modifizierter Konfigurationsdateien
und zusätzlicher Zeichensätze in einem zweiten Dateibaum. Die Suche
nach Dateien wird durch die Analyse der Datei \file{ls-R} beschleunigt,
die in jedem Wurzelverzeichnis eines \TeX-Dateibaums vorhanden ist.
Sie enthält für jede Datei die genaue Position im Dateibaum relativ
zum Wurzelverzeichnis.


\section{Dateisuche mit der Kpathsea-Bibliothek}
\label{sec:kpathsea}

Wir beschreiben zunächst den grundlegenden Suchmechanismus der \KPS-Bibliothek.

Ein \emph{Suchpfad} ist eine durch Kommata oder Semikola getrennte Liste von
\emph{Pfadkomponenten}, die üblicherweise Verzeichnisnamen darstellen.
Ein Suchpfad kann sich aus vielen Komponenten zusammensetzen. Die Suche nach
einer Datei \samp{my-file} über den Suchpfad \samp{.:/dir} bewirkt, dass
{\KPS} jede Komponente nacheinander überprüft, also zunächst
\samp{./my-file} und dann \samp{/dir/my-file}. Als Ergebnis wird entweder die
erste gefundene Datei oder eine Liste aller passenden Dateien geliefert.

Um auf allen Dateisystemen effizient arbeiten zu können, verwendet {\KPS} ggf. andere Datei-/""Verzeich"-nis-Separatoren als \samp{:} und \samp{/}.

Beim Überprüfen einer Pfadkomponente \var{p} überprüft {\KPS} zunächst,
ob eine Dateinamen"=Datenbank (siehe auch Dateinamen"=Datenbank auf
Seite~\pageref{sec:filename-database}) für die Pfadkomponente zuständig ist,
d.\,h. beispielsweise steht die Datenbank in einem Verzeichnis, das im Pfad
vor der zu überprüfenden Komponente \var{p} steht. In diesem Fall wird
zur Bestimmung der Position der gesuchten Datei die Datenbank herangezogen.

Nur wenn keine passende Datenbank existiert oder wenn die Datei nicht
in der Datenbank gefunden wird, durchsucht {\KPS} das Dateisystem. Diese
zeitaufwändige Suche kann über die Spezifikation der Pfadkomponente \var{p}
mit dem Präfix \samp{!!}\ unterbunden werden. Zur Suche erzeugt {\KPS} eine
Liste der Verzeichnisse, die im Pfadelement enthalten sind, und durchsucht
jedes dieser Verzeichnisse nach der gesuchten Datei.

Für Dateien kann auch ein Schalter \samp{file~must~exist} gesetzt werden (">Datei muss vorhanden sein"<). Wenn dieser Schalter nicht gesetzt ist und beispielsweise über das \TeX-Kommando \code{openin} eine VF-Datei wie \file{cmr10.vf} gelesen werden soll, wäre es falsch, nach dieser Datei zu suchen, weil es sie gar
nicht gibt. Speziell für neu installierte VF-Dateien sollten Sie also unbedingt die Dateinamen"=Datenbank (\cmdname{ls-R}) aktualisieren, weil die Dateien sonst nicht gelesen werden und kein Fehler angezeigt wird. Dieser Vorgang wiederholt sich für jede Komponente eines Suchpfades: zunächst wird die Datenbank
überprüft, danach ggf. das Dateisystem. Wird die Datei gefunden,
stoppt die Suche (normalerweise) und als Ergebnis wird der komplette Pfad zur
gesuchten Datei ausgegeben.

Außer Verzeichnisnamen dürfen Pfadkomponenten für {\KPS} folgende
Elemente enthalten: (verschachtelte) Vorgaben, Umgebungsvariablen,
Werte aus der Konfigurationsdatei, Home-Verzeich"-nisse von
Benutzern und Startverzeichnisse für eine rekursive Suche. Diese
Elemente werden vor einer Dateisuche von {\KPS} in gewöhnliche
Verzeichnis- oder Dateinamen expandiert. Diese Expansion wird in
den folgenden Abschnitten erklärt, und zwar genau in der
Reihenfolge, wie die Elemente auch von {\KPS} bearbeitet werden.

Beachten Sie, dass {\KPS} bei absoluten und explizit relativen Komponenten,
d.\,h. wenn die Komponente mit den Zeichen \samp{/}, \samp{./} oder
\samp{../} beginnt, nur überprüft, ob die Datei existiert.

\begin{verbatim}
\begin{figure*}[tp]
\verbatiminput{../texlive-common/examples/ex5.tex}
\setlength{\abovecaptionskip}{0pt}
  \caption{An illustrative configuration file sample}
  \label{fig:config-sample}
\end{figure*}
\end{verbatim} % xxxxx todo

\subsection{Bestandteile von Pfadkomponenten}
\label{sec:path-expansion}


Ein Suchpfad kann aus vielen verschiedenen Bestandteilen aufgebaut werden.
Dies sind in der Reihenfolge, wie {\KPS} sie auswertet:

\begin{enumerate}
\item
  eine benutzerdefinierte Umgebungsvariable, z.\,B. \envname{TEXINPUTS}:
  Wird an den Inhalt der Variablen ein Punkt und ein Programmname angehängt, wie
  beispielsweise bei \envname{TEXINPUTS.latex}, hat diese Form Vorrang
  vor den ">gewöhnlichen"< Variablen.
\item
  Einträge aus programmspezifischen Konfigurationsdateien,
  beispielsweise zum Programm \code{dvips} eine Zeile \code{S /a:/b}
  in der Konfigurationsdatei \file{config.ps}
\item
  Einträge aus der \KPS-Konfigurationsdatei \file{texmf.cnf},
  z.\,B. \code{TEXINPUTS=/c:/d} (siehe folgenden Text)
\item
  Einstellung beim Übersetzen der Programme
\end{enumerate}

\noindent Unter Verwendung der Parameter zur Fehlersuche können Sie sich diese
Werte für einen Suchpfad auch anzeigen lassen. (Siehe dazu den Abschnitt
Fehlersuche auf Seite~\pageref{sec:debugging}.)


\subsection{Konfigurationsdateien}

Die \KPS-Bibliothek liest zur Laufzeit die \emph{Konfigurationsdateien} mit den Namen \file{texmf.cnf}. Der zugehörige Suchpfad zum Auf"|finden dieser
Konfigurationsdateien steht in der Umgebungsvariablen \envname{TEXMFCNF}
(die Voreinstellung ist \file{texmf/web2c}). {\KPS} liest \emph{alle}
Dateien mit den Namen \file{texmf.cnf}, die es in diesem Suchpfad findet.
Die zuerst gelesenen Definitionen haben dabei Vorrang vor später gelesenen
Werten. Wenn der Suchpfad auf \dirname{.:\$TEXMF} steht, überschreiben die Einstellungen in \file{./texmf.cnf} diejenigen in \dirname{\$TEXMF/texmf.cnf}.

Im Folgenden wird die Syntax der Datei \file{texmf.cnf} angegeben.
Konsultieren Sie zum besseren Verständnis beim Lesen die auf der
CD-ROM oder DVD enthaltene Konfigurationsdatei.

\begin{itemize}
\item
  Kommentare beginnen mit einem \code{\%} und erstrecken sich bis zum
  Zeilenende.
\item
  Leerzeilen werden überlesen.
\item
  Ein \samp{\bs} am Zeilenende fasst die aktuelle mit der folgenden Zeile
  zusammen. Leerraum in der Folgezeile wird \emph{nicht} überlesen.
\item
  Sonstige Zeilen haben den folgenden Aufbau:

\begin{alltt}
  \var{Variable}[.\var{Programmname}] [=] \var{Wert}
\end{alltt}%

  Das Zeichen ">="< und umgebender Leerraum dürfen entfallen.
\item
  Der Name von \var{Variable} kann alle Zeichen außer Leerzeichen,
  \samp{=} und \samp{.} enthalten. Verwenden Sie am besten nur die Zeichen
  \samp{A-Za-z\_}.
\item
  Wenn das Suffix ">\code{.\var{Programmname}}"< angegeben wird, gilt die
  Variable nur für das entsprechende Programm ">\var{Programmname}"< oder
  ">\code{\var{Programmname}.exe}"<. Auf diese Weise können
  beispielsweise verschiedene
  \TeX-Formate mit unterschiedlichen Suchpfaden arbeiten.
\item
  \texttt{\var{Wert}} darf alle Zeichen außer \texttt{\%} und \texttt{@}
  enthalten.
  Die Einschränkung der Werte auf bestimmte Programme über ein Suffix
  ist nicht zulässig. Ein \samp{;} in \texttt{\var{Wert}} wird unter
  \acro{UNIX} in \samp{:} umgewandelt. Dadurch ist die Verwendung der gleichen
  Konfigurationsdateien für \acro{UNIX} und \acro{DOS}/""Windows"=Systeme möglich.
\item
  Die Definitionen werden komplett eingelesen, bevor eine Expansion
  stattfindet. Dadurch können Sie die Variable schon vor Ihrer Definition
  referieren.
\end{itemize}

Der Ausschnitt einer Konfigurationsdatei demonstriert diese
Möglichkeiten.

\begin{verbatim}
\verbatiminput{../texlive-common/examples/ex5.tex}
Betrachten Sie Abbildung~\ref{fig:config-sample}.
\end{verbatim} % xxxx todo

\subsection{Expansion von Pfadkomponenten}

{\KPS} verwendet in Suchpfaden ähnliche Zeichen und Konstrukte wie
\acro{UNIX}-Shells. Beispielsweise wird die Definition
\verb|~$USER/{foo,bar}//baz| in alle Unterverzeichnisse von \file{foo} und
\file{bar} unterhalb vom Home-Verzeichnis von \dirname{\$USER} expandiert,
die eine Datei oder ein Unterverzeichnis namens \file{baz} enthalten. Der
Expansionsmechanismus wird im Folgenden erklärt.

\subsection{Expansion der Voreinstellungen}\label{sec:default-expansion}

Wenn der Suchpfad mit der höchsten Priorität (siehe hierzu ">Bestandteile von
Pfadkomponenten"< auf Seite~\pageref{sec:path-sources}) einen zusätzlichen
(vorangestellten, nachgestellten oder verdoppelten) Doppelpunkt enthält,
wird an dieser Stelle der Suchpfad eingefügt, der als nächstes in der
Hierarchie folgt. Auch bei diesem gilt dieselbe Regel. Wenn beispielsweise
die Umgebungsvariable


\begin{alltt}
> \Ucom{setenv TEXINPUTS /home/karl:}
\end{alltt}

gesetzt wird (hier: C-Shell) und in \file{texmf.cnf} die Variable
\code{TEXINPUTS} folgenden Wert erhält

\begin{alltt}
  .:\$TEXMF//tex
\end{alltt}

dann lautet der Suchpfad schließlich:

\begin{alltt}
  /home/karl:.:\$TEXMF//tex
\end{alltt}

Da es sinnlos wäre, denselben Pfad mehrfach einzufügen, wird die Ersetzung
nur einmal vorgenommen, und zwar in der Reihenfolge vorne, hinten und
Mitte. Mehrfach verdoppelte Doppelpunkte bleiben unverändert.

\subsection{Expansion geschweifter Klammern}


Die Expansion geschweifter Klammern ist zur Definition mehrerer \TeX-Hierarchien sehr nützlich. Beispielsweise wird |v{a,b}w| zu |vaw:vbw|. Verschachtelungen sind dabei erlaubt. Diese Technik wird dazu benutzt, durch eine Zuweisung an
\code{\$TEXMF} verschiedene \TeX-Hierarchien einzuführen. Als Beispiel finden Sie in \file{texmf.cnf} folgende Definition (etwas gekürzt, tatsächlich ist es etwas komplexer):

\begin{verbatim}
  TEXMF = {$TEXMFHOME,$TEXMFLOCAL,!!$TEXMFVAR,!!$TEXMFMAIN}
\end{verbatim}

Eine Anwendung wie

\begin{verbatim}
  TEXINPUTS = .;$TEXMF/tex//
\end{verbatim}

führt dann dazu, dass erst im aktuellen Verzeichnis gesucht wird, dann
im gesamten Dateibaum \code{\$TEXMFHOME/tex} und \code{\$TEXMFLOCAL/tex}
(auf der Festplatte) und schließlich im gesamten Dateibaum \dirname{\$TEXMFVAR/tex} sowie \code{\$TEXMFMAIN/tex} (nur in der Datenbank \file{ls-R}) durchsucht wird. Dadurch kann man bequem zwei parallel installierte \TeX-Hierarchien durchsuchen, beispielsweise eine unveränderliche auf \acro{CDROM}/{\DVD} und eine dynamisch angepasste auf Festplatte, in der neue Programmversionen und zusätzliche Zeichensätze installiert werden. Durch die Verwendung der Variablen \code{\$TEXMF} in allen Definitionen wird grundsätzlich zuerst der neuere Dateibaum durchsucht.


\subsection{Expansion von Unterverzeichnissen}\label{sec:subdirectory-expansion}

Zwei oder mehrere aufeinanderfolgende Schrägstriche (\texttt{//}) in einer Pfadkomponente, die auf einen Verzeichnisnamen \var{d} folgen, werden expandiert zu allen Unterverzeichnissen von \var{d}. Dieser Vorgang findet rekursiv statt, wobei erst alle Verzeichnisse auf einer Ebene bearbeitet werden, dann deren Unterverzeichnisse, usw. Auf den jeweiligen Ebenen ist nicht beeinflussbar, in welcher Reihenfolge die Unterverzeichnisse bearbeitet werden.

Wenn nach den Schrägstrichen Namen angegeben werden, dann werden nur
Unterverzeichnisse mit passenden Namen in die Suche einbezogen. Beispielsweise wird \code{/a//b} in die Pfade \file{/a/1/b}, \file{/a/2/b}, \file{/a/1/1/b} usw. expandiert, aber nicht zu \file{/a/b/c} oder \file{/a/1}. (Jeweils vorausgesetzt, dass die Verzeichnisse existieren.)

Mehrere \code{//}-Konstruktionen innerhalb einer Pfadkomponente
sind zulässig, allerdings nicht am Pfadanfang.


\subsection{Liste der Sonderzeichen und ihre Bedeutung: eine Zusammenfassung}


Die folgende Zusammenfassung fasst alle Sonderzeichen zusammen, die in den
\KPS"=Konfigurationsdateien auftreten können:

% ++++++++++++++++++++++++ %xxxx todo
\newcommand{\CODE}[1]{\makebox[3em][l]{\code{#1}}}
% ++++++++++++++++++++++++

\begin{description}
\item[\CODE{:}]  Trennzeichen für Pfadkomponenten; als erstes
                    oder letztes Zeichen im Pfad bewirkt es die
                    Expansion der Voreinstellungen.
\item[\CODE{;}]  Trennzeichen für Pfadkomponenten für andere
                    Rechnerplattformen als \acro{UNIX} (Verwendung wie
      ">\code{:}"<)
\item[\CODE{\$}]    Expansion von Variableninhalten
\item[\CODE{\string~}]   Home-Verzeichnis eines Benutzers (Tilde)
\item[\CODE{\char`\{...\char`\}}] Expansion geschweifter Klammern:
                    beispielsweise wird |a{1,2}b| zu |a1b:a2b|.
\item[\CODE{//}]    Expansion von Unterverzeichnissen: tritt niemals
                    am Anfang einer Pfadkomponente auf.
\item[\CODE{\%}]    Kommentar
\item[\CODE{\bs}]   Konkatenation mit Folgezeile(n)
\item[\CODE{!!}]    Einschränkung der Suche \emph{ausschließlich} auf die
                    Dateinamen"=Datenbank: Das Dateisystem wird \emph{nicht}
                    durchsucht!
\end{description}



\section{Dateinamen-Datenbanken}\label{sec:filename-database}

\KPS unternimmt etliche Anstrengungen, um den Zugriff auf Festplatte und
DVD zur Suche nach Dateien zu reduzieren. Auf \TeX-Systemen mit vielen Unterverzeichnissen kann die Suche in jedem möglichen Verzeichnis nach einer bestimmten Datei eine lange Zeit in Anspruch nehmen, besonders wenn einige Hundert Zeichensatzverzeichnisse durchforstet werden müssen. Um dieses Problem abzumildern, benutzt {\KPS} eine Art Datenbankdatei namens \file{ls-R}, die die Zuordnung von Dateinamen auf Verzeichnisse enthält. Dadurch muss nicht jedesmal die Festplatte durchsucht werden.

Eine zweite Datenbank in der Datei \file{aliases} kann eine Zuordnung zwischen den Namen in \file{ls-R} und weiteren Namen vornehmen und so beispielsweise hilfreich bei der Umsetzung von \samp{8.3}-\acro{DOS}-Dateinamen auf die ">echten"<, aussagekräftigen Dateinamen zur Seite stehen.

\subsection{Die ls-R-Datenbank}\label{sec:ls-R}


Wie schon öfters erwähnt, muss die Dateinamen"=Datenbank in der Datei
\file{ls-R} gespeichert sein. Sie sollten eine solche Datenbank für jede
\TeX-Hierarchie (normalerweise in \code{\$TEXMF}) Ihres Systems anlegen.
{\KPS} sucht die Datenbanken \file{ls-R} über den Pfad \code{TEXMFDBS}.

Es wird empfohlen, die Pflege der \code{ls-R}-Dateien dem mitgelieferten
Skript \cmdname{mktexlsr} zu überlassen. Dieses Skript wird automatisch von den
verschiedenen \samp{mktex*}-Skripten aufgerufen. Das Skript ruft
grob gesagt den Befehl

\begin{alltt}
cd /\var{your}/\var{texmf}/\var{root} && ls -LAR ./ >ls-R
\end{alltt}

auf, falls das Kommando \code{ls} Ihres Rechners eine Ausgabe im richtigen
Format liefert. (So wie das \acro{GNU}-\code{ls}.) Wenn Sie ganz sichergehen
wollen, dass die Datenbank immer auf dem neuesten Stand ist, sollten Sie sie
in regelmäßigen Abständen mit Hilfe eines \cmdname{crontab}-Eintrags
aktualisieren lassen.  Dadurch wird nach einer Installation eines
Pakets per Hand trotzdem sichergestellt, dass die Datenbank aktuell ist.

Wenn eine Datei nicht über die Datenbank gefunden wird, sucht
{\KPS} normalerweise auf der Festplatte weiter. Wenn eine Pfadkomponente
mit \code{!!} beginnt, wird dagegen niemals die Festplatte durchsucht.


\subsection{kpsewhich: Dateisuche}
\label{sec:invoking-kpsewhich}


Mit dem Programm \cmdname{kpsewhich} können Sie unabhängig vom Aufruf
irgendeines \TeX-Programms nach Dateien in der \TeX-Hierarchie suchen
(als schnellere Alternative zu dem Befehl \cmdname{find}). Dies
wird von den verschiedenen \samp{mktex\dots}-Skripten bis zum
Exzess vorexerziert.

\begin{alltt}
> \Ucom{kpsewhich \var{option}{\dots} \var{filename}{\dots}}
\end{alltt}

Die Optionen werden entweder mit \samp{-} oder mit \samp{-{}-} eingeleitet.
Jede eindeutige Abkürzung ist zulässig.

Argumente der Kommandozeile, die keine Optionen darstellen, werden als
Dateinamen interpretiert. Für jeden Dateinamen wird der erste passende
Pfad gemeldet. Um eine Liste aller passenden Pfade zu erhalten, müssen Sie
das \acro{UNIX}-Kommando \cmdname{find} aufrufen.

Im Folgenden werden die häufiger benutzten Optionen beschrieben.

\begin{description}
\item[\texttt{-{}-dpi=}\var{num}]\mbox{}\\
     Stellt die Auf"|lösung für die Suche nach Zeichensätzen
     (nur \file{.gf} oder \file{.pk}) auf \var{num}\,dpi. Alternativ
     kann die Option \code{-D} (kommt von dvips) benutzt werden.
     Voreinstellung ist~600.
\item[\texttt{-{}-format=}\var{name}]\mbox{}\\
     Setzt das Format zur Suche auf \var{name}. Per Voreinstellung
     versucht \cmdname{kpsewhich} das Format über den Dateinamen
     zu erschließen. Bei Formaten ohne zugeordnete Namens\-endung wie den
     zu {\MP} gehörenden Dateien und den Konfigurationsdateien zu
     {dvips} müssen Sie den entsprechenden Namen so eingeben, wie er
     \KPS{} bekannt ist.
\item[\texttt{-{}-mode=}\var{string}]\mbox{}\\
     Setzt für die Zeichensatzsuche den Generierungsmodus (betrifft nur
     \file{.gf}- oder \file{.pk}-Dateien). Normalerweise werden alle
     Zeichensätze gemeldet.
\item[\texttt{-{}-must-exist}]\mbox{}\\
     Es wird versucht, die Dateien notfalls durch eine Suche auf der
     Festplatte zu finden. Normalerweise wird nur die \file{ls-R}-Datenbank
     konsultiert.
\item[\texttt{-{}-path=}\var{string}]\mbox{}\\
     Sucht entlang des angegebenen Pfads statt des Standardpfads,
     der auf Grund der Endung gewählt wird. Alle Expansionen sind
     zulässig. Bei Verwendung der Option \texttt{-{}-path} darf nicht
     die Option \texttt{-{}-format} angegeben werden.
\item[\texttt{-{}-progname=}\var{name}]\mbox{}\\
     Setzt den Programmnamen für die genauere Variablenspezifikation
     über \code{.\var{Programmname}}. Voreinstellung ist \code{kpsewhich}.

\item[\texttt{-{}-show-path=}\var{name}]\mbox{}\\
     Zeigt den Suchpfad für die angegebene Namens\-endung. Diese kann entweder
     als Namens\-endung (\code{.pk}, \code{.vf}, usw.) oder als Name (wie bei der
     Option \code{-{}-format}) spezifiziert werden.
\item[\texttt{-{}-debug=}\var{num}]\mbox{}\\
     Legt den Umfang für die Fehlersuche fest.
\end{description}


\subsection{Anwendungsbeispiele}
\label{sec:examples-of-use}


Wir schauen uns nun die Funktionsweise von {\KPS} anhand einiger Beispiele an.

\begin{alltt}
> \Ucom{kpsewhich  article.cls}
   /usr/local/texmf-dist/tex/latex/base/article.cls
\end{alltt}

Wir suchen unter den \TeX-Quelldateien nach der Datei \file{article.cls}.
Da die Namens\-endung \samp{.cls} eindeutig ist, müssen wir den Typ
\samp{.tex} nicht angeben. Die \samp{texmf-dist}-Hierarchie enthält die
Datei im Unterverzeichnis \dirname{tex/latex/base}. Ähnlich bereiten
die folgenden Beispiele auf Grund eindeutiger Namens\-endungen keine Probleme.

\begin{alltt}
> \Ucom{kpsewhich array.sty}
   /usr/local/texmf-dist/tex/latex/tools/array.sty
> \Ucom{kpsewhich latin1.def}
   /usr/local/texmf-dist/tex/latex/base/latin1.def
> \Ucom{kpsewhich size10.clo}
   /usr/local/texmf-dist/tex/latex/base/size10.clo
> \Ucom{kpsewhich small2e.tex}
   /usr/local/texmf-dist/tex/latex/base/small2e.tex
> \Ucom{kpsewhich tugboat.bib}
   /usr/local/texmf-dist/bibtex/bib/beebe/tugboat.bib
\end{alltt}

Beim letzten Beispiel handelt es sich übrigens um eine \BibTeX-Literaturdatenbank für \textsl{TUGBoat}-Artikel.

\begin{alltt}
> \Ucom{kpsewhich cmr10.pk}
\end{alltt}

Zeichensatzdateien mit der Namens\-endung \samp{.pk} werden
von Anzeige- oder Druckaufbereitungsprogrammen wie dvips und
\cmdname{xdvi} verwendet. Nachdem wir aufgrund der Voreinstellung keine \file{.pk}-Dateien verwenden, sondern die PS-Type1-Zeichensätze, die auf der DVD enthalten sind, wird auch keine \file{.pk}-Datei angezeigt.

\begin{alltt}
> \Ucom{kpsewhich wsuipa10.pk}
 /usr/local/texmf-var/fonts/pk/ljfour/public/wsuipa/wsuipa10.600pk
\end{alltt}
Für diesen Zeichensatz (Teil der \acro{IPA}-Fonts%
\footnote{\acro{IPA}: International Phonetic Alphabet}
von der Universität von Washington) liegen noch keine
Type1-Umsetzungen vor und \code{.pk}-Dateien müssen generiert werden. Da unser voreingestellter \MF-Modus \code{ljfour} eine Auf"|lösung von 600\,dpi besitzt,
finden wir (nachdem er schon einmal gebraucht und automatisch
erzeugt wurde) eine entsprechende Instanz dieses Zeichensatzes.

\begin{alltt}
> \Ucom{kpsewhich -dpi=300 wsuipa10.pk}
\end{alltt}

Durch die Angabe ">\code{-dpi=300}"< interessieren wir uns nur
für Zeichensätze mit der Auf"|lösung 300\,dpi. Es wurde keiner gefunden.
Programme wie dvips oder \cmdname{xdvi} lassen einen solchen fehlenden
Zeichensatz durch den Aufruf des Skripts \cmdname{mktexpk} mit entsprechenden
Parametern automatisch erzeugen.

Als nächstes wenden wir uns den Header- und Konfigurationsdateien
von dvips zu.

Zunächst suchen wir nach der Konfiguration für die \TeX-Unterstützung,
dem Prolog \file{tex.pro}. Danach suchen wir die allgemeine Konfigurationsdatei
(\file{config.ps}) und schließlich die \PS-Zeichensatzzuordnungsdatei
\file{psfonts.map}. Dateien dieser Art haben seit der 2004er-Version der {\TL} ihre eigenen Suchpfade und einen neuen Aufbewahrungsort im \OnCD{texmf}-Baum. Da die Namens\-endung \code{.ps} nicht eindeutig ist,
müssen wir den gewünschten Typ (\code{dvips config})
für die Datei \file{config.ps} spezifizieren.

\begin{alltt}
> \Ucom{kpsewhich tex.pro}
   /usr/local/texmf/dvips/base/tex.pro
> \Ucom{kpsewhich --format="dvips config" config.ps}
   /usr/local/texmf/dvips/config/config.ps
> \Ucom{kpsewhich psfonts.map}
   /usr/local/texmf/fonts/map/dvips/updmap/psfonts.map
\end{alltt}

Jetzt suchen wir nach den Dateien für den \PS-Zeichensatz ">URW Times"<.
Nach dem Namensschema von Karl~Berry beginnen die Namen mit ">\texttt{utm}"<.
Zunächst suchen wir die Konfigurationsdatei, die den Namen der
Zeichensatzzuordnungsdatei enthält.

\begin{alltt}
> \Ucom{kpsewhich --format="dvips config" config.utm}
   /usr/local/texmf-dist/dvips/psnfss/config.utm
\end{alltt}

Diese Datei enthält folgende Anweisung:

\begin{alltt}
   p +utm.map
\end{alltt}

Die angegebene Datei \file{utm.map} wollen wir als nächstes suchen:

\begin{alltt}
> \Ucom{kpsewhich utm.map}
   /usr/local/texmf-dist/fonts/map/dvips/times/utm.map
\end{alltt}

Diese Zuordnungsdatei wird im Unterverzeichnis \file{urw} bei den
Hilfsdateien für dvips gefunden. Sie enthält die Dateinamen der
Type1-PS-Zeichensätze, die für URW Times benutzt werden. Ein
kleiner Auszug aus dieser Datei:

\begin{alltt}
  utmb8r  NimbusRomNo9L-Medi    ... <utmb8a.pfb
  utmbi8r NimbusRomNo9L-MediItal... <utmbi8a.pfb
  utmr8r  NimbusRomNo9L-Regu    ... <utmr8a.pfb
  utmri8r NimbusRomNo9L-ReguItal... <utmri8a.pfb
  utmbo8r NimbusRomNo9L-Medi    ... <utmb8a.pfb
  utmro8r NimbusRomNo9L-Regu    ... <utmr8a.pfb
\end{alltt}

Wenn wir jetzt beispielsweise nach dem Zeichensatz Times Regular
(\file{utmr8a.pfb}) suchen, finden wir ihn im
Verzeichnis \OnCD{texmf} unter den Type1-Zeichensätzen:

\begin{alltt}
> \Ucom{kpsewhich utmr8a.pfb}
 /usr/local/texmf-dist/fonts/type1/urw/times/utmr8a.pfb
\end{alltt}

Diese Beispiele sollten deutlich gemacht haben, wie leicht bestimmte Dateien
im \TeX-Dateibaum gefunden werden können. Dies ist sehr wichtig, wenn Sie
den Verdacht haben, dass eine falsche Version einer Datei verwendet wird:
Sie lassen sich einfach die verwendete Datei von \cmdname{kpsewhich}
anzeigen.

\subsection{Fehlersuche}
\label{sec:debugging}

\label{fig:dvipsdbga}
\label{fig:dvipsdbgb}
\label{fig:dvipsdbgc}


\section{Einstellungen zur Laufzeit}

\chapter{Danksagungen}

\chapter{Geschichtliches}\label{sec:history}

\section{Vergangenheit}

\section{2003}

\section{2004}

\section{2005}

\section{2006--2007}

\section{2008}

\section{2009}

\section{2010}

\section{2011}

\section{2012}

\section{Gegenwart (\tlcurrentyear)}\label{tlcurrent}
\label{sec:tlcurrent}
\label{sec:2012news}

\section{Zukunft}





\end{document}



\\label\{.*\}