diff options
Diffstat (limited to 'Master/texmf-doc/source/german/texlive-ge/live.tex')
| -rw-r--r-- | Master/texmf-doc/source/german/texlive-ge/live.tex | 3844 |
1 files changed, 3844 insertions, 0 deletions
diff --git a/Master/texmf-doc/source/german/texlive-ge/live.tex b/Master/texmf-doc/source/german/texlive-ge/live.tex new file mode 100644 index 00000000000..da122f2f0c4 --- /dev/null +++ b/Master/texmf-doc/source/german/texlive-ge/live.tex @@ -0,0 +1,3844 @@ +% distribution source: http://www.tug.org/ftp/texlive/Contents/testlive/ ...etc. +% documentation source: http://tug.org/texlive/devsrc/Master/texmf-doc/source/english/texlive-en/ +% $Id: //depot/Master/texmf-doc/source/english/texlive-en/live.tex#16 $ $Author: karl $ $Date: 2004/11/15 $ +% TeX Live documentation. Originally written by Sebastian Rahtz and +% Michel Goossens, now maintained by Karl Berry and others. +% Public domain. +% German translation by Günter Partosch (7.11--22.11.2004) +% 2005 update by Klaus Hoeppner. + +\documentclass[a4paper,twoside,10pt]{article} +\ifnum\Status=1 + % Create A4 pdf + \pdfpageheight297mm + \pdfpagewidth210mm +\fi +\let\tldocgerman=1 % for live4ht.cfg +\usepackage{ngerman} +\usepackage{booktabs} +\usepackage[ngerman]{varioref} +\usepackage{parskip} +%\usepackage{tex4ht} +%\usepackage{hyperref} +\hyphenation{Da-tei-na-men Be-din-gun-gen UNIX Ab-schnitt Kon-fi-gu-ra-tions-da-tei +In-stal-la-tion Al-ter-na-tiv Zei-chen-zu-ord-nungs-da-tei einer eine TEXFONTMAPS} + +\usepackage{tex-live} + +%% perhaps a workaround: (no, it causes all the links to break; cannot +%% use \path here). +%\def\OnCD#1{\href{../../../../#1}{\path{#1}}} + +\newcommand\OptPl{{\ensuremath\rightarrow\ }} +\newcommand\Titlename[1]{{\textsf{#1}}} + +\setlength\marginparwidth{0pt} +\setlength\marginparsep{0pt} +\setlength\evensidemargin{15pt} +\setlength\oddsidemargin{15pt} + +% deutsche typographische Anpassung + % Trennung von tt-Font + \newcommand{\origttfamily}{}% sollte noch nicht definiert sein! + \let\origttfamily=\ttfamily % alte Definition von \ttfamily sichern + \renewcommand{\ttfamily}{\origttfamily \hyphenchar\font=`\-} + + \renewcommand{\samp}[1]{">\mbox{\texttt{#1}}"<} + \renewcommand{\optname}[1]{\mbox{\texttt{#1}}} + \renewcommand{\TypeI}{Type"~1} + \renewcommand{\var}[1]{{\rmfamily\sl #1}} + \renewcommand{\MP}{\textrm{META""POST}} +% \renewcommand{\cmdname}[1]{\textsf{\sc #1}} + \renewcommand{\dirname}[1]{\texttt{#1}}% directory name + \renewcommand{\filename}[1]{\texttt{#1}}% file name + \renewcommand{\KPS}{\cmdname{Kpathsea}} + \renewcommand{\TL}{{{\TeX}\,Live}} + \renewcommand{\MacOSX}{Mac\,\acro{OS\,X}\xspace} + + \newcommand{\ttit}[1]{\texttt{\itshape#1}} + \newcommand{\CDROM}{\acro{CD"~ROM}\xspace} + \newcommand{\pdfTeX}{pdf\TeX\xspace} + \newcommand{\pdfLaTeX}{pdf\LaTeX\xspace} + \newcommand{\plainTeX}{\textrm{plain}\TeX\xspace} + \newcommand{\CDVD}{\acro{DVD} und \acro{CD"~ROM}\xspace} + \newcommand{\pdf}{\acro{PDF}\xspace} + \newcommand{\TUG}{\TeX~Users~Group} + \newcommand{\DTK}{">Die \TeX nische Komödie"<} + \newcommand{\UKTUG}{\acro{UK}{\TeX} Users~Group} + \newcommand{\ME}{Windows\,\acro{ME}\xspace} + \newcommand{\NT}{Windows\,\acro{NT}\xspace} + \newcommand{\XP}{Windows\,\acro{XP}\xspace} + +\newcommand{\deflabel}[1]{\mdseries\cmdname{#1}\hfill} +\newenvironment{deflist}[1]% +{\begin{list}{}% +{\settowidth{\labelwidth}{\bf #1}% +\setlength{\leftmargin}{\labelwidth}% +\addtolength{\leftmargin}{\labelsep}% +\renewcommand{\makelabel}{\deflabel}}}% +{\end{list}} + +%--------------------------------------------------------- +% Fussnoten +%--------------------------------------------------------- +\makeatletter +\renewcommand{\@makefntext}[1]{% +% formatiert die Fussnoten als haengende Absaetze +\setlength{\parindent}{0pt}% +\begin{list}{}{% +\setlength{\labelwidth}{1.0em}% +\setlength{\leftmargin}{\labelwidth}% +\setlength{\labelsep}{3pt}% +\setlength{\itemsep}{0pt}% +\setlength{\parsep}{0pt}% +\setlength{\topsep}{0pt}% +\footnotesize}\item[\hfill\@makefnmark\hfill]#1% +\end{list}% +} +\makeatother + +%--------------------------------------------------------- +% Aufbereitungsvarianten +%--------------------------------------------------------- +%\renewcommand{\Status}{1} +% \Status = 0: TeX Live documentation in DVI format +% \Status = 1: TeX Live documentation in PDF format +% \Status = 2: TeX Live documentation in HTML format +% \Status = 3: TeX Live documentation as a Baskerville issue +% \Status = 4: TeX Live documentation as a TUB article + +\listfiles + +\begin{document} + +\title{% + {\huge \textit{Anleitung zum \protect\TL-System}\\\strut} + {\LARGE \textsf{\TK{} 2005}} +} + +\author{Sebastian Rahtz \& Karl Berry (Herausgeber) \\[3mm] + \url{http://tug.org/texlive/}\\[12mm] +\ifnum \Status=1 + %\includegraphics[width=.7\hsize]{texlive2004-front.pdf} \\[5mm] +\else\ifnum \Status=2 + %\includegraphics[width=.7\hsize]{texlive2004-front.png} \\[5mm] +\fi\fi + \small{\textit{Verantwortlich für die deutsche Ausgabe}}\\[3mm] + \small{Klaus Höppner, \email{klaus@dante.de}} \\ + \small{(DANTE e.V.)} \\[3mm] +% \small{\textit{Ansprechpartner für die Ausgaben in}}\\[3mm] + \small +% \begin{tabular}{lll} +%Englisch & Karl Berry & \email{karl@freefriends.org} \\ %% +%Französisch & Daniel~Flipo \& +% Fabrice Popineau & \email{Daniel.Flipo@univ-lille1.fr} \\ +% & & \& \email{Fabrice.Popineau@supelec.fr} \\ +%Polnisch & Staszek Wawrykiewicz & \email{staw@gust.org.pl} \\ +%Tschechisch & Petr Sojka & \email{sojka@informatics.muni.cz} \\ +%Slowakisch & Jan~Busa & \email{Jan.Busa@tuke.sk} \\ +%Russisch & Boris Veytsman & \email{borisv@lk.net} \\ %% +%Deutsch & Günter Partosch +% \& Hartmut Henkel & \email{Guenter.Partosch@hrz.uni-giessen.de} \\ +% & & \& \email{hartmut_henkel@gmx.de}\\ +% \end{tabular} \\[8mm] + } + + +\date{Oktober 2005} + +\maketitle +\thispagestyle{empty} + +\newpage + +\begin{multicols}{2} + \tableofcontents + \listoffigures + \listoftables +\end{multicols} + +%\renewcommand{\Status}{0} +%\typeout{Status is \Status} + +\clearpage + +% ============================================================== +\section{Einleitung}\label{sec:intro} + +Diese Anleitung beschreibt das \TL-System. Die {\TL} enthält +\TeX/\LaTeX-Systeme für Linux, verschiedene \acro{UNIX}-Plattformen, {\MacOSX} +und (32-Bit)-Windows. \textbf{Warnung:} Für ältere Macintosh-Systeme und \acro{MS-DOS} sind diese +\TeX-Systeme wenig hilfreich. + +{\TL} enthält lauf"|fähige Versionen von \TeX, \LaTeXe, \ConTeXt, \MF, \MP, +\cmdname{Makeindex}, {\BibTeX} und vielen anderen Programmen, +sowie eine umfassende Auswahl an Makros, Zeichensätzen und +Beschreibungen, die gemäß der Standard"=\TeX"=Verzeichnisstruktur (\TDS) +abgelegt sind. {\TL} eignet sich somit zur Nutzung +mit nahezu jeder \TeX"=Installation und erlaubt das Setzen von Schriften +und Texten vieler Sprachen. Es ist Teil der \TK, die in Zusammenarbeit mit den verschiedenen \TeX-Benutzergruppen +entstanden ist und kurz im Abschnitt~\ref{sec:struct-tl} auf Seite~\pageref{sec:struct-tl} beschrieben wird. + +Wenn Sie neuere Versionen der dort aufgeführten Pakete zu suchen wollen, gehen Sie am besten zu \acro{CTAN}: +\url{http://www.ctan.org/}. + +Eine kurze Zusammenfassung der wesentlichen Änderungen der aktuellen \TL-Version +gegenüber der Vorgängerversion finden Sie im Abschnitt~\ref{sec:history} auf +Seite~\pageref{sec:history}. + +%Da diese {\TK} auf einem Medium (\DVD) {\TL} und {\CTAN} +%miteinander verbindet, gibt es im Abschnitt~\ref{sec:ctan} auf Seite~\pageref{sec:ctan} +%einige zusätzliche Informationen über den +%\CTAN-Teil. + +% ------------------------------------------------------------- +\subsection{Einsatzmöglichkeiten des \TL-Systems der \TK}\label{sec:basic} + +% ++++++++++++++++++++++++ +\newcommand{\distribs}{% +% will be used repeatedly +(siehe hierzu Kapitel~\ref{sec:multiple-dist} auf +Seite~\pageref{sec:multiple-dist} über die verschiedenen +Distributionen)} +% ++++++++++++++++++++++++ + +Sie können das \TL-System auf drei verschiedene Arten nutzen: + +\begin{enumerate} +\item Sie können auf Kosten der Ausführungsgeschwindigkeit alle + zu {\TeX} gehörenden Programme direkt von der \pkgname{live}-{\DVD} + starten und auf alle Makros und Zeichensätze zugreifen + \distribs. Dieses Vorgehen benötigt kaum Plattenplatz -- der Geschwindigkeitsverlust kann akzeptiert werden. +\item Sie können das \TL-System komplett (oder Teile davon) auf + einer lokalen Platte installieren. Dies ist sicherlich der Normalfall, + erfordert aber mindestens 100\,MB Plattenplatz. Für das empfohlene + Standardsystem benötigen Sie 310\,MB und für eine Komplettinstallation + bis zu 1,3\,GB an Plattenspeicherplatz. +\item Sie haben die Möglichkeit, Ihr bestehendes \TeX-System durch + Pakete oder Sammlungen von der {\CDVD} zu ergänzen. Dabei ist es + gleichgültig, welches \TeX-System Sie benutzen. +\end{enumerate} + +Alles das wird bei den betreffenden Installationsanleitungen für jedes Betriebssystem +ausführlich erläutert. Hier das Notwendigste: + +\begin{itemize*} +\item Das Hauptinstallationsskript für \acro{UNIX} und {\MacOSX} ist \cmdname{install-tl.sh}. +\item Um ein einzelnes Paket unter \acro{UNIX} zu installieren, benutzen Sie das Skript \cmdname{install-pkg.sh}. +\item Das Windows-Installationsprogramm mit dem Namen \cmdname{tlpmgui.exe} +befindet sich im Verzeichnis \dirname{setup-win32} (siehe dazu Abschnitt~\ref{sec:win-install}). +Mit diesem Programm können Sie auch nachträglich Pakete hinzufügen oder entfernen. +\end{itemize*} + + +% ------------------------------------------------------------- +\subsection{">Wo bekomme ich Hilfe?"< oder ">Hier werden Sie geholfen!"<}\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 ernst gemeint, dass Sie vor einer +Fragestellung Ihre ">Hausaufgaben"< gemacht haben. Falls Sie auf +eine garantierte kommerzielle Unterstützung angewiesen sind oder eine solche +bevorzugen, sollten Sie die Finger vollständig vom \TL-System lassen und +in der Aufstellung unter \url{http://tug.org/interest.html#vendors} nach +einem geeigneten Händler suchen. + +Die folgende Liste stellt die leicht zugänglichen Quellen in der +empfohlenen Reihenfolge vor: + +\begin{description} +\item [Einführung:]\mbox{}\\ + Wenn Sie \TeX-Anfänger sind und eine englische Einführung in das System benötigen, sollten Sie das \acro{WWW}- + Dokument \url{http://tug.org/begin.html} (Englisch) lesen. + + Für deutschsprachige \LaTeX-Anfänger ist die ">\LaTeXe-Kurzbeschreibung"< von großem Nutzen + (\OnCD{texmf-doc/doc/german/lshort-german/}). +\item [\TeX-\acro{FAQ}s:]\mbox{}\\ + Die \TeX-\acro{FAQ} (im Deutschen + \file{de-tex-faq} ">\emph{Fragen und Antworten [\acro{FAQ}] über + das Textsatzsystem TeX und \acro{DANTE}, Deutschsprachige + Anwendervereinigung TeX e.V.}"<) ist ein riesiges Kompendium + mit Fragen (und Antworten) aller Art, von der einfachsten + Anfängerfrage bis zu Expertenwissen. Sie ist Bestandteil + des \TL-Systems (\OnCD{texmf-doc/doc/german/FAQ-ge/}) und umfasst zur + Zeit 182~Seiten als \pdf-Datei (\OnCD{texmf-doc/doc/german/FAQ-ge/de-tex-faq.pdf}). Darüber hinaus ist die + \acro{FAQ} als \HTML-Datei (\OnCD{texmf-doc/doc/german/FAQ-ge/html/index.html}) + und als durchsuchbare Textdatei + (\OnCD{texmf-doc/doc/german/FAQ-ge/text/index.html}) enthalten. + Im Internet finden Sie die \acro{FAQ} unter + \url{http://www.dante.de/faq/de-tex-faq/}; zudem wird die + Text"-ver"-sion regelmäßig zur Monatsmitte in die News-Gruppen + \url{news:de.comp.text.tex}, \url{news:de.answers} und \url{news:news.answers} + verschickt. Die \acro{FAQ} besteht aus mehreren Teilen, wobei + jeder Teil ohne News-Header nicht länger als ca. 32\,KB ist. + + Des Weiteren existiert eine englischsprachige \acro{FAQ}-Sammlung + (\OnCD{texmf-doc/doc/english/FAQ-en/}), die auch im Internet verfügbar ist + (\url{http://www.tex.ac.uk/faq}). + + Bitte nutzen Sie bei Problemen zu allererst diese beiden Möglichkeiten. + +\item [\TeX-Catalogue:]\mbox{}\\ + Wenn Sie auf der Suche nach einem bestimmten Paket, + Font, Programm u.\,ä. sind, empfiehlt sich ein Blick in den + \TeX-Catalogue. Dieser Katalog enthält eine Liste aller verfügbaren + \TeX-spezifischen Dinge (siehe \OnCD{texmf-doc/doc/english/catalogue} oder + \url{http://www.ctan.org/tex-archive/help/Catalogue/}). + +\item [\TeX-\acro{WWW}-Ressourcen:]\mbox{}\\ + Im \acro{WWW}-Dokument \url{http://tug.org/interest.html} finden Sie eine große Anzahl \TeX-spezifischer + Links zu Büchern, Manuals und Artikeln zu allen Aspekten des \TeX-Systems. + +\item [Archive:]\mbox{}\\ + Ein Forum für die Hilfestellung sind die Usenet-News-Gruppen + \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/groups?group=de.comp.text.tex} + starten -- oder auch in \url{http://tug.org/mail-archives/texhax/}. + + Im Allgemeinen ist es recht Erfolg versprechend, eine generelle Suche über Google + \url{http://www.google.de/} durchzuführen (entweder im \emph{WWW} allgemein + oder in den \emph{News-Gruppen}); dies insbesondere, wenn es sich um Fragen über + \PS/{\pdf}, \cmdname{Ghostscript} u.\,ä. handelt. + +\item [Fragen stellen:]\mbox{}\\ + 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/groups?group=de.comp.text.tex}) + oder einen Newsreader. Fragen an die englischsprachige Gruppe + \url{news:comp.text.tex} + (bei Google: \url{http://groups.google.de/groups?group=comp.text.tex}) + sollten Sie bitte nur in Englisch stellen. + + Zusätzlich existieren E-Mail-Diskussionslisten, 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 \acro{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 \acro{FAQ} unter ">\texttt{1.3.2 Was ist TeX-D-L?}"<. + + Bevor Sie aber eine Frage absenden, lesen Sie \emph{bitte} die entsprechenden + Einträge der \acro{FAQ} zum Thema ">\emph{Wie stelle ich eine Frage in einer + Newsgroup, damit ich mit hoher Wahrscheinlichkeit eine Antwort bekomme?}"<. So + z.\,B. ">\texttt{1.3.1 Was ist `de.comp.text.tex'?}"< und ">\texttt{1.3.7 Was + sollte ich gelesen haben, bevor ich eine Frage in `de.comp.text.tex' oder der + Diskussionsliste TeX-D-L stelle?}"< oder auch + \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion}. + +\item [Mithilfe:]\mbox{}\\ + 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{cdrom@dante.de} oder schriftlich an die Geschäftsstelle von + \acro{DANTE}~e.V. 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} + +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. + +% ============================================================== +\section[Struktur des \protect\TeX Live-Systems]{Struktur des \TL-Systems}\label{sec:struct-tl} +% don't use \TL so the \uppercase in the headline works. Also so +% tex4ht ends up with the right TeX. Likewise the \protect's. + +In diesem Abschnitt beschreiben wir Struktur und Inhalt des \TL-Systems und der übergeordneten \TK. + + +% ------------------------------------------------------------- +\subsection[Die Distributionen \protect\pkgname{live}, \protect\pkgname{inst}, \protect\pkgname{protext}]% +{Die Distributionen \pkgname{live}, \pkgname{inst}, \pkgname{protext}}\label{sec:multiple-dist} + +Das Material des \TL-Systems war von Jahr zu Jahr angewachsen und hatte +den Rahmen, der durch die Größe einer {\CDROM} vorgegeben war, gesprengt. Um nicht wieder eine +willkürliche Auswahl unter den unzähligen Paketen, Zeichensätzen und Hilfsprogrammen +treffen zu müssen, wurde schon 2003 der Entschluss gefasst, die {\TK} in +unterschiedliche Distributionen zu zerlegen. Im Einzelnen: + +\begin{deflist}{\pkgname{protext}} +\item [\pkgname{live}] + ist ein vollständiges System auf einer {\DVD}. + Mit mehr als 1,1\,GB ist es zu groß für eine \CDROM. + Es kann auf Festplatte installiert oder direkt von der {\DVD} gestartet werden. + Zusätzlich enthält die {\DVD} unabhängig vom \TL-System die + Mac\TeX-Distribution für \MacOSX, \pkgname{pro\TeX t} -- eine + alternative \TeX-Distribution für MS Windows, die auf \MIKTEX + basiert -- und ein fast vollständiges Abbild des \CTAN-Archivs + (Stand: Oktober~2005) und eine Sammlung verschiedener Pakete in + einem \dirname{texmf-extra}-Verzeichnis. + + Wenn Sie die {\DVD} unter Windows ">mounten"<, bietet Ihnen das Setup-Programm an, \pkgname{protext} zu + starten (siehe unten). Es berücksichtigt dabei auch {\CTAN} und {\TL}, die sich in Unterverzeichnissen der + obersten Stufe auf der {\DVD} befinden. + + Für {\CTAN} und den Verzeichnisbaum \dirname{texmf-extra} gelten andere Weitergabe-Bedingungen als für \TL. + Achten Sie bitte darauf, wenn Sie diese (oder Teile) weitergeben oder modifizieren. + +\item [\pkgname{inst}] + (installable) ist ein Komplettsystem auf \CDROM. Um dies zu ermöglichen, wurden alle Dateien auf dieser {\CDROM} + komprimiert. Daher kann man {\TeX} auch nicht direkt von der \pkgname{inst}-{\CDROM} laufen lassen, sondern muss + es auf der Festplatte \textbf{inst}allieren. + Die Installation entspricht dem Vorgehen bei der Installation von der \pkgname{live}-\acro{DVD} auf der Festplatte und wird in späteren Abschnitten beschrieben. + +\item [\pkgname{protext}] + {\ProTeXt} ist eine Erweiterung der \MIKTEX-Distribution für Windows. Es ergänzt {\MIKTEX} durch + einige Tools (u.\,a. \cmdname{WinEdt}, \cmdname{TeXnicCenter}, \cmdname{Ghostscript}/\cmdname{GSView}), ist + völlig unabhängig vom \TL-System und hat eine eigene + Installation. {\ProTeXt} kann auf Festplatte installiert oder direkt gestartet werden. Informationen + zu {\ProTeXt} finden Sie im \acro{WWW} übrigens unter \url{http://tug.org/protext/}. + + {\ProTeXt} wird sowohl auf der \pkgname{live}-{\DVD} als auch auf einer eigenen {\CDROM} angeboten (für + diejenigen, die die {\DVD} nicht benutzen können). +\end{deflist} + +Welche der drei Distributionen Sie geladen haben, zeigt ihnen die Datei +">\file{00\var{typ}.TL}"< im Wurzelverzeichnis des Verteilungsmediums. Für die +\pkgname{inst}-Version der Distribution finden Sie die Datei mit dem +Namen ">\file{00INST.TL}"<. Die Datei enthält das Release-Datum und +beschreibt den möglichen Einsatz der Distribution und ihre Einschränkungen: + +\begin{small} +\begin{alltt} + This is the TeX Live `inst' distribution. You can *not* run programs + directly from it, you must install it to disk. It includes all packages. +\end{alltt} +\end{small} + +% soll ich das Folgende einfügen: ?? +% vielleicht wie folgt ?? +% Naturally, each user group chooses what to distribute, at its own +% discretion. (\acro{TUG} is sending all three discs above to all of its +% members.) +Alle \acro{DANTE}-Mitglieder erhalten die \TL-{\DVD} als Beilage zur Vereinszeitschrift \DTK. Für all diejenigen, die +nichts mit der {\DVD} anfangen können, ist auf Anfrage auch eine \TL-{\CDROM} erhältlich. Zusätzlich gibt es auch +eine \ProTeXt-\CDROM. Wenden Sie sich bitte an das Büro von \acro{DANTE}, Deutschsprachige Anwendervereinigung TeX e.V., +wenn Sie Interesse an einer der beiden {\CDROM}s haben. + +% ------------------------------------------------------------- +\subsection{Basisverzeichnisse}\label{sec:tld} + +In diesem Abschnitt beschreiben wir die Basisverzeichnisse der \TL-Distribution. + +Auf der \pkgname{live}-\DVD befindet sich die gesamte \TL-Hierarchie im Unterverzeichnis \dirname{texlive} -- nicht +im Wurzelverzeichnis der \DVD. + +\smallskip + +%% \begin{longtable}{@{}>{\ttfamily}lp{.63\hsize}@{}} +%% \hline +%% \rm +%% Verzeichnis & Inhalt \\ +%% \hline +%% \endfirsthead +%% \rm +%% Verzeichnis & Inhalt \\ +%% \hline +%% \endhead +%% \hline +%% \endfoot +\begin{tabular}{@{}>{\ttfamily}lp{.85\linewidth}@{}} +bin & ausführbare Programme des \TeX-Systems; + jeweils für die verschiedenen Rechnerplattformen + in Unterverzeichnissen zusammengefasst \\ +source & Quelldateien aller Programme inklusive der + \Webc-Quellen für die \TeX- und \MF-Pakete als + komprimierte \file{bzip2}"=Archive \\ +support & verschiedene Programme und Hilfspakete, die \emph{nicht} automatisch + mitinstalliert werden, wie z.\,B. Editoren und \TeX-Shells\\ +texmf & Verzeichnisbaum für Programme und 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)\\ +texmf-doc & Verzeichnisbaum mit vollständigen Dokumentationen (ohne andere installierte Dateien); sortiert nach + Sprachen \\ +texmf-var & Verzeichnisbaum für automatisch erzeugte und gespeicherte Dateien + für \TeX, {\MF} und andere (siehe \texttt{TEXMFSYSVAR} im nächsten Abschnitt),\\ +xemtex & Verzeichnis mit nützlichen Programmen für Windows aus dem \XEmTeX-Paket + (Alle diese Programme sind auf \acro{UNIX}-Systemen in + der Regel vorinstalliert oder lassen sich zumindest + leicht kompilieren.) \\ +%%\end{longtable} +\end{tabular} + +\smallskip + +Zusätzlich zu den oben aufgeführten Verzeichnissen finden Sie im Wurzelverzeichnis der Distribution auch noch die +Installationsskripte und die \filename{README}-Dateien in verschiedenen Sprachen. + +Das Verzeichnis \OnCD{texmf-doc} enthält zwar nur Anleitungen, bei weitem aber nicht die gesamte Dokumentation: +Die Dokumentation für Programme (Handbücher, ">man~pages"<, \acro{GNU}-\acro{info}-Dateien) beispielsweise finden Sie +im Verzeichnis \OnCD{texmf/doc}, da die Programme selbst sich im Verzeichnis \OnCD{texmf} befinden. Ähnliches +gilt für die Dokumentation der \TeX-Pakete und -Formate im Verzeichnis \OnCD{texmf-dist/doc}. + +Benutzen Sie die Programme \cmdname{texdoc} oder \cmdname{texdoctk}, 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. + +% ------------------------------------------------------------- +\subsection{Überblick über die vordefinierten texmf-Bäume} +\label{sec:texmftrees} + +Dieser Abschnitt listet alle vordefinierten texmf-Bäume, die vom System benutzt +werden, und deren Bedeutung auf. Das Kommando \cmdname{texconfig conf} +zeigt Ihnen die aktuellen Einstellungen dieser Variablen an. + +\begin{ttdescription} +\item [TEXMFMAIN] In diesem Baum befinden sich wichtige Teile des Systems, + Hilfsprogramme (wie \verb+web2c/mktexdir+), pool-Dateien und andere + Hilfsdateien. +\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 Baum wird von den Hilfsprogrammen von te\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] Dieser Baum wird von den Hilfsprogrammen von te\TeX{} + wie \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 [TEXMFVAR] Dieser Baum wird von Hilfsprogrammen wie \verb+texconfig+, + \verb+updmap+ und \verb+fmtutil+ benutzt, um automatisch generierte + Konfigurations-Dateien abzulegen. +\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. +\end{ttdescription} + +Für näherere Hinweise zu \texttt{texconfig} und zu den davon abhängigen +Hilfsprogrammen siehe Abschnitt~\ref{sec:texconfig} auf Seite~\pageref{sec:texconfig}. + +% ------------------------------------------------------------- +\subsection{\protect\TeX-Erweiterungen}\label{sec:tex-extensions} + +Unter den \TeX-Systemen der {\TL} befinden sich verschiedene +\TeX"=Erweiterungen: + +\begin{deflist}{pdfe\TeX} +\item [\eTeX]\label{text:etex} stellt bei 100\%-iger Kompatibilität zum + normalen {\TeX} einen kleinen, aber mächtigen Satz neuer Befehle + bereit (für Makroexpansion, Character-Scanning, zusätzliche + Klassen für ">marks"<, erweiterte Debug-Möglichkeiten und andere). + 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_man.pdf}. +\item [\pdfTeX] erzeugt optional \pdf-Dateien (Acrobat) anstelle + von {\dvi}-Dateien. Die Dokumentation zu \pdfTeX{} finden Sie unter \OnCD{texmf/doc/pdftex/manual/pdftex-a.pdf}. + In der Datei + \OnCD{texmf/doc/pdftex/manual/samplepdf/samplepdf.tex} finden + Sie ein Anwendungsbeispiel. Das \LaTeX"=Paket \pkgname{hyperref} + besitzt die Option \optname{pdftex}, mit der Möglichkeiten + für aktive Querverweise von {\pdf} (Hypertext) zur + Verfügung gestellt werden. +\item [pdfe\TeX] kombiniert die \pdfTeX- und \eTeX-Erweiterungen. Es ist die voreingestellte ">Engine"< + für alle Formate außer \plainTeX. Näheres finden Sie in der Dokumentation. +\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 ">{\OMEGA}~Translation~Processes"< (\acro{OTP}s), + Transformationen zur Verfügung gestellt, die beliebige Eingaben + vor der Bearbeitung durch {\TeX} nach bestimmten Regeln + umformen. Die (nicht ganz aktuelle) Anleitung zu {\OMEGA} finden + Sie in dem \TL-System in der Datei \OnCD{texmf-dist/doc/omega/base/doc-1.8.tex}. +\item [$\aleph$] (Aleph) vereinigt die \OMEGA- und \eTeX-Erweiterungen. + Eine Minimaldokumentation finden Sie in \OnCD{texmf-dist/doc/aleph/base}. +\end{deflist} + +%\clearpage + +% ------------------------------------------------------------- +\subsection{Weitere Programme der \TL} + +{\TL} enthält eine ganze Reihe unterstützender Programme wie + +\smallskip + +\begin{deflist}{\cmdname{dv2dt, dt2dv}} +\item[\cmdname{bibtex}] Verwalten von Bibliographien +\item[\cmdname{dv2dt, dt2dv}] \file{dvi} nach ASCII und umgekehrt +\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), als Alternative + zu \pdfTeX. +\item[\cmdname{dvilj}] Druckertreiber für die HP-LaserJet"=Familie +\item[\cmdname{lacheck}] \LaTeX-Syntax-Überprüfung +\item[\cmdname{makeindex}] Erzeugen eines Stichwortverzeichnisses +\item[\cmdname{mpost}] \MF-ähnliches Grafikprogramm +\item[\cmdname{psnup}] mehrere logische \PS-Seiten auf einem Blatt platzieren +\item[\cmdname{psselect}] Ausschneiden von Seiten aus \PS-Dateien +\item[\cmdname{tex4ht}] \TeX-nach-\HTML"=Konvertierung +\item[\cmdname{texexec}] \ConTeXt- und PDF"=Prozessor. +\item[\cmdname{xdvi}] \dvi-Bildschirmausgabe im X-Window-System +\end{deflist} + +% ============================================================== +\section{Installation und Anwendung von {\TL} unter \acro{UNIX}}\label{sec:UNIX-install} + +Wie schon in Kapitel~\ref{sec:basic} auf Seite~\pageref{sec:basic} +ausgeführt, können Sie {\TL} auf drei Arten nutzen: + +\begin{enumerate} +\item Sie können das \TL-System direkt vom Verteilungsmedium laufen + lassen (gilt für die \pkgname{live}-\DVD). + +\item Sie können das Gesamtsystem oder Teile davon auf Ihrer Festplatte + installieren (gilt für die \pkgname{live}-\DVD, die \pkgname{inst}- und \pkgname{protext}-\CDROM). + +\item Sie können einzelne Pakete in Ihr bestehendes \TeX-System + integrieren, gleichgültig, ob es ein \TL-System oder ein + anderes ist (gilt für die \pkgname{live}-\DVD, die \pkgname{inst}- und \pkgname{protext}-\CDROM). +\end{enumerate} + +Die folgenden Abschnitte beschreiben für \acro{UNIX} jedes dieser drei +Verfahren ausführlich zum Nachvollziehen. Im Folgenden werden die Eingaben des +Benutzers nach dem Kommando-Prompt \samp{>} \Ucom{unterstrichen} dargestellt. + +\ifSingleColumn \begin{figure}[ht]\noindent \fi +{\centering +\begin{warningbox} +\textbf{Achtung: } Die {\CDROM}s und die {\DVD} der {\TK} wurden im Format ISO-9660 (High Sierra) +mit Rock"~Ridge- und Joliet"=Erweiterungen produziert. Damit Ihr +\acro{UNIX}-Rechner die {\TK} optimal nutzen kann, muss Ihr System diese +Erweiterungen unterstützen. Schlagen Sie in der Systemdokumentation +des Befehls \emph{mount} nach, um zu ermitteln, ob Ihr System diese +Erweiterungen unterstützt. Falls Sie die {\TK} in einem lokalen +Netzwerk einsetzen, suchen Sie sich einen Rechner aus, der die +Erweiterungen unterstützt und ">mounten"< Sie die anderen Rechner auf diesen. + +%\leavevmode\quad +\smallskip +Moderne Linux-, \acro{BSD}-, Sun- und \acro{SGI}-Systeme haben +normalerweise keine Schwierigkeiten, {\TL} zu benutzen. Wenn +Sie ein anderes System einsetzen und {\TL} erfolgreich einbinden +konnten, bitten wir Sie um detaillierte Anweisungen, um diese +Anleitung weiter verbessern zu können. + +%\leavevmode\quad +\smallskip +Der Rest der Anleitung geht davon aus, dass Sie +die {\TK} erfolgreich unter Verwendung der Rock"~Ridge- und +Joliet"=Erweiterungen ">mounten"< konnten. +\end{warningbox}\par} +\ifSingleColumn\end{figure}\fi + +% ------------------------------------------------------------- +\subsection{\protect{\TL} direkt vom Verteilungsmedium starten (\acro{UNIX})} + +% ++++++++++++++++++++++++ +\newcommand{\runlive}{% +% text repeated in windows section +Sie können {\TeX} direkt von der \pkgname{live}-{\DVD} starten, ohne es vorher auf Festplatte installieren zu müssen +(daher der Name {\TeX} ">Live"<). Es ist aber \emph{nicht} +möglich, {\TeX} direkt von den {\CDROM}s laufen zu lassen +(siehe hierzu Kapitel~\ref{sec:multiple-dist} auf +Seite~\pageref{sec:multiple-dist} über die verschiedenen Distributionen). +In den folgenden Installationsschritten benutzen wir ">\texttt{>}"< für +die Eingabeaufforderung und Unterstreichung für Benutzereingaben. +} +% ++++++++++++++++++++++++ + +%\runlive + +% ++++++++++++++++++++++++ +\newcommand{\startinst}{% +% is repeated in other sections +Zuerst ">mounten"< Sie die {\CDROM} oder {\DVD} unter Verwendung der Rock"~Ridge"=Erweiterungen. +Das Kommando hierfür variiert von System zu System; die nachfolgenden Befehle funktionieren +unter Linux; nur der Name des \CDROM-/\DVD-Laufwerks (hier |/dev/cdrom|) muss u.\,U. +angepasst werden. + +\begin{alltt} +> \Ucom{mount -t iso9660 /dev/cdrom /mnt/cdrom} +\end{alltt} + +Wechseln Sie mit Ihrem aktuellen Verzeichnis zum Mount-Point: + +\begin{alltt} +> \Ucom{cd /mnt/cdrom} +\end{alltt} + +Unter {\MacOSX} werden {\CDROM}s und {\DVD}s automatisch ">gemountet"<; +ein \cmdname{mount} ist deshalb überflüssig. Das Verteilungsmedium +wird in das Verzeichnis |/Volumes/| ">gemountet"<. +} + +\def\installtlsh{% +Starten Sie das Installationsskript \filename{install-tl.sh}: + +\begin{alltt} +> \Ucom{sh install-tl.sh}\\ +Welcome to TeX Live... +\end{alltt} + +Nach den Begrüßungsmeldungen und der Ausgabe der Hauptmenü-Liste +werden Sie aufgefordert, ein Kommando einzugeben. Geben Sie die +gewünschte Option ein und schließen Sie die Eingabe mit ">\cmdname{Return}"< +ab. +Bei der Eingabe bleiben Groß- oder Kleinschreibung unberücksichtigt; +in unseren Beispielen benutzen wir die Kleinschreibung.} +% ++++++++++++++++++++++++ + +\runlive +\startinst +\installtlsh + +Um das \TL-System direkt vom Verteilungsmedium laufen zu lassen, müssen wir +als erstes Kommando \Ucom{d} eingeben und dann das Unterkommando \Ucom{1}, +um die Verzeichnisse zu erzeugen. Obwohl wir alle Programme von {\CDROM} oder +{\DVD} laufen lassen, muss trotzdem ein Verzeichnis auf der lokalen Platte +eingerichtet werden, um Dateien, die {\TeX} während der Laufzeiten +erzeugt wurden (beispielsweise Fonts, Formate und geänderte Konfigurationsdateien), +abgelegt werden können. Im folgenden Beispiel benutzen wir +\dirname{/opt/texlive2005} (wenn die Voreinstellung \dirname{/usr/local/texlive2005} +für Sie in Ordnung ist, können Sie den folgenden Schritt überspringen). Wir +empfehlen, das Erscheinungsjahr von \TL{} in den Pfadnamen -- wie oben im +Beispiel -- aufzunehmen, damit ältere \TL-Installationen nicht beeinflusst werden. + +\begin{alltt} +Enter command: \Ucom{d} +Current directories setup: +<1> TEXDIR: /usr/local/texlive2005 +... +Enter command: \Ucom{1} +New value for TEXDIR [/usr/local/texlive2005]: \Ucom{/opt/texlive2005} +... +Enter command: \Ucom{r} +\end{alltt} + +Zurück im Hauptmenü, geben wir unser zweites und letztes +Kommando \Ucom{r} ein, um den Modus ">von \CDROM/{\DVD} laufen lassen (keine +Installation auf Disk)"< zu erreichen: + +\begin{alltt} +Enter command: \Ucom{r} +Preparing destination directories... +... +Welcome to the TeX Live! +> +\end{alltt} + +Nun sind wir wieder zurück am System-Prompt \samp{>}. + +Der letzte Schritt zu einem funktionsfähigen \TL-System ist die +Änderung zweier En"-viron"-ment-Variablen: \envname{PATH} und \envname{TEXMFSYSVAR}. +Die Variable \envname{PATH} muss um das Verzeichnis erweitert werden, in +dem die Programme der verwendeten Architektur liegen; \envname{TEXMFSYSVAR} +erhält die Verzeichnis-Angabe, die oben festgelegt wurde. +In Tabelle~\ref{tab:archlist} sehen Sie eine Liste der verfügbaren +Architekturen für die verschiedenen Systeme. + +% ++++++++++++++++++++++++ +\newcommand{\textruntexconfig}{% +% is repeated in other sections +Direkt im Anschluss an die Installation und das Setzen der +En"-viron"-ment-Variablen wird \cmdname{texconfig} oder \cmdname{texconfig-sys} aufgerufen, +um das \TeX-System an Ihre lokalen Gegebenheiten anzupassen. +Dieser Schritt wird im Abschnitt~\ref{sec:texconfig} auf +Seite~\pageref{sec:texconfig} näher erläutert.} +% ++++++++++++++++++++++++ + +\textruntexconfig + +\begin{table}[tbh!] + \centering +\caption[Unterstützte Betriebssysteme und Architekturen]{Unterstützte Betriebssysteme und Architekturen}\label{tab:archlist} + +\smallskip + +\begin{tabular}{l>{\ttfamily}l} +\hline + Betriebssystem/Plattform & Version \\ +\hline + HP Alpha \acro{GNU}/Linux & alpha-linux \\ +% HP Alphaev5 \acro{OSF} 4.0d & alphaev5-osf4.0d \\ +% HP9000 \acro{HPUX} 10.20 & hppa2.0-hpux10.20 \\ + Intel x86 \MacOSX & i386-darwin \\ + Intel x86 Free\acro{BSD} & i386-freebsd \\ + Intel x86 \acro{GNU}/Linux & i386-linux \\ +% Intel x86 Open\acro{BSD} & i386-openbsd3.3 \\ +% Intel x86 Solaris & i386-solaris2.8 \\ + \acro{SGI} IRIX & mips-irix \\ + \acro{IBM} RS/6000 \acro{AIX} 4.3.* & powerpc-aix \\ + \MacOSX & powerpc-darwin \\ + Sun Sparc \acro{GNU}/Linux & sparc-linux \\ + Sun Sparc Solaris & sparc-solaris \\ + Windows 9X/ME/2K/NT/XP (32\,bit) & win32 \\ + Intel x68 64-Bit \acro{GNU}/Linux & x86\_64-linux \\ +\hline +\end{tabular} + +\end{table}\label{text:path} + +Die Syntax für das Setzen einer En"-viron"-ment-Variable und der Name der +Initialisierungsdatei, in die sie geschrieben wird, hängt von der Shell ab, +die Sie benutzen. Benutzer, die eine Shell einsetzen, die kompatibel zur +Bourne-Shell ist (z.\,B. \cmdname{sh}, \cmdname{bash}, \cmdname{ksh}, usw.), +können die folgenden Zeilen in Ihre Datei \file{\$HOME/.profile} einfügen: + +\begin{alltt} + PATH=/mnt/cdrom/bin/\var{archname}:$PATH; export PATH + TEXMFSYSVAR=/opt/texlive2005/texmf-var; export TEXMFSYSVAR +\end{alltt} + +Für C-Shell-kompatible Shells (z.\,B. \cmdname{csh}, \cmdname{tcsh}) +sind die folgenden Zeilen in die Datei \file{\$HOME/.cshrc} +aufzunehmen: + +\begin{alltt} + setenv PATH /mnt/cdrom/bin/\var{archname}:$PATH + setenv TEXMFSYSVAR /opt/texlive2005/texmf-var +\end{alltt} + +Nach dieser Änderung loggen Sie sich aus und wieder ein und testen +Ihre Installation (siehe Abschnitt~\ref{sec:test-install} auf +Seite~\pageref{sec:test-install}. + +% ++++++++++++++++++++++++ +\newcommand{\textifindoubt}{% +Wenn Sie sich nicht sicher sind, fragen Sie Ihren lokalen System-Guru +um Rat, denn es variiert beispielsweise, wie {\CDROM}s oder {\DVD}s zu ">mounten"< +sind, welche Verzeichnisse benutzt werden dürfen oder wie die Änderungen +in den Initialisierungsdateien vorgenommen werden müssen.} +% ++++++++++++++++++++++++ + +\textifindoubt + +% ------------------------------------------------------------- +\subsection{Installation des \protect\TL-Systems auf der Festplatte}\label{sec:unix-install-disk} + +Es ist sicherlich der Standardfall, das \TL-System auf der +Festplatte zu installieren. Dies kann von der \TK-\DVD +oder der \TL-{\CDROM} erfolgen. +(lesen Sie Abschnitt~\ref{sec:multiple-dist} auf Seite~\pageref{sec:multiple-dist} für eine Erläuterung der verschiedenen Distributionen.) + +\startinst +\installtlsh + +Die Tabelle~\ref{tab:main-menu-options} listet die Optionen +des Hauptmenüs auf. Die Abfolge, in der Sie die einzelnen Optionen auswählen, +ist unerheblich, mit Ausnahme von ">\optname{i}"<, was stets am +Ende steht. Wir erläutern die einzelnen Optionen in der angegebenen +Reihenfolge: + +% apparently here.sty [H] doesn't support table*. + +\begin{table}[H] +\caption{Optionen im Installationshauptmenü}\label{tab:main-menu-options} +\centering +%\begin{tabular}{*{2}{>{\ttfamily}l}l@{}} +\begin{tabular}{@{}>{\ttfamily}lp{0.9\linewidth}} +p & \ttfamily The \optname{p}latform you are running on.\\ + & Plattform ändern\\ +b & \ttfamily The architectures for which to install \optname{b}inaries.\\ + & Programme für andere Plattformen installieren \\ +s & \ttfamily The base installation \optname{s}cheme to use (minimal, recommended, full, etc.\\ + & Installations-Schema auswählen \\ +c & \ttfamily Override the base scheme for individual \optname{c}ollections.\\ + & Installations-Schema ändern \\ +l & \ttfamily Override for \optname{l}anguage collections.\\ + & Sprachschema ändern\\ +d & \ttfamily \optname{D}irectories in which to install.\\ + & Installationsverzeichnisse festlegen \\ +o & \ttfamily \optname{O}ther options.\\ + & allgemeine Installationsoptionen \\ +%r & \optname{r}un off CD or DVD & nichts installieren; Lauf von \CDROM/\DVD \\ +i & \ttfamily Perform the \optname{i}nstallation.\\ + & Installation starten\\ +%h & \optname{h}elp & Hilfe \\ +%q & \optname{q}uit & Ende \\ +\end{tabular} +\end{table} + +Die Optionen im Einzelnen: + +\begin{itemize} +\item [\optname{p}] \textbf{Current platform}: Das Installationsskript versucht + automatisch festzustellen, auf welcher Plattform es + läuft. Im Allgemeinen wird die Plattform korrekt erkannt, so dass diese + Option nur dann benutzt werden muss, wenn die automatische Erkennung versagt + oder überschrieben werden soll. + +\item [\optname{b}] \textbf{Binary architectures}: Im Standardfall werden nur + die Programme der aktuellen Plattform installiert. + Mit Hilfe dieser Option ist es aber möglich, Programme anderer + Plattformen zu installieren -- oder überhaupt keine, wenn Sie die + Programme lieber selber kompilieren möchten. Ersteres kann insbesondere + dann sinnvoll sein, wenn der \TeX-Verzeichnisbaum von mehreren + (heterogenen) Rechnern über ein Netzwerk ge">shared"< wird. Siehe + hierzu die Tabelle~\ref{tab:archlist} + auf Seite~\pageref{tab:archlist} mit den unterstützten Architekturen. + + +\item [\optname{s}] \textbf{Base installation scheme}: In diesem Menü können Sie aus einer Anzahl von vorkonfigurierten + Paket-Zusammenstellungen (">Schema-Definitionen"<) wählen. Die wichtigsten sind: + +\begin{tabular}{@{}lp{0.8\linewidth}} + \hline + Angabe & Inhalt und Verwendung \\ + \hline +\optname{basic} & Diese Angabe ist dann sinnvoll, wenn Sie nur wenig Platz auf der Festplatte haben.\\ +\optname{full} & Dies ist die Voreinstellung. Mit dieser Angabe bekommen Sie einfach alles.\\ +\optname{medium} & Irgendwo dazwischen\\ +\hline +\end{tabular} + + Daneben gibt es u.\,a. auch noch Paket-Zusammenstellungen für {\OMEGA} and \acro{XML}. + +\item [\optname{c}] \textbf{Individual collections}: Über dieses Menü ist es möglich, den + Umfang der zu installierenden Sammlung (aus der Schema-Auswahl) + individuell zu verändern. Sie können den Installationsumfang (und die + Leistungsfähigkeit Ihres Systems) durch An- oder Abwahl von Sammlungen + oder durch Einzelselektion bestimmen. Jede Paketsammlung (\TeX-Makros, + Font-Familien, usw.) besteht aus einer Anzahl von Paketen; hier können + Sie einzelne Pakete hinzu- oder anwählen. Beachten Sie bitte in diesem Menü + die Groß"~/""Kleinschreibung. + +%% \begin{tabular}{c>{\bfseries\sffamily}lc>{\bfseries\sffamily}l} % ?? prüfen, ob die Tabelle noch gilt +%% a & Essential programs and files & o & Basic {\LaTeX}?? packages \\ +%% b & Extra {\BibTeX}?? styles & p & Support for latex3 \\ +%% c & The bare {\TL}?? binaries & s & {\LaTeX}?? supplementary packages \\ +%% d & Chemical typesetting & t & {\LaTeX}?? recommended packages \\ +%% e & Context macro package & u & Advanced math typesetting \\ +%% f & Extra documentation & v & Metapost (and Metafont) drawing \\ +%% g & e\TeX?? & w & {\OMEGA}?? \\ +%% h & {\TeX}?? auxiliary programs & x & {\pdfTeX}?? \\ +%% i & {\TeX}?? font-related programs & y & Drawing and graphing packages \\ +%% j & Recommended extra fonts & z & Plain {\TeX}?? extra macros \\ +%% k & Extra formats & A & {\PS}?? utilities \\ +%% l & Games typesetting (chess, etc & B & Support for publishers \\ +%% m & Miscellaneous macros & C & TrueType font manipulation \\ +%% n & HTML/SGML/XML support & & \\ +%% \end{tabular} + +\item [\optname{l}] \textbf{Language collections}: Dieses Menü hat eine ähnliche Aufgabe + wie \Ucom{c} -- nämlich das vorgegebene Schema zu ändern: Hier können Sie den Installationsumfang für + die Sprachunterstützung festlegen. + + Jede Sammlung besteht aus + verschiedenen Paketen, die Makros, Fonts und Trennmuster enthalten. Beispielsweise + wird das Makropaket \pkgname{frenchle.sty} installiert, wenn die Sprachsammlung + \optname{French} ausgewählt wird. Darüber hinaus hat die Sprachauswahl Einfluss + auf die Konfigurationsdatei \filename{language.dat}. Diese Datei steuert, welche + Trennmuster geladen werden. + +Die Liste für Sprachen der {\TL} umfasst (Hier muss bei den +Auswahl-Buchstaben Groß-/""Kleinschreibung unterschieden werden): + +\bgroup +\centering +\begin{tabular}{@{}p{0.24\linewidth}p{0.20\linewidth}p{0.20\linewidth}p{0.24\linewidth}} % ?? noch ganz grausig +(einige) Afrikanische Skripte & Arabisch & Armenisch & Chinesisch Japanisch Koreanisch \\ +Kroatisch & Kyrillisch & Tschechisch/""Slowakisch & Dänisch \\ +Niederländisch & Finnisch & Französisch & Deutsch \\ +Griechisch & Ungarisch & Indisch & Italienisch \\ +Latein & Manju & Mongolisch & Norwegisch \\ +Polnisch & Portugiesisch & Spanisch & Schwedisch \\ +Tibetanisch & \acro{UK}-English & Vietnamesisch & Hebräisch \\ +\end{tabular} +\egroup + +Der oben angegebenen Reihenfolge der Sprachen liegt die Abfolge der Auswahl-Boxen des Menüs zugrunde. + +\item [\optname{d}] + \textbf{Installation directories}: Die folgenden drei Verzeichnisse können hier + geändert werden:\hfill + \label{text:instdir} + + \begin{ttdescription} + \item [TEXDIR]\mbox{}\\ + ist das Wurzelverzeichnis, unterhalb dessen alles installiert + wird. Die Voreinstellung ist \dirname{/usr/local/texlive2005}; + diese Angabe wird aber meistens verändert. Sie können auf diese + Weise verschiedene \TL-Ausgaben parallel betreiben. Wir empfehlen + daher, die Jahresangabe im Verzeichnisnamen beizubehalten. + Wenn Sie das neue Release ausführlich getestet haben, könnten Sie + dann beispielsweise \dirname{/usr/local/texlive} zu einem + symbolischen Link machen. + + Unter {\MacOSX} wird das \TeX-Front-End üblicherweise in + \dirname{/usr/local/teTeX} gesucht. Sie können also überlegen, + das \TL-System dort zu installieren. + + \item [TEXMFLOCAL:]\mbox{}\\ + In diesem Zweig speichert das \TeX-System üblicherweise die nicht + versionsabhängigen Dateien, vornehmlich Fonts. Die Voreinstellung + ist \dirname{/usr/local/texlive/texmf-local}, unabhängig vom + Release-Jahr der \TL. In diesen Verzeichniszweig gehören + auch alle lokalen Pakete und Konfigurationsdateien. + + \item [TEXMFSYSVAR:]\mbox{}\\ + In diesem Zweig speichert das System die versionsabhängigen + Dateien, insbesondere Format-Dateien und Konfigurationsdateien, die + von \cmdname{texconfig-sys} verändert werden (siehe Abschnitt~\ref{sec:texconfig} + auf Seite~\pageref{sec:texconfig}). Die Voreinstellung ist + \dirname{TEXDIR/texmf-var}. Normalerweise gibt es keinen Grund, diese Einstellung zu ändern. + \end{ttdescription} + +\item [\optname{o}] + \textbf{Other Options}: In diesem Menü können Sie grundlegende Installations-Optionen setzen: + \begin{ttdescription} + \item [a] Hiermit geben Sie ein \textbf{a}lternatives Verzeichnis an, in das generierte + Fonts abgelegt werden dürfen. Standardmäßig wird das durch + \envname{TEXMFVAR} angegebene Verzeichnis benutzt, wie oben beschrieben. + Die Angabe eines alternativen Verzeichnisses ist immer dann sinnvoll, + wenn Sie Ihr Hauptverzeichnis \emph{read-only} setzen wollen und daher + für die dynamisch kreierten Fonts ein anderes -- möglicherweise rechnerspezifisches -- Verzeichnis + benötigen. + + \item [l] Erzeugen symbolischer \textbf{L}inks für Programme, ">man~pages"< + bzw. \acro{GNU}-\acro{info}-Dateien an anderen Stellen; beispielsweise um die + Man-page-Dokumentation unter \dirname{/usr/local/man} und die + Info-Dateien unter \dirname{/usr/local/info} zur Verfügung zu stellen + (Selbstverständlich müssen Sie im Besitz der notwendigen Privilegien + sein, um in die angegebenen Verzeichnisse schreiben zu dürfen.) + + Es ist nicht ratsam, ein schon bereits bestehendes \TeX-System zu überschreiben, + das mit dieser Option erstellt wurde. Die Option ist vielmehr dafür gedacht, + Links in den schon bekannten Standardverzeichnissen (wie z.\,B. \dirname{/usr/local/bin}) + bereit zu stellen. Die betreffenden Verzeichnisse sollten dann aber auch nicht + irgendwelche \TeX-Verzeichnisse enthalten. + + \item [d] Die Installation der + Dokumentation (">\textbf{d}oc"<) für Fonts und Makros wird unterlassen. + Das ist dann sinnvoll, wenn Sie Platz sparen müssen oder die Dokumentation bereits + an anderer Stelle abgelegt haben. + + \item [s] Die Installation des Hauptzweigs mit Fonts und Makros wird übersprungen. + Diese Option wird bei der Einrichtung eines ">\textbf{s}hared"< Betriebs + zwischen Rechnern bzw. Architekturen mittels \acro{NFS} oder + \cmdname{automount} für den Hauptzweig genutzt. + \end{ttdescription} + +\item [\optname{i}] + \textbf{perform installation}: Wenn Sie mit Ihrer Konfiguration + zufrieden sind, starten Sie mit der Eingabe von \Ucom{i} die + Installation vom Medium auf die Festplatte. +\end{itemize} + +Wenn die Installation abgeschlossen ist, so besteht der nächste Schritt +darin, die Variable \envname{PATH} so zu ergänzen, dass die neu-installierten +Programme im architektur-spezifischen Verzeichnis unterhalb von +\dirname{\$TEXDIR/bin} gefunden werden. Die unterstützten Architekturen sind in +der Tabelle~\ref{tab:archlist} auf Seite~\pageref{tab:archlist} zu finden. +Sie können sich aber auch einfach den Inhalt des Verzeichnisses in +\dirname{\$TEXDIR/bin} ausgeben lassen. + +Die Syntax für das Setzen einer En"-viron"-ment-Variable und der Name der +Initialisierungsdatei, in die sie geschrieben wird, hängen von der Shell ab, +die Sie benutzen. Benutzer, die eine Shell einsetzen, die kompatibel zur +Bourne-Shell ist (z.\,B. \cmdname{sh}, \cmdname{bash}, \cmdname{ksh}, usw.), +können folgende Zeilen in Ihre Datei \file{\$HOME/.profile} aufnehmen: + +\begin{alltt} + PATH=/usr/local/texlive2005/bin/\var{archname}:\$PATH; export PATH +\end{alltt} + +Für C-Shell-kompatible Shells (z.\,B. \cmdname{csh}, \cmdname{tcsh}) +sind die folgenden Zeilen in die Datei \file{\$HOME/.cshrc} +aufzunehmen: + +\begin{alltt} + setenv PATH /usr/local/texlive2005/bin/\var{archname}:\$PATH +\end{alltt} + +\textruntexconfig + +Es folgt ein kurzes kommentiertes Beispiel für eine volle Installation der +">Live"<-Version ({\DVD} oder \pkgname{inst}-{\CDROM}) mit den Binärdateien +für das aktuelle System und den oben vorgeschlagenen Verzeichnis-Änderungen. +In diesem Fall ist daher nur das Kommando \Ucom{i} erforderlich. Das Zeichen +">\texttt{>}"< steht wie üblich für den Kommandozeilen-Prompt. + +\begin{alltt} +> \Ucom{sh install-tl.sh} +\Ucom{i} # perform installation +> \Ucom{texconfig} ... +# New PATH, with Linux as the example: +> \Ucom{PATH=/usr/local/texlive2005/bin/i386-linux:\$PATH; export PATH} +\end{alltt} + +\textifindoubt + +% ------------------------------------------------------------- +%\subsection{Installation einzelner Pakete} +\subsection{Installation einzelner Pakete auf einer Festplatte} + +Sie können die {\TL} auch dazu benutzen, ein bestehendes +\TeX-System auf den neuesten Stand zu bringen bzw. die Daten einer +bestehenden Installation durch einzelne Pakete oder Sammlungen zu ergänzen. + +\startinst + +Führen Sie das \emph{für diesen Zweck} vorgesehene Installations-Skript \filename{install-pkg.sh} +aus (das im vorigen Abschnitt vorgestellte Skript \filename{install-tl.sh} ist nur +für eine Erstinstallation gedacht): + +\begin{alltt} +> \Ucom{sh install-pkg.sh \var{Optionen}} +\end{alltt} + +Das Skript kann über Kommandozeilenparameter gesteuert werden. +Die ersten zwei dienen zur Auswahl des zu installierenden Pakets, zur Auswahl +der Sammlung (z.\,B. \samp{tex-mathextra}), zur Angabe des Verzeichnisses, +auf das das Medium ">gemountet"< ist und zur Angabe des Verzeichnisses, das +die Dateilisten der Pakete enthält (diese beiden werden automatisch gesetzt): + +\smallskip + +\begin{deflist}{\texttt{-{}-collection=}\var{coll-name}} +\item[\texttt{-{}-package=}\var{pgk-name}] + Name des gewünschten Pakets (\emph{package}) +\item[\texttt{-{}-collection=}\var{coll-name}] + Name der gewünschten Sammlung (\emph{collection}) +\item[\texttt{-{}-nodoc}] + Dokumentationsdateien nicht mitkopieren +\item[\texttt{-{}-nosrc}] + Quelldateien nicht mitkopieren +\item[\texttt{-{}-cddir=}\var{cd-dir}] + Quellverzeichnis, von dem gelesen wird (Voreinstellung ist + das aktuelle Verzeichnis): Wenn Sie die oben + stehenden Anweisungen befolgt haben, befinden + Sie sich im Distributionsverzeichnis und müssen + keine Änderungen vornehmen. +\item[\texttt{-{}-listdir=}\var{list-dir}] + das sogenannte ">list"<-Verzeichnis innerhalb von + \var{cd-dir}, von dem die Paket-Informationen + gelesen werden: Die Voreinstellung für \var{list-dir} + ist \var{cd-dir}\file{/texmf/tpm/lists}; der einzige + Grund für eine Änderung läge vor, wenn Sie Änderungen + am \TL-System selbst vornähmen. +\end{deflist} + +%\smallskip +Die eigentliche Aktion wird durch weitere Parameter gesteuert. Die ersten beiden +verhindern die Installation der Dokumentation bzw. der Quelldateien +eines Pakets. Der dritte verhindert den Aufruf von \cmdname{mktexlsr} beim +Abschluss der Installation, womit die Datenbank der Verzeichnisstruktur neu +aufgebaut würde. Der vierte Parameter dient zur Anzeige der zu installierenden +Dateien, ohne dass die Installation tatsächlich durchgeführt wird. Der Umfang +der Informationen über die aktuellen Tätigkeiten des Skripts kann vergrößert +werden und zu guter Letzt kann noch aus einem zu installierenden Paket (oder +Sammlung) ein \cmdname{tar}-Archiv erzeugt werden, in dem die Dateien schon die +korrekte \OnCD{texmf}-Verzeichnisstruktur haben. + +\smallskip + +\begin{deflist}{\texttt{-{}-archive=}\var{tarfile}} +\item[\texttt{-{}-listonly}] Auf"|listung, welche Dateien in einem Paket oder einer Sammlung sind; + keine Installation des Pakets +\item[\texttt{-{}-archive=}\var{tarfile}] Statt das angegebene Paket oder die Sammlung zu + installieren, wird ein \cmdname{tar}-Archiv erzeugt. +\end{deflist} + +Zusätzliche Optionen: + +\begin{deflist}{\texttt{-{}-archive=}\var{tarfile}} +\item[\texttt{-{}-nohash}] kein Hash-Lauf von \cmdname{mktexlsr} +\item[\texttt{-{}-config}] nach der Installation einen Konfigurationslauf mit \samp{texconfig~init} durchführen +\item[\texttt{-{}-verbose}] mehr Informationen ausgeben, was das Skript während seines Laufs macht +\end{deflist} + +\smallskip + +Hier einige Beispiele für die Verwendung des Skripts: + +\begin{enumerate} +\item Wollen Sie beispielsweise wissen, welche Dateien mit dem + Paket \pkgname{fancyhdr} installiert werden würden, ist folgender + Befehl einzugeben, der die entsprechende Ausgabe zur Folge hat: + +\begin{alltt} +\ifSingleColumn> \Ucom{sh install-pkg.sh --package=fancyhdr --listonly} +\else> \Ucom{sh install-pkg.sh --package=fancyhdr \bs} +>> \Ucom{--listonly} +\fi{} + texmf/doc/latex/fancyhdr/README + texmf/doc/latex/fancyhdr/fancyhdr.dvi + texmf/doc/latex/fancyhdr/fancyhdr.tex + texmf/tex/latex/fancyhdr/extramarks.sty + texmf/tex/latex/fancyhdr/fancyhdr.sty + .... +\end{alltt} + + \item Installation des \LaTeX-Pakets \pkgname{natbib}: + +\begin{alltt} +> \Ucom{sh install-pkg.sh --package=natbib} +\end{alltt} + +\item Installation des Pakets \pkgname{alg} ohne Quelldateien und + ohne Dokumentation: + +\begin{alltt} +\ifSingleColumn> \Ucom{sh install-pkg.sh --package=alg --nosrc --nodoc} +\else> \Ucom{sh install-pkg.sh --package=alg \bs} +>> \Ucom{--nosrc --nodoc} +\fi\end{alltt} + +\item Installation der Pakete mit zusätzlichen \plainTeX-Makros: + +\begin{alltt} +> \Ucom{sh install-pkg.sh --collection=tex-plainextra} +\end{alltt} + +\item Erzeugen eines \cmdname{tar}-Archivs aller Dateien des Pakets \pkgname{PSTricks} + im Verzeichnis \dirname{/tmp}: + +\begin{alltt} +\ifSingleColumn> \Ucom{sh install-pkg.sh --package=pstricks --archive=/tmp/pstricks.tar} +\else +> \Ucom{sh install-pkg.sh --package=pstricks \bs} +>> \Ucom{--archive=/tmp/pstricks.tar} +\fi\end{alltt} +\end{enumerate} + +\textifindoubt + +% ============================================================== +\section{Installationsnacharbeiten und Wartung}\label{sec:postinstall} + +Nachdem die Hauptinstallation durchgeführt ist, müssen das \TeX-System an Ihre lokalen +Gegebenheiten angepasst und einige Tests durchgeführt werden. + +Eine andere Form der Nacharbeit ist das nachträgliche Installieren +von Paketen, Fonts oder Programmen, die in der {\TL} nicht enthalten sind. +Grundsätzlich empfiehlt es sich, diese Erweiterungen im \envname{TEXMFLOCAL}-Baum +(bei einer Installation auf Festplatte) oder in \envname{TEXMFSYSVAR} (beim ">Live"<-Betrieb) +unterzubringen. Siehe hierzu auch die Ausführungen unter ">Installation directories"< +im Abschnitt~\ref{text:instdir} ab Seite~\pageref{text:instdir}. + +Leider ist dieses Thema nicht völlig trivial und auch für die unterschiedlichen Pakete +(Fonts, Makros, usw.) nicht einheitlich geregelt, so dass es den Umfang dieser Anleitung +sprengen würde, darauf im Detail einzugehen. + +Es gibt einige Beschreibungen in Englisch: + +\begin{itemize*} +\item \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages} +\item \url{http://www.ctan.org/installationadvice/} +\item \url{http://www.ctan.org/tex-archive/info/beginlatex/html/chapter5.html#pkginst}: über die Paketinstallation +\item \url{http://www.ctan.org/tex-archive/info/Type1fonts/}: über die Font"=Installation +\end{itemize*} + +% ------------------------------------------------------------- +\subsection{Konfigurationsprogramm \cmdname{texconfig}}\label{sec:texconfig}\label{ssec:tex} + +Nachdem das Installationsprogramm die benötigten Dateien kopiert hat, +können Sie das Programm \cmdname{texconfig} aufrufen, um das \TeX-System +an Ihre Wünsche und lokalen Gegebenheiten anzupassen. +Sie können dieses Programm aber auch zu jedem anderen Zeitpunkt aufrufen, +um Einstellungen zu ändern und anzupassen. \cmdname{texconfig} ist in dem +plattform-spezifischen Unterverzeichnis \dirname{TEXDIR/bin/}\var{arch} +neben allen anderen Programmen zu finden. + +Starten Sie das Programm ohne Argumente, so wird \cmdname{texconfig} im +Vollbildmodus mit einem maskenbasierten Kommandobildschirm gestartet, +wo Sie die einzelnen Optionen interaktiv kontrollieren und ändern +können. Alternativ können Sie auch auf der Kommandozeilen-Ebene mit +Schaltern die Konfiguration steuern. + +Sie sollten für sämtliche Wartungsarbeiten wie ">Installation neuer Drucker"< +oder ">Neuaufbau der Dateinamen"=Datenbank"< \cmdname{texconfig} verwenden. +Es gibt Hilfstexte mit Erläuterungen für die Fähigkeiten von +\cmdname{texconfig} in beiden Betriebsmodi. + +Einige der am häufigsten benötigten Schalter werden im Folgenden erklärt:% +\footnote{Anmerkung: Die Voreinstellung für das Papierformat im \TL-System ist \optname{a4}.} + +\begin{deflist}{\code {texconfig paper letter}} +\item[\code {texconfig paper letter}] Legt das Standard-Papierformat für verschiedene Programme und Treiber + (\cmdname{pdftex}, \cmdname{dvips}, \cmdname{dvipdfm}, \cmdname{xdvi}) auf ">\optname{letter}"< fest. Eine andere + mögliche Angabe ist \optname{a4}, die auch die Voreinstellung ist. + +\item[\code {texconfig localsetup}] Überprüft, ob die Pfade korrekt sind. + +\item[\code {texconfig rehash}] Neugenerierung aller Dateinamen"=Datenbanken für das \TeX-System nach dem Hinzufügen oder Entfernen von Dateien + +\item[\code {texconfig faq}] Zeigt die \teTeX-\acro{FAQ} an. Beachten Sie auch die \TeX-\acro{FAQ}s in + \OnCD{texmf-doc/doc/english/FAQ-en}. + +\item[\code {texconfig help}] Ausgabe von Hilfetexten für \cmdname{texconfig} +\end{deflist} + +Das Programm \cmdname{texconfig} unterstützt natürlich nur die Änderung von einigen +wenigen (aber viel genutzten) Optionen und Konfigurationsparametern des +\TeX-Systems. Die zugrunde liegende Konfigurationsdatei für alle \Webc-Programme +heißt \filename{texmf.cnf}; Sie können sie mit dem Befehl +\samp{kpsewhich~texmf.cnf} ausfindig machen. Die in der Datei enthaltenen +Kommentare für Voreinstellungen und sinnvolle Alternativeinstellungen helfen +bei eigenen Modifikationen weiter. + +Ab dem Erscheinungsjahr 2005 der \TL{} schreibt \cmdname{texconfig} Änderung +in ein nutzerspezifisches Verzeichnis, nämlich \dirname{\$HOME/.texlive2005}. +Falls Sie \TeX\ nur für sich selbst installieren, ergeben sich keine +wesentlichen Unterschiede zu früher. Falls Sie ein \TeX-System für mehrere +Nutzer administrieren, möchten Sie wahrscheinlich die Konfiguration des +\TeX-Systems für alle Nutzer ändern. In diesem Fall benutzen Sie +\cmdname{texconfig-sys} statt \cmdname{texconfig}. + +Ebenso wurden die Hilfsprogramme \cmdname{updmap} und \cmdname{fmtutil} +so geändert, dass sie sich auf das Verzeichnis \dirname{\$HOME/.texlive2005} +beziehen. Für Änderungen, die alle Nutzer betreffen, benutzen Sie +\cmdname{updmap-sys} bzw. \cmdname{fmtutil-sys}. + +Beispielsweise werden Sie auf einem Multi-User-System die Standard-Formate +mit \texttt{fmtutil-sys -{}-missing} zentral erzeugen wollen, da diese +ansonsten für alle Nutzer individuell erzeugt werden. + +Falls Sie modifizierte Versionen von \filename{fmtutil.cnf} oder +\filename{updmap.cfg} verwenden wollen, müssen diese in dem texmf-Baum +installiert sein, auf den \envname{TEXMFSYSCONFIG} zeigt. + +Für die Übersicht der verschiedenen texmf-Bäume sei auf den +Abschnitt~\ref{sec:texmftrees} auf Seite~\pageref{sec:texmftrees} verwiesen. +Die aktuellen Werte für diese Verzeichnisse erfahren Sie mit dem Kommando +">\texttt{texconfig conf}"< und können in der Datei \filename{texmf.cnf} +geändert werden. +% ------------------------------------------------------------- +\subsection{Testen der Installation}\label{sec:test-install} + +Nachdem Sie das \TL-System installiert haben, wollen Sie es sicherlich auch +testen, um dann in der Lage zu sein, beeindruckende Dokumente bzw. Fonts zu +erzeugen. + +Der folgende Abschnitt stellt einige grundlegende Vorgehensweisen vor, mit +der das neue System auf Funktionsfähigkeit geprüft werden kann. Hier werden +nur die \acro{UNIX}-Kommandos beschrieben, da unter {\MacOSX} und Windows +sicherlich ein \acro{GUI}% +\footnote{\acro{GUI}: Graphical User Interface; Graphische Benutzeroberfläche} +eingesetzt wird, um diese Tests durchzuführen; +grundsätzlich gilt aber das gleiche Prinzip. + +\begin{enumerate} +\item Stellen Sie als erstes sicher, dass das Programm \cmdname{tex} läuft: + +\begin{alltt} +> \Ucom{tex -{}-version} +TeX 3.141592 (Web2C 7.5.5) +kpathsea version 3.5.5 +Copyright (C) 1997-2004 D.E. Knuth. +... +\end{alltt} + +Falls Sie nicht die Versionsnummern und die Copyright-Information sehen, +sondern ">\texttt{command not found}"< (o.\,ä.) erhalten, ist vermutlich die +En"-viron"-ment-Variable \envname{PATH} nicht korrekt gesetzt. Überprüfen Sie, +ob das richtige \OnCD{bin}-Unterverzeichnis in der Variablen \envname{PATH} +enthalten ist. Siehe auch die Informationen zum Setzen des En"-viron"-ments +auf Seite~\pageref{text:path}. + +\item Übersetzen einer Basis-\LaTeX-Datei: + +\begin{alltt} +> \Ucom{latex sample2e.tex} +This is pdfeTeXk, Version 3.141592... +... +Output written on sample2e.dvi (3 pages, 7496 bytes). +Transcript written on sample2e.log. +\end{alltt} + +Wird bei diesem Test die Datei \filename{sample2e.tex} (oder eine +Stildatei) nicht gefunden, liegt vermutlich ein Konfigurationsfehler +oder eine störende En"-viron"-ment-Variable vor. Für eine genauere Analyse ist +es empfehlenswert, {\TeX} über die Dateisuche berichten zu lassen. +Genaueres können Sie im Abschnitt ">Fehlersuche"< auf Seite~\pageref{Debugging} +nachlesen. + +\item Anzeigen der Ergebnisdatei: + +\begin{alltt} +> \Ucom{xdvi sample2e.dvi} +\end{alltt} + +(\textbf{Anmerkung:} Unter Windows heißt das entsprechende Kommando +\cmdname{Windvi}.) Sie sollten jetzt ein neues Fenster sehen, in dem ein Text +mit Erläuterungen über die Grundlagen in {\LaTeX} zu sehen ist. Sollten +{\TeX} und {\LaTeX} Neuland für Sie sein, ist dies ein empfehlenswertes +Dokument. Eine wesentliche Voraussetzung für \cmdname{xdvi} ist, dass +\emph{X-Windows} bei ihnen läuft. Ist dies nicht der Fall oder wurde die +En"-viron"-ment-Variable \envname{DISPLAY} nicht korrekt gesetzt, erhalten +Sie den Fehler \samp{Can't open display}. + +\item Eine \PS-Datei für Druck oder Anzeige erzeugen: + +\begin{alltt} +> \Ucom{dvips sample2e.dvi -o sample2e.ps} +\end{alltt} + +\item Ausgabeformat {\pdf} statt {\dvi}; mit diesem Befehl wird aus der + \filename{.tex}-Datei direkt {\pdf} erzeugt: + +\begin{alltt} +> \Ucom{pdflatex sample2e.tex} +\end{alltt} + +\item \pdf-Datei anzeigen: + +\begin{alltt} +> \Ucom{gv sample2e.pdf} +\textrm{oder} +> \Ucom{xpdf sample2e.pdf} +\end{alltt} + +Leider sind weder \cmdname{gv} noch \cmdname{xpdf} in der aktuellen +{\TL} enthalten. Sie müssen deshalb beide separat installiert werden. +Siehe \url{http://www.gnu.org/software/gv/} und +\url{http://www.foolabs.com/xpdf/} zu Informationen über \cmdname{gv} +bzw. \cmdname{xpdf}. + +\item Weitere Dateien, die für Tests interessant sind: + +\begin{deflist}{\filename{testfont.tex}} % vorher zu unübersichtlich +%\item[\filename{docstrip.tex}] Erzeugt \TeX-Quelle und -Dokumentation aus einer +% \filename{.dtx}-Datei. +\item[\filename{small2e.tex}] einfacheres Dokument als \file{sample2e.exe}, damit bei der + Untersuchung von Problemen eine möglichst kleine Quelldatei vorliegt +\item[\filename{testpage.tex}] erzeugt eine Seite mit Skalen für den Ausdrucktest, + um Drucker-Offsets ermitteln zu können. +\item[\filename{nfssfont.tex}] Testausdruck von beliebigen Fonts +\item[\filename{testfont.tex}] ebenfalls für den Testausdruck von beliebigen Fonts; allerdings in \plainTeX +\item[\filename{story.tex}] Die ">kanonische"< (plain-)\TeX-Datei überhaupt: Sie müssen nach dem + Aufruf von \samp{tex story.tex} nach dem \filename{*}-Prompt noch \samp{\bs bye} eingeben. +\end{deflist} + +Diese \filename{.tex}-Dateien können Sie auf die gleiche Weise bearbeiten +wie im Beispiel \filename{sample2e.tex} weiter oben. +\end{enumerate} + +Falls Sie mit {\TeX} und {\LaTeX} Neuland betreten oder Hilfe bei der +Erstellung von \TeX- und \LaTeX-Dokumenten benötigen, sollten Sie unbedingt +die deutschsprachige Ausgabe der \acro{FAQ}s zu Rate ziehen +(\OnCD{texmf-doc/doc/german/FAQ-ge/de-tex-faq.pdf}). Dort finden Sie im +Abschnitt~2.4.2 ">Frei verfügbare Einführungen in (La)TeX, METAFONT und +verwandte Themen"< Verweise auf ausdruckbare und online-verfügbare +Einführungen. + +Hier sind insbesondere die Broschüren von Manuela~Jürgens von der +Fern-Universität in Hagen zu empfehlen: + +\begin{flushleft} +\begin{itemize} +\item ">\emph{{\LaTeX} -- eine Einführung und ein bisschen mehr \ldots}"< +(\url{ftp://ftp.fernuni-hagen.de/pub/pdf/urz-broschueren/broschueren/a0260003.pdf}) +und +\item ">\emph{{\LaTeX} -- Fortgeschrittene Anwendungen (oder: Neues von den Hobbits)}"< +(\url{ftp://ftp.fernuni-hagen.de/pub/pdf/urz-broschueren/broschueren/a0279510.pdf}) +\end{itemize} +\end{flushleft} + +Ein englischsprachiges \acro{WWW}-Dokument ist unter +\url{http://tug.org/begin.html} zu finden, wo auch andere +Informationsmöglichkeiten aufgeführt sind. + +% ============================================================== +\section{Installation unter \MacOSX}\label{sec:mac-install} +Der empfohlene Weg zur Installation eines \TeX-Systems unter \MacOSX\ ist +die Benutzung der Mac\TeX-Distribution, die im Jahr~2005 neu aufgenommen +wurde. Sie finden Sie auf der \pkgname{live}-\DVD{} im Verzeichnis +\dirname{mactex/}. Die Mac\TeX-Distribution verfügt über ein eigenes +Installationsprogramm für ein vollständiges \TeX-System, das auf te\TeX{} +und \TL{} basiert, und um viele zusätzliche Anwendungen und Anleitungen +ergänzt wurde. Die Homepage des Mac\TeX-Projektes finden Sie unter +\url{http://tug.org/mactex}. + +Alternativ können erfahrene Anwender unter \MacOSX{} ein reines +\TL-System installieren, indem Sie die \filename{install*}-Skripten +verwenden. + +Um diese Installations-Skripte unter {\MacOSX} nutzen zu können, muss die \cmdname{bash}-Shell +installiert sein. Läuft Ihr Rechner unter \MacOSX~10.2 haben Sie bereits die +\cmdname{bash}-Shell und müssen nichts weiter unternehmen. Für Besitzer früherer +Betriebssystem-Versionen ist \cmdname{zsh} die Standard-Shell, mit der die Skripte +nicht funktionieren. Falls Sie die \cmdname{bash}-Shell benötigen, sollten Sie sie +vom Internet laden oder (noch besser) Ihr System auf einen neueren Stand bringen. + +Wenn \cmdname{bash} bei ihnen läuft, können Sie der \acro{UNIX}-Installationsdokumentation +im letzten Abschnitt folgen. Siehe Abschnitt~\ref{sec:UNIX-install} auf +Seite~\pageref{sec:UNIX-install}; Mac\acro{OS}X-spezifische Anmerkungen sind -- wo +notwendig -- bereits im Text enthalten. + +% ============================================================== +\section{Installation und Einsatz unter Windows}\label{sec:win-install} + +Nachdem in der letztjährigen \TL-Ausgabe kein Installationsprogramm für +Windows enthalten war, ist ein solches nun wieder unter dem Namen +\cmdname{tlpmgui.exe} vorhanden, wenn auch noch in einem Anfangsstadium +und als recht experimentell anzusehen. + +\cmdname{tlpmgui.exe} besitzt weitgehend die gleichen Optionen wie das +Installationsskript für \acro{UNIX}, allerdings in Form einer grafischen +Oberfläche. Sie können daher Schemata, Pakete, Verzeichnisse etc. auswählen, +analog zur Beschreibung des Vorgehens für Unix-Systeme in +Abschnitt~\ref{sec:unix-install-disk} auf +Seite~\pageref{sec:unix-install-disk}. Zusätzlich können Sie hier nach einer +erfolgten \TL{}-Installation nachträglich Pakete hinzufügen oder entfernen, +die Datei-Datenbank aktualisieren und Formate erzeugen. + +Falls Sie die technischen Details interessieren: \cmdname{tlpmgui} verwendet +im Hintergrund ein Kommandozeilen-Programm mit dem Namen \cmdname{tlpm}. + +Die unter Windows ausführbaren \TL-Programme basieren auf den neuen +Programmen aus dem \XEmTeX{}-Projekt, dem Nachfolger von \fpTeX{} (siehe +\url{http://www.metz.supelec.fr/~popineau/xemtex-1.html}). Einige Programme +sind ältere (aber hoffentlich noch funktionsfähige) Programme, insbesondere +der \dvi-Viewer \textsf{Windvi}, dessen Benutzung sich an dem auf +Unix-Systemen in der Regel verwendeten \textsf{xdvi} orientiert. Die +Anleitung zu \textsf{Windvi} finden Sie unter +\OnCD{texmf/doc/html/windvi/windvi.html}. Bitte beachten Sie, dass +\textsf{Windvi} nicht mehr weiter entwickelt wird. + +\TL{} kann auf 32"~Bit-Windows-Systemen wie +Windows\,9x, {\ME}, {\NT}, Windows\,2000 (\acro{2K}) oder {\XP} installiert +werden. Ältere Versionen von Windows (3.1x) oder gar \acro{MS-DOS} werden +nicht unterstützt. + +\subsection{Installon von \protect\TeX\protect\ Live auf Festplatte} + +Nach dem Einlegen der \TL-CD in Ihr \acro{CD}-Laufwerk sollte \cmdname{tlpmgui} +automatisch starten. Wenn Sie die \TeX Collection-DVD verwenden, +erscheint ein Auswahl-Menu für die einzelnen auf der DVD enthaltenen +Teile, und \cmdname{tlpmgui} startet nach der Auswahl von \TL. +Ist dies nicht der Fall, weil die Autostart-Option Ihres Systems deaktiviert +ist, wählen Sie auf Ihrem Windows-Desktop \guiseq{Start\arw Ausführen/Run} und +starten \verb|laufwerk:\setup-win32\tplmgui.exe| (von der +\pkgname{inst}-CD) bzw. \verb|laufwerk:\texlive\setup-win32\tplmgui.exe| +(wenn Sie die \pkgname{live}-DVD verwenden). + +Das Installationsprogramm \cmdname{tlpmgui} öffnet ein Fenster mit dem Titel +">\guiseq{TeX Live Installations- und Wartungsprogramm/TeX Live installation +and maintenance utility}"<. Die Sprache Ihres Windowssystem sollte automatisch +erkannt werden, so dass Sie in der Regel eine deutschsprachige Oberfläche +sehen sollten. + +Hier sind folgende Optionsgruppen verfügbar: \guiseq{Anpassung/Main +customization}, \guiseq{Installation/Install}, \guiseq{Schema +auswählen/Select a scheme}, \guiseq{System auswählen/Select systems}, +\guiseq{Verzeichnisse/Directories} and \guiseq{Optionen/Options}. Derzeit +sind noch nicht alle Gruppen wirklich implementiert, einige erscheinen noch +hellgrau und sind inaktiv. + +Im Abschnitt ">\guiseq{Verzeichnisse/Directories}"< sollte Ihr CD/DVD-Laufwerk +bereits neben der Schaltfläche \guiseq{CD/DVD} erscheinen. Falls nicht, +klicken Sie bitte auf \guiseq{CD/DVD} und wählen das Laufwerk aus, +in dem Installationsmedium befindet (bzw. \path|<laufwerk>:\texlive|, wenn +Sie von der \pkgname{live}-DVD installiern). + +Das Ziel-Verzeichnis für die Software-Installation kann über die Schaltfläche +\guiseq{TLroot} ausgewählt werden. Zur späteren Verwendung wird eine +Umgebungsvariable \path|TLroot| auf dieses Verzeichnis gesetzt. Die +Pfade \path|TEXMFTEMP| und \path|TEXMFCNF|, die neben den entsprechenden +Schaltflächen angezeigt werden, werden automatisch auf sinnvolle Werte +gesetzt, können aber auch manuell geändert werden. + +Im Abschnitt ">\guiseq{Schema auswählen/Select a scheme}"< kann das +gewünschte Installations-Schema ausgewählt werden (z.\,B. +\guiseq{scheme-gust}). % TODO: Besseres Beispiel +Zu jedem Schema kann mit \guiseq{Info} ein kurzer Informationstext angezeigt +werden. + +Schemata (schemes) sind große Sammlungen von Paketen für typische +Anwendungsfälle. Es gibt allgemeine Schemata wie \texttt{basic}, +\texttt{medium} und \texttt{full}, wobei wir bei ausreichendem Platz auf +Ihrer Festplatte das Schema \texttt{full} empfehlen. Andere Schemata wurden +speziell für einzelen User Groups zusammengestellt (wie GUST und GUTenberg) +oder betreffen spezielle Anwendungsfälle (z.\,B. für XML-Integration in +\TeX). Ein ausgewähltes Schema kann im Abschnitt ">\guiseq{Anpassung/Main +customization}"< durch die Aus- oder Abwahl von Kollektionen (collections) +in den Auswahlfenstern angepasst werden, die nach Klicken auf +">\guiseq{Standard-Kollektionen}"< oder ">\guiseq{Sprach-Kollektionen/Language +collections}"< erscheinen. So können Sie zum Beispiel durch Auswahl von +">\guiseq{Standard-Kollektionen}"< zusätzliche Pakete wie \MP, Omega oder +Anleitungen in verschiedenen Sprachen auswählen. + +\textbf{Anmerkung:} Die Pakete \guiseq{Ghostscript}, \guiseq{Perl} und +\guiseq{Wintools} sind standardmäßig ausgewählt und sollten auf jeden +Fall installiert werden, da deren Installation für viele Programme +notwendig ist -- es sei denn, sie sind bereits anderweitig installiert und +Sie kennen sich gut mit Ihrem System aus. Von diesen Tools werden die +Umgebungsvariablen \verb|PERL5LIB| und \verb|GS_LIB| gesetzt. + +Im Bereich ">\guiseq{Sprach-Kollektionen}"< im Abschnitt +\guiseq{Anpassung/Main customization} können Sie durch +Haken auswählen, welche Sprachunterstützungen installiert werden sollen. + +Zum Starten der Installation klicken Sie auf die Schaltfläche +\guiseq{Installieren} im Abschnitt ">\guiseq{Installation}"<. + +Während der Installation sehen Sie rechts unten einen Statusbalken. Solange +die Daten von dem Installationsmedium auf die Festplatte kopiert werden, +füllt sich dieser langsam (und damit meinen wir wirklich langsam) von links +nach rechts. Die Installation erfordert nach dem Kopieren auf die Festplatte +mehrere zusätzliche Schritte wie Erzeugen der Formate, Aufbau der +Datei-Datenbank, Setzen von Umgebungsvariablen etc. Dies kann einige Zeit in +Anspruch nehmen, während der der Statusbalken periodisch von links nach +rechts und zurück wandert. Warten Sie auf jeden Fall, bis der erfolgreiche +Abschluss der Installation gemeldet wird. + +In Ihrem Windows-System wird eine Programmgruppe +\guiseq{Start\arw Programme\arw TeXLive2005} mit dem Installationsprogramm +\cmdname{tlpmgui} eingerichtet. + +Arbeiten Sie unter Windows\,9x/""\ME, müssen Sie einen Windows-Neustart +durchführen. + +% ------------------------------------------------------------- +\subsection{Installation von Support-Paketen für Windows}\label{sec:win-xemtex} + +Für ein vollständiges \TL-System werden noch eine Reihe von +Paketen benötigt, die üblicherweise nicht zum Standard-Repertoire +von Windows gehören. Hierzu gehören \cmdname{Perl}, der +\PS-Interpreter \cmdname{Ghostscript} und eine +graphische Toolbox; zudem kann ein \TeX-orientierter +Editor eine deutliche Erleichterung bei der Tipparbeit darstellen. + +Alle diese Programme sind für Windows verfügbar; und um das Leben +ein bisschen einfacher zu machen, sind sie auch in {\TL} +vertreten: + +\begin{itemize} +\item GNU \cmdname{Ghostscript}~7.07 +\item eine minimale Installation von \cmdname{Perl} 5.8, die für die + Perl-Skripte von \TL{} benötigt werden +\item win-tools ist eine Sammlung von Programmen wie bzip2, gzip, jpeg2ps + und tiff2png +\end{itemize} + +Diese Programme stammen aus der \XEmTeX{}-Distribution, dem Nachfolger +von fp\TeX. + +Perl und Ghostscript werden automatisch installiert, wenn Sie es nicht +explizit abgewählt haben. Tun Sie dies nur, wenn Sie sicher sind, dass +diese Programme bereits installiert sind. + +Wenn Sie diese Sammlung nicht installieren möchten, sind Sie auf sich +gestellt, die notwendigen Tools und Pakete zur Vervollständigung Ihres +\TL-System verfügbar zu machen. Nachfolgend finden Sie eine Liste +der Tools und die zugehörigen Adressen, wo Sie sie herunterladen können: + +\begin{description} +\item[\cmdname{Ghostscript}:]\mbox{}\\ + \url{http://www.cs.wisc.edu/~ghost/}, in der {\TL} + finden Sie die Version 8.53 unter + \href{ftp://ftp.dante.de/tex-archive/nonfree/support/ghostscript/AFPL/}{\texttt{ctan/nonfree/support/ghostscript/AFPL}} +\item[Perl:]\mbox{}\\ + \url{http://www.activestate.com/} (zusätzliche + \cmdname{Perl}-Module erhalten Sie von \acro{CPAN}: + \url{http://www.cpan.org/}) +\item[ImageMagick:]\mbox{}\\ + \url{http://www.imagemagick.com/} +\item[NetPBM:]\mbox{}\\ + als Alternative zu \cmdname{ImageMagick} können + Sie \cmdname{NetPBM} für die Bearbeitung und Konversion + Ihrer Graphikdateien benutzen. Die \cmdname{NetPBM}-Homepage + ist \url{http://netpbm.sourceforge.net/}. +\item[\TeX-Editoren:]\mbox{}\\ + Die Zahl der Editoren ist groß -- und da es meist + Geschmackssache ist, hier eine kleine Auswahl: + \begin{itemize*} + \item \cmdname{GNU~Emacs} ist als Windows-Version verfügbar; siehe + \url{http://www.gnu.org/software/emacs/windows/ntemacs.html}. + \item \cmdname{XEmacs} ist ebenfalls unter Windows verfügbar; siehe + \url{http://www.xemacs.org/}. + \item \cmdname{WinShell} ist in der {\TL} im Verzeichnis \path|support| vorhanden, + die URL ist \url{http://www.winshell.de/}. + \item \cmdname{WinEdt} ist ein Shareware-Editor erhältlich unter der + URL \url{http://www.winedt.com/}. In der {\TL} (\DVD) sind die + aktuellen Programme, Erweiterungsmakros und Wörterbücher in + dem Verzeichnis \href{ftp://ftp.dante.de/tex-archive/nonfree/systems/win32/winedt/}{\texttt{ctan/nonfree/systems/win32/winedt/}} + enthalten. + + Mitglieder von \acro{DANTE}~e.V. können über den Verein preisgünstige + Lizenzen erhalten (siehe \url{http://www.dante.de/dante/lizenzen/winedt/}). + \item \cmdname{vim} finden Sie auf der {\TL} im Pfad + \OnCD{support/vim}; die Referenz-URL ist \url{http://www.vim.org/}. + \item TeXnicCenter ist eine freie Oberfläche, erhältlich von + \url{http://www.toolscenter.org} und innerhalb von proTeXt. + \item \cmdname{LEd} ist unter \url{http://www.ctan.org/support/LEd} + erhätlich + \item \cmdname{SciTE} kann unter der URL \url{http://www.scintilla.org/SciTE.html} + geladen werden. + \end{itemize*} +\end{description} + +Sie werden sicherlich weitere Tools installieren wollen, die ">nicht +frei"<\footnote{Die Festlegung ">\emph{nicht frei}"< folgt den Richtlinien +für ">freie Software"<. Es heißt +nicht, dass Sie die Software nicht auch kostenlos bekommen können.} +sind und deshalb auf der {\TL} fehlen, so zum Beispiel \cmdname{GSView}. +Dieser Begleiter von \cmdname{Ghostscript}, der das Anschauen von +\PS-/\pdf-Dateien vereinfacht, ist erhältlich unter der URL +\url{http://www.cs.wisc.edu/~ghost/gsview/} oder +\href{ftp://ftp.dante.de/tex-archive/nonfree/support/ghostscript/ghostgum/}{\texttt{CTAN:nonfree/support/ghostscript/ghostgum}}. + +%\clearpage + +% ------------------------------------------------------------- +\subsection{Wartung Ihrer Installation} + +Wenn Sie Ihr \TL-System installiert haben, können Sie das System mit dem +Aufruf von \cmdname{tlpmgui} modifizieren. + +\subsubsection{Hinzufügen und Entfernen von Paketen} +Starten Sie \cmdname{tlpmgui} aus der Programmgruppe +\guiseq{Start\arw Programme\arw TeXLive2005}, die während der Installation +angelegt wurde. Das Fenster mit dem Titel ">\guiseq{TeX Live Installations- +und Wartungsprogramm}"< erscheint. Hier sind mehrere Bereiche als +Karteireiter vorhanden: +\guiseq{Pakete hinzufügen/Add Packages}, +\guiseq{Pakete entfernen/Remove packages}, +\guiseq{Installation bearbeiten/Manage installation}, +\guiseq{Installation entfernen/Remove installation}. + +Das Arbeiten mit ">\guiseq{Pakete hinzufügen}"< bzw. ">\guiseq{Pakete +entfernen}"< ist im Wesentlichen identisch: +\begin{itemize} +\item Wählen Sie im ersten Abschnitt Ihr Laufwerk mit dem Installationsmedium + aus (bzw. \path|<laufwerk>:\texlive| von der DVD). +\item Klicken Sie auf die Schaltfläche ">\guiseq{Suchen/Search}"<, um im + Abschnitt ">\guiseq{Auswahl der zu \dots{} Pakete/Select packages + to\dots}"< die Liste der zu (de)installierenden Pakete zu aktualisieren. + + Wenn Sie Pakete hinzufügen wollen, wird die Liste der bereits installierten + Pakete mit den auf der CD/DVD vorhandenen Pakete abgeglichen. Es werden nur + die Pakete angezeigt, die noch nicht installiert wurden, aus denen Sie + dann Ihre Auswahl treffen können. + + Wenn Sie Pakete entfernen wollen, werden nur die tatsächlich installierten + Pakete zur Deinstallation angeboten. + + Beachten Sie, dass in der Auswahlliste zuerst komplette Kollektionen + (Collections) erscheinen. + +\item Wählen Sie die zu (de)installierenden Pakete aus. Durch Auswahl von + \guiseq{Info} erhalten Sie jeweils kurze Informationen zum ausgewählten + Paket. Zur Auswahl mehrerer Pakete halten Sie bei der Auswahl die + Control- bzw. Strg-Taste oder die Shift-Taste gedrückt. + +\item Klicken Sie auf \guiseq{Installieren} bzw. \guiseq{Entfernen}, um die + (De)Installation durchzuführen. +\end{itemize} + +\subsubsection{Konfiguration und Verwaltung} + +Die Funktionen im Bereich ">\guiseq{Installation bearbeiten/Manage the +installation}"< sind hilfreich, wenn Sie die Unterstützung für weitere +Sprachen hinzufügen möchten, die Sie bei der Installation nicht ausgewählt +hatten. Weiterhin können Sie die \TeX-Formate neu generieren, sei es, weil +Sie sie noch nicht installiert hatten oder Sie Änderungen an Ihrem System +vorgenommen haben, die eine Neugenerierung der Formate erfordern (z.\,B. die +Installation weiterer Trennmuster). + +\subsubsection{Deinstallation von \TL} + +Die Schaltfäche ">\guiseq{Installation entfernen/Remove the installation}"< +öffnet ein Fenster, dessen Funktionalität wir hier nicht näher beschreiben +wollen, da wir nicht wissen, warum man dies tun sollte \dots + +Beachten Sie, dass eine Deinstallation einen lokalen texmf-Baum unter +\path|texmf-local| nicht betrifft. Sie brauchen also keine Sorgen zu haben, +dass Ihre lokalen Ergänzungen auf einmal verschwinden. Das Verzeichnis +\path|setup-win32|, in dem sich das Installationsprogramm \cmdname{tlpmgui} +und davon benötigte Dateien befinden, wird ebenfalls nicht gelöscht und +muss von Ihnen für eine restlose Deinstallation manuell gelöscht werden. + +\subsection{Hinzufügen eigener Pakete zur existierenden Installation} + +Das Hinzufügen eigener Pakete zur Installation setzt etwas Detail\-kenntnis +voraus. Ein häufig auftretendes Problem ist, dass Sie niemals vergessen +dürfen, nach eigenen Änderungen die Datei-Datenbank (die aus Gründen, die +aus der \acro{UNIX}-Welt stammen, \texttt{ls-R} heißt) aufzufrischen. +Ansonsten werden Ihre neuen Dateien nicht gefunden! Sie können dies entweder +mit \cmdname{tlpmgui} durch die entsprechende Schaltfläche im Bereich +">\guiseq{Installation bearbeiten}"< oder durch direktes Aufrufen von +\file{mktexlsr} tun. + +Wenn Sie Pakete hinzufügen wollen, die nicht zur \TL-Distribution gehören, +sind diese im \path|texmf-local|-Baum am Besten aufgehoben. Dort sind +Ihre Dateien vor einem Upgrade oder einer Deinstallation von \TL{} sicher. + +Das Verzeichnis \path|texmf-local| ist zunächst leer. Wenn Sie dort neue +Dateien hinzufügen wollen, müssen diese innerhalb dieses Baumes so abgelegtgq +werden, dass es der standardisierten \TeX-Verzeichnisstruktur TDS entspricht. +Wollen Sie also z.\,B. Style-Dateien für das Mathematik-Programm Maple +hinzufügen, sind diese unter +\path|c:\TeXLive2005\texmf-local\tex\latex\maple| und die zugehörige +Dokumentation unter \path|c:\TeXLive2005\texmf-local\doc\latex\maple| gut +aufgehoben. + +\subsection{Benutzung von \texttt{tlmp.exe} in der Kommandozeile} + +Das Programm \cmdname{tlpm.exe}, das von \cmdname{tlpmgui} im Hintergrund +benutzt wird, enthält einige weitere nützliche Optionen. Einen Überblick +erhalten Sie durch den Aufruf +\begin{verbatim} + tlpm --help +\end{verbatim} + +Weitere Informationen finden Sie auf englisch in der Datei \path|tlpm.readme|. + +\subsection{Installation im Netzwerk} +\KPS{} unterstützt inzwischen die von Windows verwendeten UNC-Namen, so +dass Sie Ihren texmf-Baum auch über das Netzwerk verwenden können. + +Im folgenden beschreiben wir den Fall, dass Sie ein Multiplattform-System +über das Netzwerk zugänglich machen wollen. + +Alle Dateien einer \TL-Installation außer den Programmen in den +\path|bin|-Verzeichnissen sind von der Betriebssystem"=Plattform unabhängig, +so dass es möglich ist, dass über Samba ein Windows-Client eine +\TL-Installation von einem \acro{UNIX}-Server oder ein \acro{UNIX}-Rechner +auf einen Windows-Server zugreift. Hierbei sind mehrere Szenarien denkbar: +\begin{itemize} +\item Komplettinstallation auf einem Server. Hier müssen Sie unterhalb des + \path|bin|-Verzeichnisses die ausführbaren Programme für die gewünschten + Plattformen installieren, also z.\,B. \path|bin/win32| und + \path|bin/i386-linux|. Anschließend müssen Sie Ihren Pfad und die + Umgebungsvariablen konfigurieren. Für Windows können Sie UNC-Namen benutzen. +\item Lokale Kopie der ausführbaren Programme und der \TeX-Formate. In diesem + Fall müssen Sie die Umgebungsvariable \verb|$TEXMFMAIN| auf den globalen + texmf-Baum zeigen lassen, der auf dem Server liegt. Setzen Sie die + Variable \verb|$TEXMFVAR| auf ein lokales Verzeichnis, in dem Sie die + Konfigurationsdateien und automatisch generierte Dateien ablegen können. +\end{itemize} + + +% ------------------------------------------------------------- +\subsection{Win32-Unterschiede zum Standard-\Webc} + +Die Win32-Version von {\Webc} hat einige spezifische Eigenschaften, +die hier näher erklärt werden. + +\begin{description} +\item[{\KPS}:]\mbox{}\\ + Die von {\KPS} aufgebauten Hash-Tabellen sind bei {\TL} + sehr groß. Um die Startzeit für jedes Programm, das {\KPS} + benutzt, zu verkürzen, wurden diese Hash-Tabellen in das + ">Shared Memory"< gelegt. Dadurch kann der Overhead, der beim + zyklischen Aufruf von Programmen auftritt, wenn \file{tex} + beispielsweise \file{mpost} aufruft, das wiederum \file{tex} + ruft, vermindert werden. Diese Änderung wird vor dem Benutzer + versteckt, außer wenn das Debug-Flag bei \cmdname{kpathsea} + auf \file{-1} gesetzt wird. Dann wird der Zugriff zum + Shared-Memory aufgezeichnet, was sicherlich nicht das ist, + was Sie wollen (es wird nämlich \textbf{sehr} häufig angesprochen!). + Die wirklich erforderlichen Trace-Daten für den Zugriff auf + das Shared-Memory müssen noch definiert werden; dies ist + sicherlich eine Aufgabe für die Zukunft. +\item[\cmdname{kpsecheck}:]\mbox{}\\ + Dieses Kommando bietet einige Optionen, die nicht zu den Aufgaben + von \cmdname{kpsewhich} gehören und deshalb auch dort schlecht passen. + Mit \cmdname{kpsecheck} können Sie alle Dateinamen auf"|listen, die + mehrfach in verschiedenen Zweigen des \OnCD{texmf}-Baums auftreten. + Dies ist bei der Dateisuche sehr praktisch; die meiste Zeit werden Sie + allerdings unerwünschte Angaben bekommen, beispielsweise von dutzendweise + vertretenen \file{README}-Dateien. Es bleibt festzustellen, + dass alle diese Dateien zu Problemen beim \KPS"=Hash"=Mechanismus + führen; glücklicherweise wird nach diesen Dateien nie gesucht. + Deshalb kann die Option \mbox{\file{-multiple-occurrences}} mit zwei + weiteren Optionen zum Ein- oder Ausschluss von Dateinamen, die + einem bestimmtem Muster entsprechen, kombiniert werden. Es können + mehrere Muster angegeben werden. + + Das Kommando \cmdname{kpsecheck} gibt auch Auskunft über den Status + des Shared-Memories: ">in~use"< oder ">not~used"< (">in Benutzung"< oder + ">nicht benutzt"<). Das kann von Nutzen sein, da ein Aufruf von + \cmdname{mktexlsr} so lange nicht ausgeführt wird, wie noch ein + Prozess das Memory nutzt und der Status somit als ">in~use"< + angegeben wird. + + Mit diesem Kommando kann auch das Installationsverzeichnis von + \cmdname{Ghostscript} festgestellt werden. Für viele Programme + unter Win32 ist es einfacher, die \cmdname{Ghostscript}-DLL zu benutzen + und mittels des Registry-Keys von \cmdname{Ghostscript} das Verzeichnis + zu finden, als den \file{PATH} zu ändern (der sowieso eine begrenzte + Länge hat). + +\item[\Webc:]\mbox{}\\ + Die \TeX-Engines unter Windows besitzen gegenüber der \Webc-Standardversion + einige zusätzliche Optionen; + zudem hat eine Option ein anderen Verhalten: + \begin{itemize} +%% \item das Verhalten der \file{-fmt}-Option unterscheidet sich +%% vom Standard. Früher und mit der Standardversion von {\Webc} +%% hat diese Option zwei unterschiedliche Bedeutungen, je nachdem, +%% ob sie in ">ini"<"= oder ">vir"<"=Modus benutzt wird. +%% Unter Windows gibt es keinen Unterschied: Es wird immer das +%% angegebene Format geladen. Um die Bedeutung im ">ini"<"=Modus +%% zu erhalten, wurde die Option ">\optname{-job-name}"< eingeführt. +%% \item \file{-job-name}\mbox{\ }\newline +%% erlaubt die Bestimmung des Dateinamens als Ergebnis eines +%% Compiler-Laufs. Im normalen Modus ändert dies den Basisnamen +%% aller erzeugten Dateien (\file{.dvi}, \file{.aux}, usw.), +%% während im ">ini"<"=Modus der Name der Format-Datei festgelegt +%% wird. + \item \optname{-halt-on-error}\mbox{\ }\newline + Stoppt die Übersetzung nach dem Auftreten des ersten Fehlers. + \item \optname{-job-time}\mbox{\ }\newline + Setzt die ">job~time"< auf die Zeit, die die Datei im Argument + trägt. + \item \optname{-oem}\mbox{\ }\newline + Benutzt die \acro{DOS}-Codepage für alle Konsol-Ausgaben. + \item \optname{-output-directory}\mbox{\ }\newline + Alle Ausgabedateien werden in das angegebene Verzeichnis + geschrieben. + \item \optname{-time-statistics}\mbox{\ }\newline + Ausgabe der Job-Statistik: Da Windows\,9x kein echtes + Multi"~Tasking-Betriebssystem ist, besitzt es keinen Timer für + kurze Zeitabläufe. Die ausgegebenen Zeiten sind daher + Annäherungen. Unter {\NT}/Windows\,2000 und {\XP} sind die + angegebenen Zeiten für Usertime und Systemtime recht genau. + Hinweis für \acro{UNIX}-Benutzer: Das Kommando \cmdname{time} + steht Windows-Benutzern nicht zur Verfügung. + \end{itemize} +\end{description} + +% ------------------------------------------------------------- +\subsection{Persönliche Konfiguration} + +% .............................................................. +\subsubsection{\dvips} + +Die Konfigurationsdatei für {\dvips} ist so eingestellt, dass die \TypeI"=Fonts +genutzt werden. Anpassungen sind notwendig, falls stan"-dard"-mä"-ßig eine andere +Papiergröße als DIN\,A4 verwendet werden soll. + +Öffnen Sie die Datei |c:\TeXLive2005\texmf-var\dvips\config\config.ps| +mit einem Editor. + +\begin{description} +\item[Fonts:]\mbox{}\\ + Sie können damit die Voreinstellungen für den \MF-Drucker-Modus und die Drucker"-auf"|lö"-sung ändern. Das könnte + dann erforderlich sein, wenn {\dvips} \acro{PK}-Dateien generieren müsste. In der Voreinstellung ist {\dvips} so + konfiguriert, dass die \TypeI-Versionen der CM-Fonts benutzt werden. \cmdname{mktexpk} sollte deshalb nicht allzu + oft gerufen werden. +\item[Printer:]\mbox{}\\ + Sie können einen Standarddrucker einrichten. + Steht die Option \samp{o} ohne weitere Zeichen allein + auf der Zeile, wird ein \file{.ps}-File geschrieben. + Sie können nun \cmdname{dvips} Druckernamen in folgender + Weise vorgeben:\\ + \hspace*{1em} \optname{o lpt1:} \\ + \hspace*{1em} \verb+% o | lpr -S server -P myprinter+ \\ + \hspace*{1em} \verb+% o \\server\myprinter+ +\item[Paper:]\mbox{}\\ + Für die Änderung der Standard-Papiergröße von DIN\,A4 auf + beispielsweise ">US letter"<, müssen Sie dafür sorgen, + dass ">US letter"< die erste in der Datei aufgeführte + Papiergröße ist. Suchen Sie den Block mit Zeilen, + die mit \samp{@} beginnen. Verschieben Sie die + folgenden Zeilen an den Beginn dieses Blocks:\\ + \hspace*{1em} \optname{@ letterSize 8.5in 11in} \\ + \hspace*{1em} \optname{@ letter 8.5in 11in} \\ + \hspace*{1em} \optname{@+ \%\%BeginPaperSize: Letter} \\ + \hspace*{1em} \optname{@+ letter} \\ + \hspace*{1em} \optname{@+ \%\%EndPaperSize} +\end{description} + +Speichern Sie die Einstellungen. + +Die aktuelle \TL-Distribution enthält Mechanismen, die dafür sorgen, dass die +Font"~Map-Dateien für {\dvips} und {\pdfTeX} immer auf den neuesten Stand +gehalten werden. Das geschieht während der \TeX-Installation wie auch bei der +Installation neuer Pakete durch das Programm \cmdname{updmap}. Sollten Sie +ein neues Paket per Hand installieren, müssen Sie die Datei \file{updmap.cfg} +in \verb|$TEXMFVAR/web2c| entsprechend editieren. + +% .............................................................. +\subsubsection{\pdfTeX} + +Wenn Sie {\pdfTeX} oder {\pdfLaTeX} benutzen, um direkt \pdf-Dateien zu +erzeugen und nicht das standardmäßige Papierformat DIN\,A4 benutzen wollen, +müssen Sie in der Konfigurationsdatei +|c:\TeXLive2005\texmf-var\tex\generic\config\pdftexconfig.tex| die +Anweisungen \samp{\bs pdfpagewidth} und \samp{\bs pdfpageheight} entsprechend +ändern. + +Die Anweisungen heißen jetzt: + +\begin{alltt} + \bs{}pdfpagewidth=8.5 true in + \bs{}pdfpageheight=11 true in +\end{alltt} + +Speichern Sie die Datei und verlassen den Editor. + +% .............................................................. +\subsubsection{\cmdname{GSView}} + +\cmdname{GSView} unterliegt jetzt der Aladdin-Lizenz und kann deshalb nicht +mehr mit {\TL} verteilt werden. Sie können es aber jederzeit von einem der +\acro{CTAN}-Server laden (im Verzeichnis +\href{ftp://ftp.dante.de/tex-archive/nonfree/support/ghostscript/ghostgum/}{\texttt{nonfree/support/ghostscript/ghostgum}}). + +In \cmdname{GSView} können Sie das Papier-Standardformat über die Menü-Option +\textbf{Formate} festlegen. Wählen Sie hier das gewünschte Format aus +der Liste, beispielsweise \textbf{A5}. + +Beachten Sie die Menü-Optionen, die Ihnen erlauben, eine optimale +Bildschirmanzeige einzustellen: + +Wählen Sie \textbf{Formate} \OptPl \textbf{Anzeige Einstellungen...} +und setzen Sie:\\ + \begin{tabular}{@{}ll} + \hspace*{1em} \textbf{Text Alpha} & \texttt{4 bits} \\ + \hspace*{1em} \textbf{Graphik Alpha} & \texttt{4 bits} \\ + \end{tabular}\\ + +Hierfür muss die Option \textbf{Farbtiefe} gegebenenfalls auf +\textbf{8} oder \textbf{24}\,Bits/Pixel eingestellt werden. + +Damit alle diese Einstellungen erhalten bleiben, wählen Sie +\textbf{Optionen} \OptPl \textbf{Speichere Optionen jetzt}. +Beachten Sie, dass beim Installationsprozess alle \file{.ps}- und +\texttt{.eps}-Dateien mit \cmdname{GSView} assoziiert wurden. Über das +Drucken eines Dokuments finden Sie Informationen im Abschnitt~\ref{printing}. + +% .............................................................. +\subsubsection{\cmdname{Windvi}}\label{sub:windvi} + +Das Programm \file{tlpmgui.exe} nimmt eine Assoziation von +\file{.dvi}-Dateien mit \file{Windvi} vor. Sie können daher einfach auf +\dvi-Dateien doppelklicken, und \cmdname{Windvi} sollte starten. Sie können +\cmdname{windvi} natürlich auch von der Kommandozeile starten oder sich eine +Verknüpfung auf \cmdname{windvi} auf den Desktop legen. + +In \cmdname{Windvi} kann das gewünschte Papierformat aus einer Vielzahl +von Formaten über \textbf{View} \OptPl \textbf{Options} und dann in einer +Liste unter \samp{Paper~type} gewählt werden. Querformate sind an einem +angehängten \textbf{r} erkennbar, z.\,B. \textbf{a4r}. Mit \textbf{OK} +werden die Einstellungen gesichert. + +Falls Sie nach dem passenden \MF-Modus für die Auf"|lösung Ihres Druckers +suchen, sollten Sie in |c:\Programme\TeXLive\texmf-dist\metafont\misc\modes.mf| +nachlesen. + +Alle Konfigurationseinstellungen von \cmdname{Windvi} werden in +\dirname{\$HOME/windvi.cnf} gespeichert. Sie können diese +mit folgendem Befehl finden: + +\begin{alltt} +c:\bs> \Ucom{kpsewhich --expand-var \$HOME/windvi.cnf} +\end{alltt} + +Falls Sie Probleme mit \cmdname{Windvi} haben, empfiehlt es sich, +die Konfigurationsdatei zu löschen und zu prüfen, ob der gleiche +Fehler auch mit der Standardkonfiguration auftritt. + +% ------------------------------------------------------------- +\subsection{Installation testen} + +Im Abschnitt~\ref{sec:test-install} auf Seite~\pageref{sec:test-install} +wurde eine generelle Methode zum Test einer Installation beschrieben; +die Ausführungen hier beleuchten die Windows-spezifischen Tests. + +In Ihrem Editor öffnen Sie bitte die Datei \file{sample2e.tex}, die Sie unter +|c:\TeXLive2005\texmf-dist\tex\latex\base\| finden können. +Die \LaTeX-Quelle sollte nach dem Öffnen der Datei auf dem Bildschirm +angezeigt werden. Durch Anklicken des \LaTeX-Symbols in der Menü-Leiste +wird die Datei übersetzt; bei Wahl des Preview-Symbols (\cmdname{Windvi}) +wird sie dargestellt. +Beim ersten ">Preview"< einer Datei mit \cmdname{Windvi} werden alle +benötigten Fonts erzeugt; sie wurden nicht mitinstalliert. Mit der +Zeit werden Sie das Fenster, das die Font"=Generierung anzeigt, +immer seltener sehen. +Als nächstes sollten Sie {\dvips} anklicken und \cmdname{GSView} +ausprobieren. + +\textbf{Hinweis für später:} Wenn ein \LaTeX-Lauf mit einer Fehlermeldung +unterbricht, weil eine Datei nicht gefunden wird, können Sie mit +\textbf{Ctrl-z} einen Abbruch erzwingen. Überprüfen Sie anhand der +Protokolldatei, welche Datei nicht zu finden war und beheben Sie den Fehler. + +% ------------------------------------------------------------- +\subsection{Drucken}\label{printing} + +Es ist grundsätzlich möglich, aus \cmdname{Windvi} heraus zu drucken. +Wird dabei der Standard-Windows-Druckertreiber benutzt, hat dies +den Vorteil, dass eine Ausgabe auf allen Druckern möglich ist und +Sie \file{BMP}- oder \file{WMF}-Bilddateien einbinden und drucken +können. Nachteil ist, dass teilweise extrem große Druckdateien +erzeugt werden. Sie müssen sicherstellen, dass die Druckparameter +korrekt eingestellt sind (siehe Abschnitt~\vref{sub:windvi}), +sonst erhalten Sie eine skalierte Ausgabe der Druckseite. So wird +bei einer Drucker"-auf"|lö"-sung von 300\,dpi eine 600-dpi-Druckausgabe +nur ein Viertel der Seite zeigen. + +Im Allgemeinen ist es allerdings schneller und für den Produktionszyklus +beim Einbinden von \file{eps}-Graphiken schneller und sicherer, {\dvips} zu +benutzen. Sie erstellen eine \file{.ps}-Datei und drucken mit \cmdname{GSView}. +Einen Ausdruck können Sie in \cmdname{GSView} über das Drucker-Symbol oder +durch Wahl von \textbf{Datei} \OptPl \textbf{Drucken...} anstoßen. Es +wird dann ein Fenster für die weiteren Druckparameter geöffnet. + +Bei der Benutzung eines \PS-Druckers müssen Sie sicherstellen, +dass Sie die Option \textbf{\PS~Drucker} angewählt haben. +Ab \cmdname{GSView}-Version~3.6 erfolgt dies in dem Feld +\samp{Druckmethode} unten links im Fenster \textbf{Drucken}. +Dann können Sie im Feld \samp{Drucker} jeden installierten +\PS-fähigen Drucker auswählen. Wenn Sie vergessen sollten, +\textbf{\PS-Drucker} als \samp{Druckmethode} zu wählen, +wird das Ausdrucken nicht funktionieren. + +Benutzen Sie hingegen einen \textbf{nicht}-\PS-fähigen Drucker, +wählen Sie im Feld \samp{Druckmethode} stattdessen die Option +\textbf{\cmdname{Ghostscript} Treiber} und klicken den mit \textbf{djet500} +beschrifteten Knopf. Hier wählen Sie Ihren Drucker im Dialog +\textbf{Wähle Ghostscript-Gerät} aus. +(In älteren \cmdname{GSView}-Versionen müssen Sie das Feld +\samp{\PS-Drucker} abwählen und dann Ihren Drucker aus +der \textbf{Geräte-Liste} wählen.) + +% ------------------------------------------------------------- +\subsection{Tipps und Tricks für Win32-Plattformen} + +% .............................................................. +\subsubsection{Die feinen Unterschiede bei Win32} + +Was wir als Win32 bezeichnen, ist im Grunde kein eigenständiges +Betriebssystem. Es ist ein sehr großer Satz von Funktionen% +\footnote{Die Headerfiles der Microsoft-\acro{SDK} enthalten rund 12\,000\,Funktionen!}, +den man benutzen kann, um Programme für unterschiedliche +Betriebssysteme der Windows-Familie zu schreiben. + +Windows kommt in unterschiedlichen Ausprägungen: + +\begin{itemize} +\item Windows\,95, Windows\,98 und {\ME} stellen \emph{keine echten Multi"~Tasking- + oder Multi-Threading}-Systeme dar. Sie sind (hoffentlich) + die letzte \acro{DOS}-Metamorphose. Dies kann man mehr oder minder leicht + in der Boot-Phase überprüfen. Hat der PC \file{command.com} geladen + und man unterbricht die weitere Boot-Folge und fragt nach der + aktuellen (\acro{DOS}-)Version, so erhält man (zumindest bei älteren + Versionen von Windows\,9x) die Angabe: \samp{MS-DOS~7.0}. +\item \NT, ein komplett neu geschriebenes Betriebssystem mit + echten Multi"~Tasking"=Eigenschaften und vielen ">high~level~features"< +\item Windows\,2000, entwickelt auf der Basis von \NT, mit allen + Schikanen von Windows\,98 +\item \XP, in den Geschmacksrichtungen \emph{Personal} und \emph{Pro}, + ist der letzte Schritt auf dem Weg, die beiden Entwicklungslinien + Windows\,9x und {\NT} zusammenzuführen. {\XP} wurde auf der + Basis von {\NT} entwickelt. +\end{itemize} + +Windows\,9x ist in der Lage, 32"~Bit- und 16"~Bit-Programme gleichzeitig +auszuführen. Das Betriebssystem ist allerdings nicht vollständig im +32"~Bit-Modus geschrieben und unterstützt daher keinen Speicherschutz. +16"~Bit-Applikationen können so Teile des Betriebssystemspeichers +überschreiben! Einige Systemteile, wie beispielsweise das \cmdname{GDI} +(Graphical Device Interface), müssen beschränkte Ressourcen wie Bitmaps, +Fonts usw. für alle gleichzeitig laufenden Programme verwalten. Die +Gesamtgröße aller Bitmap-Header, die zu einem Zeitpunkt verfügbar ist, +beträgt maximal 64\,KB. Dies erklärt die Rolle von ">Performance~Tools"< +und auch, warum Sie die Stabilität Ihres Systems auf die Probe stellen, +wenn Sie intensiven Gebrauch von graphischen Objekten machen. + +\NT/""{\XP} und Windows\,2000 leiden weder unter diesen, noch unter +anderen Windows"~9x"=Beschränkungen. Sie sind echte Multi"~Tasking-Systeme mit +Speicherschutz-Me"-cha"-nis"-men. Durch besseres Design bei Speicherverwaltung, +Dateisystem usw. haben sie zudem ein wesentlich besseres Antwortverhalten. + +% .............................................................. +\subsubsection{Kommandointerpreter} + +Sie haben sich sicherlich schon gefragt, ">Warum sollte ich etwas über +die Kommandozeile eingeben, wenn ich Windows benutze?"<. + +Gute Frage. Dies ist mehr ein grundsätzliches Problem, da mit einer +graphischen Benutzerschnittstelle (\acro{GUI}) nicht immer alle Arbeitsschritte +einfach zu erledigen sind. Der Kommandointerpreter eröffnet hier +häufig -- einen intelligenten Kommandointerpreter vorausgesetzt -- mehr Möglichkeiten. + +In unserem Fall handelt es sich aber um ein fundamentales Problem: +{\TeX} ist ein \emph{Batch}-Tool und kein interaktives Programm. +{\TeX} errechnet das beste Layout für jede Seite, löst die Referenzen +auf, usw. Hierfür ist die Gesamtbearbeitung des Dokuments immer noch +die einfachste Methode. Bislang macht eine interaktive Bearbeitung +der Eingabe (noch) keinen Sinn. + +Das bedeutet also, dass Sie {\TeX} auf der Kommandozeile benutzen +sollten. Im Grunde ist die Situation sogar so, dass diese Programme +für komplexe Verarbeitungsvorgänge besser geeignet sind, da es leichter +ist, ein Programm ohne die Verkopplung mit einer graphischen +Benutzerschnittstelle zu testen und Fehler zu finden. Es ist +dann auch einfacher, ein \acro{GUI} zur Bedienung dieses Programms +zu entwickeln. Und dies ist genau der Fall für {\TeX}, mit dem +Sie in den allermeisten Fällen über eine Shell oder einen +\acro{GUI}-Editor in Kontakt treten. + +Manchmal benötigen Sie aber den Kommandointerpreter dazu, um +Probleme zu lösen oder um Fehler in Ihrem Setup aufzuspüren +(siehe Abschnitt~\ref{sec:troubleshooting}). + +\begin{description} + \item[Windows\,9x:]\mbox{}\\ + Sie starten den Kommandointerpreter entweder im + \textbf{Start}-Menü \OptPl \textbf{Programme} und + suchen die Option \cmdname{MS-DOS-Eingabeauf"|forderung} + oder mit \textbf{Start}-Menü \OptPl \textbf{Ausführen} + und tippen ">\file{command.com}"<. + \item[{\NT}, Windows\,2000 und \XP:]\mbox{}\\ + Sie finden den Kommandointerpreter im + \textbf{Start}-Menü unter \textbf{Accessories}.% + \footnote{Dies kann je nach Version des Betriebssystems + unterschiedlich sein. In der deutschsprachigen Version + von Windows heißt diese Programmgruppe meistens ">Zubehör"<.} + Sie starten ihn allerdings auch im \textbf{Start}-Menü + \OptPl \textbf{Ausführen} durch ">\file{cmd.exe}"< + (so heißt der nagelneue Kommandointerpreter für + {\NT}).\footnote{Was auch erklärt, warum es unwahr + ist, ihn unter {\NT} als \emph{\acro{DOS}}-Box zu bezeichnen.} +\end{description} + +% .............................................................. +\subsubsection{Verzeichnistrenner} + +Die Win32-API versteht sowohl \samp{/} als auch ">|\|"< +als Verzeichnistrenner. Die Kommandointerpreter aber leider nicht! +Sie können also immer dann beide Trenner benutzen, sogar gemischt +innerhalb eines Pfads, wenn Sie \emph{nicht} auf der Kommandozeile +arbeiten. +Der Kommandointerpreter spielt hier nicht mit, da er das Zeichen +\samp{/} benutzt, um Argumente von Kommandos zu trennen. + +Sie sollten also nicht überrascht sein, wenn Sie Pfad- und +Verzeichnisnamen in der \acro{UNIX}"=Schreibweise sehen. \fpTeX ist eine +Portierung von {\Webc} und zielt auf Kompatibilität über die Plattformen. +Deshalb enthalten alle Konfigurationsdateien die Pfadnamen in +\acro{UNIX}-Schreibweise. + +% .............................................................. +\subsubsection{Dateisysteme}\label{sec:clusters} + +Das schwächste Glied bei Windows\,9x in Bezug auf {\TeX} ist +sicherlich das sogenannte \acro{FAT}- oder \acro{FAT16}-Dateisystem. +{\TeX} benutzt eine Vielzahl sehr kleiner Dateien, meist mit +Größen zwischen 1\, und 3\,KB. Das \acro{FAT}-Dateisystem +ist veraltet; es stammt aus einer Zeit, als Gigabyte-Platten +noch unbekannt waren. Deshalb kann es mit den Zehntausenden von Dateien +des \TL-Systems nicht effizient umgehen. Im \acro{FAT}-Dateisystem +werden auf großen Partitionen im Minimum 32\,KB für +\emph{jede} Datei angelegt. Damit ist klar, dass {\TeX} auf +diese Weise wesentlich mehr Plattenplatz verbraucht als +notwendig wäre. + +Die moderneren Windows-Dateisysteme, wie \acro{FAT32} oder \acro{NTFS}, +haben diesen Nachteil nicht. Hier betragen die sogenannten +Cluster-Größen 4\,KB.% +\footnote{Unter \acro{NTFS} kann dies bis auf 512\,Byte gesenkt werden.} + +% .............................................................. +\subsubsection{\envname{PATH} um Verzeichnis(se) erweitern} + +Jedes Programm erhält bei seinem Start eine Kopie der +Standardumgebung. Dies ist eine Sammlung von Variablen mit +zugehörigen Schlüsselwerten. Diese Variablen stehen unter +der ausschließlichen Kontrolle des Programms; Änderungen +an Schlüsseln oder Schlüsselwerten sind für andere Programme +nicht sichtbar. + +Die Umgebungsvariable \envname{PATH} dient der Suche nach +Programmen. Es existieren unterschiedliche Vorgehensweisen +zur Änderung dieser Variablen für die verschiedenen +Windows-Varianten: + +\begin{description} +\item[Windows\,95/98:]\mbox{}\\ + Laden Sie die Datei \file{autoexec.bat} in den Editor + und suchen nach einer Zeile, die mit \samp{PATH=} + beginnt. Nach dem \samp{=} folgt eine Liste von + Verzeichnissen, die durch \samp{;} getrennt sind. + Fügen Sie das Verzeichnis mit den \TL-Programmen + an. Danach könnte die Zeile wie folgt aussehen: + + |PATH=c:\windows;c:\windows\system;c:\TeXLive2005\bin\win32| + +\item[\ME:]\mbox{}\\ + Um eine Umgebungsvariable zu ändern, müssen Sie + das Programm + + |c:\windows\system\msconfig.exe| + + laufen lassen. Wählen Sie nach dem Start dieses Programms + ">\cmdname{Umgebung}"<, dann tragen Sie die Variable + \texttt{PATH} mit ihrem Wert ein oder ändern ihn: + + |PATH c:\TeXLive2005\bin\win32| + + Danach werden Sie aufgefordert, Ihren Rechner neu zu starten. + +\item[\NT/Windows\,2000:]\mbox{}\\ + Gehen Sie über \textbf{Start}-Menü \OptPl \textbf{Einstellungen} + \OptPl \textbf{Systemsteuerung} \OptPl \textbf{System}. + Wählen Sie \textbf{Umgebung}. Die weiteren Schritte finden Sie + unter \XP. + +\item[\XP:]\mbox{}\\ + Gehen Sie über \textbf{Start}-Menü \OptPl \textbf{Systemsteuerung} + \OptPl \textbf{System} \OptPl \textbf{Erweitert}. + Wählen Sie unten links \textbf{Umgebungsvariablen}. + + Sie können nun als Benutzer die Umgebungsvariablen + ändern. Es werden Ihnen aber auch Variablen + für das System angezeigt. Im Normalfall können Sie keine + System-Variablen ändern, es sei denn, Sie besitzen für den + Rechner auch Administrator-Rechte. Möchten Sie \envname{PATH} + für alle Benutzer ändern, müssen Sie mit Ihrem Systembetreuer + Kontakt aufnehmen; sind Sie selbst Systembetreuer, sollten + Sie Bescheid wissen. + + Existiert bereits eine Einstellung für \envname{PATH} für Sie, + klicken Sie mit der linken Maustaste auf \envname{PATH}. Im + Feld \textsf{Variable} erscheint dann \envname{PATH}, das Feld + \textsf{Wert} zeigt den aktuellen Inhalt als Liste von + Verzeichnissen, die mit \samp{;} getrennt sind. Fügen Sie + das Verzeichnis mit den \TL-Programmen an: + + |c:\TeXLive2005\bin\win32| + + Existiert für Sie keine Variable mit Namen \envname{PATH}, müssen Sie + in das Feld \textsf{Variable} klicken und \envname{PATH} + eintragen. Dann wählen Sie das Feld \textsf{Wert} an und + tragen das gewünschte Verzeichnis ein. + + \textbf{Wichtig}: Klicken Sie zuerst \samp{Übernehmen} an, + bevor Sie mit \samp{Ok} bestätigen. Anderenfalls + werden die Änderungen an \envname{PATH} nicht für Ihr System + übernommen. Seien Sie vorsichtig beim Ändern der Umgebung! +\end{description} + +Zur Überprüfung, ob die Variable gesetzt wurde, ist es am +besten, ein Kommandointerpreter-Fenster zu öffnen und dort einzugeben: + + ~~~~\code{set} \var{variable} + +Sie erhalten dann den zugewiesenen Wert angezeigt. + +% .............................................................. +\subsubsection{{\TeX}-Engines} + +Wenn Sie die \Webc-Dokumentation aufmerksam lesen, werden Sie +feststellen, dass immer davon geschrieben wird, dass alle auf +{\TeX} basierenden Programme die gleiche ">Base-Engine"< +benutzen. So sind zum Beispiel \file{tex.exe} und \file{latex.exe} +Kopien des gleichen Programms; jedes benötigt aber seine eigene +Format-Datei basierend auf dem Programmnamen. + +Unter \acro{UNIX} wird dies durch sogenannte \emph{symbolische Links} erreicht. +Das spart Plattenplatz, da einige Base-Engines mit sehr vielen +unterschiedlichen Format-Dateien genutzt werden. + +%\enlargethispage{-\baselineskip} +Die Win32-API kennt keine symbolischen Links. Um also annähernd die +gleiche Ersparnis zu erreichen, wurden die \TeX-Base-Engines +in sogenannten DLLs (\emph{Dynamic Linked Library}) realisiert. +Das heißt, man sieht folgende Verteilung: + +\begin{alltt} +18/09/2005 14:19 3 584 latex.exe +18/09/2005 14:19 3 584 pdfetex.exe +18/09/2005 14:19 524 288 tl90pdfetex.dll +\end{alltt} + +\file{latex.exe} ist eine Kopie von \file{pdfetex.exe}, die den +selben Kern \file{tl90pdfetex.dll} nutzt. Der gleiche Trick wurde +für die acht Mitglieder der \file{mktex*.exe}-Programmfamilie +benutzt, die auf die Bibliothek \file{mktex.dll} ">gelinkt"< sind. + +Das \TL-System enthält das Programm \file{irun.exe}, mit +dem für Win32-Binärprogramme das \acro{UNIX}-Äquivalent der sogenannten +\emph{hard~links} eingerichtet werden kann. + +% ------------------------------------------------------------- +\subsection{Problemfälle}\label{sec:troubleshooting} + +% .............................................................. +\subsubsection{Was ist zu tun, wenn {\LaTeX} Ihre Dateien nicht findet?} + +\begin{itemize} +\item Bei diesen Problemen heißt das Werkzeug der Wahl \cmdname{kpsewhich}. + Leider gibt \cmdname{kpsewhich} seine Ausgaben auf \samp{stderr} + aus und das Fenster des Kommandointerpreters kennt keinen Weg + \samp{stderr} auf eine Datei umzulenken.% + \footnote{Ok, \NT/""{\XP} und Windows\,2000 haben dazu gelernt. Der + angegebene Trick funktioniert aber für alle + Systeme!} + Für Diagnosezwecke kann man im Kommandointerpreter die folgende + Umgebungsvariable definieren: + + | SET KPATHSEA_DEBUG_OUTPUT=err.log| + + Sie können auch die Debug-Schwelle einstellen: + + | SET KPATHSEA_DEBUG=-1| + +\item Falls Sie die Fehlerausgabe \samp{stderr} auf die Standardausgabe \samp{stdout} + umlegen wollen (unter Windows\,9x, \NT/""Windows\,2000/""{\XP} nicht möglich), hilft folgende + Vorgehensweise: + + | SET KPATHSEA_DEBUG_OUTPUT=con:| + + Damit können Fehler- und Standardausgaben in der gleichen Datei gesammelt werden. + +\item Überprüfen Sie die folgenden Werte (es wird hierbei angenommen, dass das + \TeX-System unter |c:/TeXLive2005| eingerichtet wurde): \\ + \begin{small} + \begin{tabular}{lp{6cm}} + \texttt{kpsewhich -expand-path \$SELFAUTOPARENT} + & |c:/TeXLive2005| \\ + \texttt{kpsewhich -expand-path \$TEXMF} + & |c:/TeXLive2005/texmf| \\ + \texttt{kpsewhich -expand-path \$TEXMFCNF} + & |.;c:/TeXLive2005/texmf-var/web2c;| \\ + \texttt{kpsewhich -expand-var \$TEXINPUTS} + & |.;c:/TeXLive2005/texmf/tex//| + \end{tabular} + \end{small} + +\item Falls Sie die Umgebungsvariablen für das \TeX-Umfeld anders gesetzt haben, + sollten Sie diese Eintragungen löschen. Offensichtlich werden die Einstellung + aus \file{texmf.cnf} überschrieben. + +\item Vergleichen Sie Ihre Ergebnisse mit folgenden Werten:\\ + \begin{small} + \begin{tabular}{ll} + \texttt{kpsewhich cmr10.tfm} & + \file{c:/TeXLive2005/texmf/fonts/tfm/public/cm/cmr10.tfm}\\ + \texttt{kpsewhich latex.fmt}& + \file{c:/TeXLive2005/texmf/web2c/latex.fmt} + \end{tabular} + \end{small} + +\item Falls bis zu diesem Punkt alles übereinstimmte, sollten auch + \file{tex.exe} und Co. funktionieren. Ist dies nicht der Fall, + werden Sie sich intensiver mit der \cmdname{kpsewhich}-Option \optname{-debug=n} + beschäftigen und alle Werte + überprüfen müssen. Wenn Sie das Problem identifizieren können, + schicken Sie bitte einen Fehler-Report. +\end{itemize} + +% .............................................................. +\subsubsection{Was ist zu tun, wenn das Setup nicht wie gewünscht funktioniert?} + +Es gibt einige Punkte, die Sie zuerst prüfen sollten: + +\begin{enumerate} +\item Liegt \file{tex.exe} im definierten \envname{PATH}? +\item Wurde die Umgebungsvariable \envname{TEXMFCNF} auf + |c:\TeXLive2005\texmf-var\web2c| gesetzt + (eigene Einstellung beachten!)? +\item Wurden im Installationsprotokoll Fehler durch \file{tlpmgui.exe} + eingetragen? Die Datei \file{tlpmgui.log} befindet sich im + \file{TEMP}-Verzeichnis. Fehlermeldungen beginnen mit \samp{Error}. + Hinweis: Manchmal finden sich in der Log-Datei Fehlermeldungen vom + Versuch, alle Format-Dateien zu generieren. Keine Panik, wenn dies + Formate betrifft, die Sie gar nicht installiert haben. +\item Sie können im \acro{WWW}-Dokument \url{http://www.tug.org/tex-live/} + prüfen, ob ein Bug-Fix für das \TL-System vorliegt. +\end{enumerate} + +Die \TL-Software ist komplex und besteht aus Hunderten von Programmen +und Zehntausenden von Dateien aus verschiedenen Quellen. Es ist deshalb nicht +möglich, Antworten für alle Problemfälle vorzuhalten. Wir werden aber +unser Bestes tun, Ihnen bei allen Schwierigkeiten zu helfen. (Siehe Abschnitt~\ref{sec:help} auf +Seite~\pageref{sec:help}.) + +% ============================================================== +% don't use \Webc so the \uppercase in the headline works. +\section[Anleitung zum Web2C-System]{Anleitung zum \Webc-System} + +{\Webc} 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. + +\Webc~7.5 läuft unter \acro{UNIX}, Windows\,3.1, Windows\,9x/""\ME/""\NT/""Windows\,2000/""\XP, +\acro{DOS} und auf weiteren Betriebssystemen. Es benutzt die +Original-Quelldateien von Donald E.~Knuth und weitere in der +Sprache {\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{deflist}{\mdseries\cmdname{pooltype}} +%\renewcommand{\makelabel}[1]{\descriptionlabel{\mdseries\cmdname{#1}}} +\item[bibtex] Verwalten von Bibliographien +\item[dmp] \cmdname{troff}-nach-MPX-Konverter (\MP-Bilder) +\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[makempx] Anzeige von \MP-Beschriftungen +\item[mf] Zeichensatzerzeugung +\item[mft] formatierte Ausgabe von \MF-Quellen +\item[mpost] \MF-ähnliches Grafikprogramm +\item[mpto] Extrahieren von \MP-Beschriftungen +\item[newer] Vergleich von Dateierstellungsdaten +\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{deflist} + +Die genaue Funktionsweise und die möglichen Parameter sind der +Beschreibung der jeweiligen Pakete bzw. der \Webc-Dokumentation zu entnehmen. +Trotzdem wird ein Überblick über Zusammenspiel und Funktionsweise der +\Webc-Programme Ihnen sicherlich helfen, besser mit dem System zurechtzukommen. + +Zunächst verstehen alle Programme die grundlegenden Parameter der +\acro{GNU}-Software: + +\begin{deflist}{\texttt{-{}-version}} +\item[\texttt{-{}-help}] kurzer Hilfstext +\item[\texttt{-{}-verbose}] ausführliche Ausgaben beim Programmablauf +\item[\texttt{-{}-version}] Ausgabe der Versionsnummer +\end{deflist} + +Die Programme des \Webc-Systems benutzen zum Lokalisieren der benötigten +Dateien im Dateisystem die \KPS-Bibliothek. 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. +\Webc~7.5 kann mehr als einen Dateibaum gleichzeitig verwalten und ermöglicht +somit die schon beschriebene \TL-Installation unter Verwendung der +{\CDROM} oder {\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. + +% ------------------------------------------------------------- +\subsection[Dateisuche mit der Kpathsea-Bibliothek]{Dateisuche mit der \protect\KPS-Bibliothek} + +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{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 +\cs{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. + +\ifSingleColumn +\else + +\begin{figure*}[tp] +\verbatiminput{examples/ex5.tex} +\setlength{\abovecaptionskip}{0pt} + \caption{An illustrative configuration file sample} + \label{fig:config-sample} +\end{figure*} +\fi + +% .............................................................. +\subsubsection{Bestandteile von Pfadkomponenten}\label{Path-sources} + +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 {\dvips} eine Zeile \samp{S /a:/b} + in der Konfigurationsdatei \file{config.ps} +\item + Einträge aus der \KPS-Konfigurationsdatei \file{texmf.cnf}, + z.\,B. \samp{TEXINPUTS=/c:/d} (siehe folgenden Text) +\item + Einstellung beim Übersetzen der Programme +\end{enumerate} + +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{Debugging}.) + +% .............................................................. +\subsubsection{Konfigurationsdateien} + +%\tolerance=3500 +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}. + +%\tolerance=1500 + +Im Folgenden wird die Syntax der Datei \file{texmf.cnf} angegeben. +Konsultieren Sie zum besseren Verständnis beim Lesen die auf der +{\CDROM} oder {\DVD} enthaltene Konfigurationsdatei. +%, die ab Seite~\pageref{app:texmf.cnf} im Anhang dieser Anleitung +% abgedruckt ist. + +\begin{itemize} +\item + Kommentare beginnen mit einem \samp{\%} 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. +\ifSingleColumn +\verbatiminput{examples/ex5.tex} +\else +Betrachten Sie Abbildung~\ref{fig:config-sample}. +\fi + +% .............................................................. +\subsubsection{Expansion von Pfadkomponenten}\label{Path-expansion} + +{\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. + +% .............................................................. +\subsubsection{Expansion der Voreinstellungen}\label{Default-expansion} + +Wenn der Suchpfad mit der höchsten Priorität (siehe hierzu ">Bestandteile von +Pfadkomponenten"< auf Seite~\pageref{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. + +% .............................................................. +\subsubsection{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): +%(Zeile 75): %%%% to be checked !!!! checked&corrected vrws 01.06.05 + +\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 \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. + +% .............................................................. +\subsubsection{Expansion von Unterverzeichnissen}\label{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 \samp{/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 \samp{//}-Konstruktionen innerhalb einer Pfadkomponente +sind zulässig, allerdings nicht am Pfadanfang. + +% .............................................................. +\subsubsection{Liste der Sonderzeichen und ihre Bedeutung: eine Zusammenfassung} + +Die folgende Zusammenfassung fasst alle Sonderzeichen zusammen, die in den +\KPS"=Konfigurationsdateien auftreten können: + +% ++++++++++++++++++++++++ +\newcommand{\CODE}[1]{\makebox[3em][l]{\code{#1}}} +% ++++++++++++++++++++++++ + +\begin{deflist}{\CODE{!!}} % noch schlechter Satz ?? +\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{deflist} + +% ------------------------------------------------------------- +\subsection{Dateinamen"=Datenbanken}\label{Filename-database} + +{\KPS} unternimmt etliche Anstrengungen, um den Zugriff auf Festplatte und +\CDROM/{\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. + +% .............................................................. +\subsubsection{Die \texttt{ls-R}-Datenbank}\label{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. +Die meisten \TeX-Systeme arbeiten nur mit einer Hierarchie. {\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 \samp{!!} beginnt, wird dagegen niemals die Festplatte durchsucht. + +% .............................................................. +\subsubsection{\cmdname{kpsewhich}: Dateisuche}\label{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 wichtigen 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 \optname{-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 \samp{.\var{Programmname}}. Voreinstellung ist \samp{kpsewhich}. +\item[\texttt{-{}-show-path=}\var{name}]\mbox{}\\ + Zeigt den Suchpfad für die angegebene Namens\-endung. Diese kann entweder + als Namens\-endung (\samp{.pk}, \samp{.vf}, usw.) oder als Name (wie bei der + Option \optname{-{}-format}) spezifiziert werden. +\item[\texttt{-{}-debug=}\var{num}]\mbox{}\\ + Legt den Umfang für die Fehlersuche fest. +\end{description} + +% .............................................................. +\subsubsection{Anwendungsbeispiele}\label{SExamplesofuse} + +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 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-\TypeI-Zeichensätze, die auf der \CDROM/{\DVD} enthalten +sind, wird auch keine \file{.pk}-Datei angezeigt. + +\begin{alltt} +> \Ucom{kpsewhich wsuipa10.pk} +\ifSingleColumn /usr/local/texmf-var/fonts/pk/ljfour/public/wsuipa/wsuipa10.600pk +\else /usr/local/texmf-var/fonts/pk/ljfour/public/ +... wsuipa/wsuipa10.600pk +\fi\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 +\TypeI-Umsetzungen vor und \samp{.pk}-Dateien müssen generiert werden. Da unser voreingestellter \MF-Modus +\samp{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 ">\optname{-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 \samp{.ps} nicht eindeutig ist, +müssen wir den gewünschten Typ (\samp{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 +\TypeI-\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 \TypeI-Zeichensätzen: + +\begin{alltt} +> \Ucom{kpsewhich utmr8a.pfb} +\ifSingleColumn /usr/local/texmf-dist/fonts/type1/urw/times/utmr8a.pfb +\else /usr/local/texmf-dist/fonts/type1/ +... urw/utm/utmr8a.pfb +\fi\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. + +% .............................................................. +\subsubsection{Fehlersuche}\label{Debugging} + +Manchmal ist wichtig, bis ins Detail nachzuvollziehen, wie ein Programm eine +bestimmte Datei findet. Zu diesem Zweck bietet die \KPS-Bibliothek verschiedene +Stufen für den Umfang der Fehlersuche an. + +\begin{itemize} +\item[\texttt{\ 1}] \code{stat}-Aufrufe (Überprüfung, ob Datei + existiert); mit einer aktuellen \file{ls-R}-Datenbank sollten Sie fast + keine Meldungen erhalten. +\item[\texttt{\ 2}] Zugriffe auf Suchlisten (wie \file{ls-R}-Datenbanken, + Zuordnungsdateien (\texttt{.map}), Konfigurationsdateien) +\item[\texttt{\ 4}] Öffnen und Schließen von Dateien +\item[\texttt{\ 8}] Auf"|listen der voreingestellten Pfade für Extensionen +\item[\texttt{16}] Verzeichnisliste für jede Pfadkomponente (nur bei Festplattenzugriff) +\item[\texttt{32}] Suchaktionen nach Dateien +\end{itemize} + +Durch die Angabe von \samp{-1} setzen Sie alle Stufen gleichzeitig. +Für eine effiziente Fehlersuche sollten Sie sich auf die wichtigsten +Ausgaben beschränken. + +Für {\dvips} gibt es einen ähnlichen Mechanismus zur Erzeugung +von Analysemeldungen, um herauszufinden, warum bestimmte Dateien geöffnet +wurden bzw. wo vielleicht das Problem liegt, wenn Dateien nicht gefunden +werden. + +Da fast alle Programme die \KPS-Bibliothek benutzen, können Sie die +gewünschte Stufe auch über die Umgebungsvariable \envname{KPATHSEA\_DEBUG} +einstellen, indem Sie einen der Werte oder eine additive Kombination +spezifizieren. + +Anmerkung für Windows-Benutzer: Es ist nicht einfach, alle Meldungen in eine Datei umzulenken. Für die Fehlersuche +jedoch ist die folgende (temporäre!) Vereinbarung sinnvoll: + +\indent\texttt{SET KPATHSEA\_DEBUG\_OUTPUT=err.log} + +Wir betrachten als Beispiel eine kleine \LaTeX-Quelldatei mit dem Namen +\file{hello-world.tex} mit folgendem Inhalt: + +\begin{verbatim} + \documentclass{article} + \begin{document} + Hello World! + \end{document} +\end{verbatim} + +Diese Datei verwendet nur einen Zeichensatz, nämlich \file{cmr10}. Wir sehen uns +jetzt einmal genau an, wie {\dvips} die \PS-Datei erzeugt. +Da wir die \TypeI-Variante der Computer-Modern-Roman-Zeichensätze +verwenden wollen, haben wir die Option \optname{-Pcms} verwendet. + +\begin{alltt} +> \Ucom{dvips -d4100 hello-world -Pcms -o} +\end{alltt} + +Hier haben wir als Stufe zur Fehlersuche eine Kombination der Stufe~\code{4} von +{\dvips} (siehe \dvips-Handbuch, +\dirname{texmf/doc/html/dvips/dvips\_toc.html}?). +%\ifSingleColumn +%We get something +%like the following (we have rearranged the output for easier display): +%\begin{alltt}\small +%\input{examples/ex6.tex} +%\end{alltt} +%\else +Die Ausgabe sieht ungefähr so wie in +Abbildung~\ref{fig:dvipsdbga} dargestellt aus (die Ausgabe wurde für einen besseren Überblick +etwas umgestaltet). + +\begin{figure*}[tp] +\centering +\input{examples/ex6a.tex} +\caption{Suche nach Konfigurationsdateien}\label{fig:dvipsdbga} + +\bigskip + +\input{examples/ex6b.tex} +\caption{Suche nach Prologdateien}\label{fig:dvipsdbgb} + +\bigskip + +\input{examples/ex6c.tex} +\caption{Suche nach Font-Dateien}\label{fig:dvipsdbgc} +\end{figure*} + +Zunächst sucht {\dvips} (bzw. \KPS) seine Konfigurationsdateien, +nämlich \file{texmf.cnf} (das die Pfade der anderen Dateien enthält), +dann die Dateinamen"=Datenbank \file{ls-R} (zur Optimierung der Suche) +und die Datei \file{aliases}, mit deren Hilfe für eine Datei +mehrere Namen vereinbart werden können, z.\,B. um die kurzen +\samp{8.3}-\acro{DOS}-Namen mit aussagefähigen, langen Namen zu assoziieren. +Danach wird die allgemeine \dvips-Konfigurationsdatei +\file{config.ps}, anschließend die benutzerspezifische Konfigurationsdatei +\file{.dvipsrc} (wird hier \emph{nicht} gefunden) gesucht. +Als letztes sucht {\dvips} die Zuordnungsdatei für +Computer-Modern-{\PS}"=Zeichensätze \file{config.cms} (bedingt durch die +Option \optname{-Pcms} beim Aufruf von \dvips). Diese +Datei enthält die Dateinamen der Listen, die die Zuordnung zwischen +Dateinamen und Zeichensatznamen herstellen. + +\begin{alltt} +> \Ucom{more /usr/local/texmf/dvips/cms/config.cms} + p +ams.map + p +cms.map + p +cmbkm.map + p +amsbkm.map +\end{alltt} + +{\dvips} versucht, diese Dateien und zusätzlich die +allgemeine Zeichensatzzuordnungstabelle \file{psfonts.map} zu +laden, die immer konsultiert wird; der letzte Teil von +Abschnitt~\ref{SExamplesofuse} erklärt diese Tabellen genauer. + +Jetzt erfolgt die normale Startmeldung von \dvips: + +\begin{alltt}\ifSingleColumn +dvips(k) 5.94a +kpathsea version +Copyright (C) 2003 Radical Eye Software. +... +\else\small{}dvips(k) 5.94a +kpathsea version +Copyright (C) 2003 Radical Eye Software. +... +\fi\end{alltt}% decided to accept slight overrun in tub case +\ifSingleColumn +Danach wird nach \file{texc.pro} gesucht: + +\begin{alltt}\small +kdebug:start search(file=texc.pro, must\_exist=0, find\_all=0, + path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//: + ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//). +kdebug:search(texc.pro) => /usr/local/texmf/dvips/base/texc.pro +\end{alltt} +\else +Danach wird nach \file{texc.pro} gesucht (siehe Abbildung~\ref{fig:dvipsdbgb}). +\fi +Dann gibt {\dvips} Datum und Uhrzeit aus und meldet den Dateinamen +der erzeugten \PS-Datei \file{hello-world.ps}. Jetzt wird die +Zeichensatzdatei \file{cmr10} benötigt, die {\dvips} als +">resident"< meldet. + +\enlargethispage{1ex} +\begin{alltt}\small +TeX output 1998.02.26:1204' -> hello-world.ps +Defining font () cmr10 at 10.0pt +Font cmr10 <CMR10> is resident. +\end{alltt} + +Es geht weiter mit \file{cmr10.tfm} und einigen weiteren Prologdateien, +deren Ausgaben wir hier weglassen. Letztlich wird die \TypeI-Zeichensatzdatei +\file{cmr10.pfb} gesucht (und gefunden) und in die Ausgabedatei integriert +(siehe letzte Zeile). + +\begin{alltt}\small +kdebug:start search(file=cmr10.tfm, must\_exist=1, find\_all=0, + path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//: + /var/tex/fonts/tfm//). +kdebug:search(cmr10.tfm) => /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm +kdebug:start search(file=texps.pro, must\_exist=0, find\_all=0, + ... +<texps.pro> +kdebug:start search(file=cmr10.pfb, must\_exist=0, find\_all=0, + path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//: + ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//). +kdebug:search(cmr10.pfb) => /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb +<cmr10.pfb>[1] +\end{alltt} + +% ------------------------------------------------------------- +\subsection{Einstellungen zur Laufzeit} + +Zu den willkommenen Erweiterungen von {\Webc} zählt die Möglichkeit, +zur Laufzeit einige Speicher"-größen über die Datei \file{texmf.cnf} anpassen +zu können (insbesondere die Größe einiger Stacks). Eine ausführliche Liste +der veränderbaren Parameter finden Sie in der Datei \file{texmf.cnf}. +Die wichtigsten Werte sind: + +\begin{description} +\item[\texttt{main\_memory}]\mbox{}\\ + Arbeitsspeicher für \TeX, {\MF} und {\MP} in Worten: Für jede Einstellung + muss eine eigene Format-Datei erstellt werden. Allerdings können Sie + mehrere Versionen von {\TeX} unter verschiedenen Namen erzeugen und + in der Konfigurationsdatei jeweils eigene Einträge vorsehen. Hier gibt + es ein Monster-{\TeX} namens \samp{hugetex} mit der zugehörigen Format-Datei + \file{hugetex.fmt}, wobei der spezielle Wert der + Variablen \texttt{main\_memory} dann + aus der Datei \file{texmf.cnf} gelesen wird. +\item[\texttt{extra\_mem\_bot}]\mbox{}\\ + Extraspeicher für ">große"< \TeX-Datenstrukturen wie Boxen, Glue, + Breakpoints, usw.: Besonders bei Anwendung von {\PiCTeX} sollte dieser + Wert erhöht werden. +\item[\texttt{font\_mem\_size}]\mbox{}\\ + Anzahl der Worte für Speicherung von Zeichensatzinformationen: Entspricht + ungefähr dem Speicherbedarf der gelesenen \acro{TFM}-Dateien. +\item[\texttt{hash\_extra}]\mbox{}\\ + Zusätzlicher Platz für Suchlisten: In der Hauptliste können + ca. 10000~Einträge verwaltet werden. Bei einem Buch mit vielen Querverweisen + reicht dieser Platz unter Umständen nicht aus. + Die Voreinstellung für \texttt{hash\_extra} ist \texttt{50000}. +\end{description} + +Natürlich sind diese Parameter kein Ersatz für eine wirklich dynamische +Speicherverwaltung. Mit der gegenwärtigen Version von {\TeX} ist dieses +Konzept aber nur extrem schwer zu implementieren; darum stellt dieses +Verfahren eine praktikable Lösung dar. + +\begin{comment} +%\clearpage +% ============================================================== +\section{Installation von {\TeX} auf einer neuen \acro{UNIX}-Plattform} + +Wenn Sie eine Rechnerplattform einsetzen, für die wir keine Binärdateien +zur Verfügung gestellt haben, müssen Sie {\TeX} und die zugehörigen +Programme mit Hilfe der Quell-Codes selbst übersetzen. Das ist gar nicht so +schwer, wie es klingt. Alles, was Sie brauchen, finden Sie auf der {\DVD} +im Verzeichnis \texttt{source}. + +Zunächst sollten Sie jedoch die von {\TeX} benötigten Dateien durch +eine Installation ohne Binärdateien auf die Festplatte kopieren bzw. +durch ">Mounten"< der {\DVD} verfügbar machen. + +% ------------------------------------------------------------- +\subsection{Voraussetzungen} + +Zum Übersetzen von {\TeX} und allen weiteren benötigten +Programmen benötigen Sie ca. 100\,MB Festplattenkapazität. +Dazu kommen ein \acro{ANSI}-C-Compiler, \cmdname{make} sowie +ein Scanner- und Parser-Generator. Die \acro{GNU}-Programme +(\cmdname{gcc}, \acro{GNU}-\cmdname{make}, \cmdname{m4}, +\cmdname{flex} und \cmdname{bison}) sind praxiserprobt +und auf den meisten Plattformen verfügbar. Eventuell können +Sie auch andere C-Compiler oder \cmdname{make}-Programme einsetzen, +doch dann sollten Sie sich wirklich gut mit Ihrem System auskennen, +wenn es Schwierigkeiten während des Übersetzungsprozesses gibt. +Der Befehl \cmdname{uname} muss einen gültigen Namen liefern. + +% ------------------------------------------------------------- +\subsection{Konfiguration} + +\begin{itemize} +\item Beginnen Sie mit einer ganz normalen \TL-Installation auf +Festplatte (siehe Abschnitt~\ref{sec:UNIX-install-disk} auf +Seite~\pageref{sec:UNIX-install-disk}). Das Installieren der +fertigen Binaries können Sie getrost überspringen. + +\item Dann entpacken Sie das komprimierte Archiv (\cmdname{tar}) in +\dirname{source} auf Ihre Festplatte und wechseln in dieses Verzeichnis. + +\item Legen Sie einen Pfad fest, unter dem das \TeX-System +installiert werden soll. Natürlich sollte das derselbe Pfad sein, +den Sie schon zum Kopieren der Daten verwendet haben +(z.\,B. \dirname{/usr/local} oder \dirname{/usr/local/TeX}). +\end{itemize} + +Die automatische Systemerkennung und -anpassung wird durch +\textsf{configure} mit folgendem Aufruf gestartet: + +\begin{alltt} +> \Ucom{./configure -prefix=/usr/local/TeX} +\end{alltt} + +Bei der Option \optname{prefix} geben Sie das Verzeichnis an, in dem sich die +bereits kopierten \TL-Dateien befinden; +dieses Verzeichnis wird weiter strukturiert (\dirname{\$TEXDIR} +ist dabei das Installationsverzeichnis): + + +\begin{tabular}{>{\ttfamily}ll@{}} + \dirname{\$TEXDIR/man} & Anleitungen im + \acro{UNIX}-\cmdname{man}-Format\\ + \dirname{\$TEXDIR/share/texmf} & \TeX-Daten mit Zeichensätzen, + Makros, usw.\\ + \dirname{\$TEXDIR/info} & Anleitungen im + \acro{GNU}-\cmdname{info}-Format\\ + \dirname{\$TEXDIR/bin/\$PLATFORM} & ausführbare Programme\\ +\end{tabular} +%$ + +Wenn Sie wollen, können Sie ">\dirname{share/}"< als Namensbestandteil +von \OnCD{texmf} weglassen, da sowohl +\dirname{\$TEXDIR/share/texmf} als auch \dirname{\$TEXDIR/texmf} +automatisch von \cmdname{configure} erkannt werden. Sollten Sie ein anderes +Verzeichnis vorziehen, müssen Sie dieses \cmdname{configure} mit dem +Kommandozeilenparameter \optname{-{}-datadir} mitteilen. + +Wenn Sie die erkannte Plattform nicht als \dirname{\$PLATFORM} im +Pfad der ausführbaren Programme haben wollen, sondern z.\,B. +direkt in \dirname{\$TEXDIR/bin} installieren wollen, verwenden Sie +die Option \optname{-{}-disable-multiplatform}. + +Zum Weglassen spezieller \TeX-Systeme wie {\OMEGA} oder {\eTeX} gibt +es eine Reihe von Optionen, die Sie durch die Eingabe von +\samp{./configure --help} angezeigt bekommen. + +% ------------------------------------------------------------- +\subsection{Aufruf von \cmdname{make}} + +Vergewissern Sie sich, dass die Shell-Variable \envname{noclobber} nicht +gesetzt ist und geben + +\begin{alltt} +> \Ucom{make world} +\end{alltt} + +ein. Jetzt können Sie sich entspannt zurücklehnen oder wie ein +{\TeX}ie sagt: |\relax|. + +Eine gute Idee ist auch das Speichern der Meldungen beim +Übersetzen durch das Anlegen eines Protokolls: + +\begin{alltt} +> \Ucom{sh -c "make world >world.log 2>\&1" \&} +\end{alltt} + +Nehmen Sie nicht fälschlicherweise nach dem Durchlauf von \cmdname{make} +an, dass alles gut gegangen ist, sondern vergewissern sich durch eine +Kontrolle des Protokolls. (\acro{GNU} \cmdname{make} zeigt Fehler +z.\,B. immer mit der Zeichenkette ">\texttt{***}"< an.) +Außerdem sollten Sie sich vergewissern, dass alle ausführbaren +Programme auch erzeugt wurden: + +\begin{alltt} +> \Ucom{cd \var{TEXDIR}/bin/\var{archname}} +> \Ucom{ls | wc} +\end{alltt} + +Das Ergebnis sollte über 200 liegen (Sie können die exakte Zahl +mit der Anzahl der lauf"|fähigen Programme [Binaries] im Verzeichnis \OnCD{bin} vergleichen). +Der Aufruf \samp{make~world} ist übrigens äquivalent zu +\samp{make~all~install~strip}. + +Wenn für den Aufruf von \samp{make~install} besondere +Systemverwalterrechte notwendig sein sollten, können Sie die +Anweisung \samp{make~world} auch in zwei Durchgängen absetzen: + +\begin{alltt} +> \Ucom{make all} +> \Ucom{su} +> \Ucom{make install strip} +\end{alltt} + +Nachdem Sie Ihre Binaries installiert haben, sollten Sie die normalen +Installationsnacharbeiten durchführen, die im Abschnitt~\ref{sec:postinstall} +auf Seite~\pageref{sec:postinstall} beschrieben sind. + +Wenn Sie lauf"|fähige Programme erstellt haben und diese Anderen zur Verfügung stellen wollen, sollten Sie uns kontaktieren. Wir würden uns freuen, sie auf den \TL-\acro{WWW}-Seiten anzubieten. +\end{comment} + +% ============================================================== +\section{Danksagungen} + +Die {\TL} ist eine gemeinsame Arbeit faktisch aller {\TeX} Users +Groups. + +Die Entwicklung des vorliegende \TL-Releases wurde von Sebastian~Rahtz und Karl~Berry geleitet; +die übrigen Haupt-Mitarbeiter sind im Folgenden aufgelistet. + +\begin{itemize} +\item die deutschsprachige \TeX-Anwendervereinigung (\acro{DANTE} e.\,V.), + die den Rechner zur Verfügung stellt, auf der die \TL-Quellen + produziert und weiter entwickelt werden; Rainer~Schöpf und + Reinhard~Zierke, die sich um Rechner und Service kümmern; + Volker~RW~Schaa und Klaus~Höppner vom \acro{DANTE}-Vorstand, die die Produktion + mit Lehmanns-Buchhandlungen (\url{http://www.lob.de/}) koordinieren. +\item die Perforce Company, die uns eine kostenlose Kopie ihrer + exzellenten ">Change-Management"<-Software zur Verfügung + stellen, mit deren Hilfe wir den \TL-Inhalt gepflegt haben; +\item Peter Breitenlohner und das \eTeX\-Team für den stabilen Grundstock zu {\TeX}s Zukunft; +\item Thomas~Esser, der mit dem exzellenten {\teTeX} die Basis + für dieses {\TL} schuf und dessen ständige Hilfe das Resultat + deutlich verbessert hat; +\item Michel~Goossens, als Coautor der englischen Original-Dokumentation; +\item Eitan~Gurari, mit dessen {\TeX4ht} die \HTML-Version dieser + Anleitung erstellt wurde und der unermüdlich daran gearbeitet + hat, es auf Zuruf zu verbessern; +\item Hans Hagen, der den größten Teil der notwendigen Tests durchführte und das \ConTeXt-Format an das \TL-System + anpasste; +\item Pawe{\l} Jackowski für das Installationsprogramm \cmdname{tlpm} für + Windows, + Tomasz {\L}uczak für \cmdname{tlpmgui}; +\item \Thanh, Martin~Schröder und das \pdfTeX-Team, die die Arbeiten zur Erweiterung der Möglichkeiten von + {\TeX} fortgesetzt haben; +\item Petr~Olsak, der das tschechische und slowakische Material sehr sorgfältig er- und überarbeitet hat; +\item Fabrice~Popineau für den Windows-Programme von {\TL}; +\item Staszek~Wawrykiewicz, der Haupttester für alles, was mit {\TeX} zusammen hängt, Koordinator der polnischen + Beiträge, Windows-Installation und mehr; +\item Olaf~Weber für die Geduld beim Zusammenpuzzeln und Pflegen + von \Webc, von dem alles Andere abhängt; +\item Gerben~Wierda für das Erstellen und Pflegen des \MacOSX-Teils und für viele Integrations- und Testarbeiten; +\item Graham~Williams, dessen Arbeit das Makro- und Paketverzeichnis möglich gemacht hat. +\end{itemize} + +\textbf{Lauf"|fähige Programme:} + +\begin{itemize*} +\item Tigran~Aivazian (\pkgname{x86\_64-linux}), +\item Manfred~Lotz (\pkgname{i386-freebsd}), +\item Fabrice~Popineau (\pkgname{win32}), +\item Norbert~Preining (\pkgname{alpha-linux}), +\item Vladimir~Volovich (\pkgname{powerpc-aix}, \pkgname{sparc64-linux}) und + \pkgname{sparc-linux}, +\item Staszek~Wawrykiewicz (\pkgname{i386-linux}), +\item Olaf~Weber (\pkgname{mips-irix}), +\item Gerben~Wierda (\pkgname{i386-darwin}, \pkgname{powerpc-darwin}) +\end{itemize*} + +\textbf{Dokumentation und Anpassung der Übersetzungen:} + +\begin{itemize*} +\item Karl~Berry (Englisch), +\item Daniel~Flipo \& Fabrice~Popineau (Französisch), +\item Klaus Höppner \& Hartmut~Henkel (Deutsch) mit Unterstützung von + Günter Partosch, Holger Horn, Wolfgang Engelmann und Heiko Oberdiek, +\item Petr~Sojka \& Jan~Busa (Tschechisch/""Slowakisch), +\item Boris~Veytsman (Russisch), +\item Staszek~Wawrykiewicz (Polnisch). +\end{itemize*} + +Natürlich haben wir am meisten Donald~Knuth zu danken, einmal dafür, dass er {\TeX} erfand und dann dafür, dass er es +der Welt schenkte. + +% ------------------------------------------------------------- +\section{Geschichtliches}\label{sec:history} + +Diese Ausgabe der {\TL} ist in Zusammenarbeit der {\TUG} (\acro{TUG}), der +\UKTUG, der französischen \TeX-Vereinigung GUTenberg +und der deutschsprachigen \TeX-Anwendervereinigung (DANTE e.\,V.) +unter Mithilfe der niederländischen, tschechischen/""slowakischen, +indischen, polnischen und russischen \TeX-Benutzergruppen +entstanden. + +\subsection{Vergangenheit} + +Die niederländische \TeX-Benutzergruppe hatte Ende 1993 mit der +Produktion der 4All\TeX-{\CDROM} für \acro{MS-DOS} die Diskussion angeregt, +eine einzige {\CDROM} für alle Rechnersysteme zu entwickeln. Zum +damaligen Zeitpunkt war dieses Ziel zu hoch gesteckt, doch immerhin +entstand aus dieser Diskussion nicht nur die sehr erfolgreiche +4All\TeX-{\CDROM}, sondern auch die \acro{TUG}-Arbeitsgruppe zur Definition +der {\TeX} Directory Structure \TDS, die die zur Arbeit mit {\TeX} +notwendigen und hilfreichen Dateien in eine konsistente und +handhabbare Verzeichnisstruktur einbettet. Das ">Final~Draft"<-Dokument, +das diese Verzeichnisstruktur festlegt, wurde in der Dezember-Ausgabe +1995 der TUGBoat veröffentlicht. Schon frühzeitig war den Beteiligten +klar, dass eine {\CDROM} auf der Basis der {\TDS} sehr zu begrüßen wäre. +Die \TL-{\CDROM} war das direkte Resultat der Beratungen der +\TDS-Arbeitsgruppe. Außerdem hat der Erfolg der 4All\TeX-{\CDROM} +klargemacht, dass ein ähnliches System auch für \acro{UNIX}-Benutzer eine +Erleichterung darstellen würde. Dies war der zweite Beweggrund für +die \TL-\CDROM. + +Im Herbst 1995 wurde das Projekt, eine \TDS-basierte \acro{UNIX}-{\CDROM} +zu entwickeln, in Angriff genommen. Sehr schnell stießen die +Verantwortlichen auf das \teTeX-System von Thomas~Esser als +idealen Ausgangspunkt für diese Arbeit, weil es verschiedene +Rechnerplattformen unterstützte und für die Arbeit mit verschiedenen +Dateisystemen vorgesehen war. Anfang 1996 wurde in Zusammenarbeit +mit Thomas~Esser ernsthaft mit der Arbeit begonnen und im Mai~1996 +die erste Ausgabe der {\CDROM} veröffentlicht. + +Anfang 1997 stellte +Karl~Berry eine neue Version seines \Webc-\TeX-Systems vor, das +schon nahezu alle Ausstattungsmerkmale aufwies, die Thomas~Esser +mit {\teTeX} verwirklicht hatte. Die \acro{TUG} entschied sich daraufhin, +die zweite Version der {\CDROM} auf der Basis von {\Webc} unter +Verwendung des Installations-Skripts \cmdname{texconfig} aus dem +\teTeX-Paket zu entwickeln. + +Die dritte Ausgabe basierte auf der +inzwischen von Olaf~Weber gepflegten und weiter entwickelten +{\Webc}~Version~7.2; {\TL} unterstützte fast alle Eigenschaften +der zur selben Zeit entstandenen neuen Version von \teTeX. + +Die vierte Ausgabe folgte demselben Schema, indem ihr neue +Versionen von {\teTeX} und {\Webc}~(7.5) zugrunde lagen. +Fast die gesamte {\CDROM} wurde einer kritischen Überprüfung +unterzogen, wobei besonders darauf geachtet wurde, dass doppelte +Dateien entfernt wurden und die Einordnung der Pakete konsistent +erfolgte. Zudem enthielt diese Ausgabe ein komplettes Windows-Setup. + +Für die fünfte Ausgabe im März~2000 wurden wiederum große Teile der +{\CDROM} ersetzt, wobei Hunderte von überarbeiteten Paketen aufgenommen +wurden. {\OMEGA}, {\pdfTeX} und Teile der \TeX-Support-Programme (hier +insbesondere \cmdname{xdvi}, \cmdname{dvips} und \cmdname{tex4ht}) +lagen in neuer Version vor. +Die Hauptänderung bei der \TL\,5 betraf die \samp{non-free}-Software. +Alles auf dieser {\CDROM} war nun in Übereinstimmung mit den \emph{Debian +Free Software Guidelines} (\url{http://www.debian.org/intro/free}). +Wir haben unser Bestes versucht, die Lizenzbedingungen aller Pakete +zu überprüfen, sind aber dankbar, wenn wir auf Fehler hingewiesen werden. + +Die sechste Ausgabe der {\TL} vom Juli/August~2001 +enthielt die neuesten Versionen aller Pakete und Programme. +Das neue Installationskonzept stellte die größte Änderung dar: +Der Benutzer konnte nun viel genauer +gewünschte bzw. nicht erwünschte Sammlungen +und Pakete auswählen. Dabei wurden die sprachspezifischen Sammlungen +komplett überarbeitet, so dass sie jetzt automatisch nicht nur +Makros, Fonts usw. installierten, sondern zusätzlich die notwendigen +Einträge in \file{language.dat} vornahmen. + +Die siebte Ausgabe vom Mai~2002 enthält als größte +Änderungen {\MacOSX} und wieder unzählige Updates aller Pakete und Programme. +Ein wesentliches Ziel war zudem die Wiedererstellung einer gemeinsamen +Quelle mit {\teTeX}, um das Auseinanderlaufen seit \TL\,5 und \TL\,6 +zu korrigieren. + +\subsection{2003} + +Im Jahr 2003 war die Flut von Updates und neuen Paketen so groß geworden, +dass wir feststellen mussten: ">{\TL} passt nicht mehr auf eine einzelne +\CDROM"<. Und so wurde sie in drei verschiedene Distributionen aufgeteilt +(siehe Abschnitt~\ref{sec:multiple-dist} auf Seite~\pageref{sec:multiple-dist}). +Des Weiteren: + +\begin{itemize} +\item Auf Wunsch des \LaTeX-Teams wurde der Standard für \cmdname{latex} + und \cmdname{pdflatex} verändert; beide benutzen nun {\eTeX} als Basis + (siehe Seite~\pageref{text:etex}). +\item Die neuen ">Latin Modern Fonts"< wurden aufgenommen (und werden + zur Benutzung empfohlen). +\item Der Support für Alpha-\acro{OSF} wurde aufgegeben (den + \acro{HPUX}-Support hatte es schon zuvor ereilt), da + niemand mehr in der Lage war, neue Binaries zu kompilieren. +\item Das Setup für Windows wurde grundlegend überarbeitet. + Zum ersten Mal wurde eine integrierte Umgebung eingeführt, + die auf \cmdname{XEmacs} basiert. +\item Wichtige Hilfsprogramme für Windows (Perl, Ghost\-script, + Image\-Magick, Ispell) werden nun im \TL-Verzeichnis + installiert. +\item Die von \cmdname{dvips}, \cmdname{dvipdfm} und \cmdname{pdftex} + benutzten Font-Mapfiles werden vom neuen Programm + \cmdname{updmap} generiert und in \dirname{texmf/fonts/map} + installiert. +\item \TeX, {\MF} und {\MP} geben nun die meisten 8"~Bit-Input"~Zeichen (Position 32 und oberhalb) unverändert + aus in (\verb|\write|)-Files, Logfiles und auf dem Terminal. + Das bedeutet, dass sie \emph{nicht} mit der \verb|^^|-Notierung + übersetzt ausgegeben werden. Auf der \TL\,7 war diese + Übersetzung abhängig von der \cmdname{locale}-Einstellung des + Systems; nun beeinflussen \cmdname{locale}-Einstellung nicht + {\TeX}s Programmverhalten. Falls Sie aus irgendwelchen + Gründen die \verb|^^|-Ausgabe benötigen, müssen Sie in Ihrem System + die Datei \file{texmf/web2c/cp8bit.tcx} umbenennen + (zukünftige Versionen werden eine sauberere Schnittstelle zur + Kontrolle dieses Verhaltens anbieten). +\item Die Dokumentation wurde grundlegend überarbeitet. +\item Zum Abschluss einigten wir uns auf eine neue Edition-Nummerierung. + Ab diesem Jahr trägt die {\TL} statt einer fortlaufenden Nummer + die Jahreszahl: \TL~2003. +\end{itemize} + +\subsection{2004} + +\begin{itemize} +\item Wenn Sie lokal installierte Zeichensätze mit ihren eigenen \filename{.map}- oder (weniger wahrscheinlich) + \filename{.enc}-Dateien benutzen, müssen Sie möglicherweise diese Dateien verschieben. + + Nach den \filename{.map}-Dateien wird jetzt in den \dirname{fonts/map}-Unterverzeichnissen im + \envname{TEXFONTMAPS}-Pfad gesucht (in jedem \filename{texmf}-Baum). + Gleichzeitig werden \filename{.enc}-Dateien jetzt in den \dirname{fonts/enc}-Unterverzeichnissen entlang des + \envname{ENCFONTS}-Pfads gesucht. Das Programm \cmdname{updmap} versucht, bei problematischen Dateien zu warnen. + + Informationen darüber, wie das gehandhabt wird, und zusätzliche Informationen finden Sie unter + \url{http://tug.org/texlive/mapenc.html}. + +\item Die \TK\ wurde für all diejenigen, die diese Implementierung {\Webc} vorziehen, um eine \MIKTEX-basierte und + installierbare {\CDROM} erweitert. Siehe dazu auch Abschnitt~\ref{sec:struct-tl} auf + Seite~\pageref{sec:struct-tl}. + +\item In der {\TL} wurde der umfangreiche \dirname{texmf}-Baum früherer Versionen durch drei Teilbäume ersetzt: + \OnCD{texmf}, \OnCD{texmf-dist} und \OnCD{texmf-doc}. Siehe dazu Abschnitt~\ref{sec:tld} auf + Seite~\pageref{sec:tld} und die \filename{README}-Dateien in den drei Zweigen. + +\item Alle \TeX-relevanten Eingabedateien sind jetzt in den \dirname{tex}-Unterverzeichnissen der + \dirname{texmf*}-Bäume zusammengefasst und nicht mehr in den parallelen Verzeichnissen \dirname{tex}, + \dirname{etex}, \dirname{pdftex}, \dirname{pdfetex}, usw. Siehe dazu + \CDref{texmf-doc/doc/english/tds/tds.html\#Extensions}{\texttt{texmf-doc/doc/english/tds/tds.html\#Extensions}}. + +\item Hilfs-Skripte, die der Anwender nicht selbst aufruft, werden jetzt in den \mbox{neuen} + \dirname{scripts}-Unterverzeichnissen der \dirname{texmf*}-Bäume aufbewahrt. Nach ihnen wird per + \samp{kpsewhich -format=texmfscripts} gesucht. Wenn Sie Programme einsetzen, die solche Skripte aufrufen, müssen + sie angepasst werden. Siehe dazu \CDref{texmf-doc/doc/english/tds/tds.html\#Scripts} +{\texttt{texmf-doc/doc/english/tds/tds.html\#Scripts}}. + +\item (Fast) alle Formate interpretieren -- an Stelle einer Übersetzung durch die \verb|^^|-Notation -- mittels + des ">translation files"< \filename{cp227.tcx} die meisten Zeichen als direkt ausgebbar. Insbesondere werden + die Zeichen an den Positionen 32--256, zusätzlich \acro{TAB}, \acro{VT} (vertical tab; vertikaler Tab) und + \acro{FF} (form feed; Seitenvorschub), als druckbar angesehen und daher nicht übersetzt. Ausnahmen sind + \plainTeX, bei dem nur die Zeichen an den Positionen 32--127 druckbar sind, {\ConTeXt} (mit druckbaren Zeichen an + den Positionen 0--255) und die \OMEGA-verwandten Formate. Dieses voreingestellte Verhalten ist (fast) identisch + mit dem in \TL\,2003; es ist aber jetzt klarer und mit umfangreicheren Anpassungsmöglichkeiten implementiert. + Siehe dazu \CDref{texmf/doc/web2c/web2c.html\#TCX-files} +{\texttt{texmf/doc/web2c/web2c.html\#TCX-files}}. + + \textbf{Anmerkung:} Da {\TeX} byte-orientiert ist, können bei einer Unicode-Eingabe (2-Byte-Zeichen) im Kontext + von Fehlermeldungen Folgen von 1-Byte-Zeichen ausgegeben werden. + +\item \cmdname{pdfetex} ist jetzt die voreingestellte ">Engine"< für alle Formate mit Ausnahme von + \mbox{(plain-)\cmdname{tex}} selbst (natürlich generiert es \dvi-Code, wenn es als \cmdname{latex}, usw. + aufgerufen wird.). Das bedeutet unter vielen anderen Dingen, dass die mikrotypographischen Fähigkeiten von + \cmdname{pdftex} + wie auch die Erweiterungen von {\eTeX} in \LaTeX, \ConTeXt usw. zur Verfügung stehen + (\OnCD{texmf-dist/doc/etex/base/}). + + Das bedeutet, dass es \emph{wichtiger denn je} ist, das Paket \pkgname{ifpdf} zu benutzen (es arbeitet sowohl mit + {\plainTeX} als auch mit \LaTeX), da der einfache Test, ob \cs{pdfoutput} oder ein anderer \TeX-Grundbefehl + (primitive) definiert ist, nicht verlässlich genug ist für die Entscheidung, ob eine \pdf-Ausgabe erzeugt wird. + Wir haben das rückwärts-kompatibel gemacht, so gut wir das dieses Jahr konnten; nächstes Jahr aber soll + \cs{pdfoutput} so beschaffen sein, dass dieser Befehl auch dann definiert ist, wenn {\dvi}-Code erzeugt wird. + +\item \pdfTeX\ (\url{http://pdftex.org/}) hat viele neue Besonderheiten: + \begin{itemize} + \item Die Befehle \cs{pdfmapfile} und \cs{pdfmapline} ermöglichen einen Font"~Map-Support innerhalb eines + Dokuments. + \item Mikrotypografische Zeichensatz-Expansion (font expansion) kann jetzt viel leichter benutzt werden + \url{http://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html}. + \item Alle Parameter, die früher in der speziellen Konfigurationsdatei \filename{pdftex.cfg} definiert wurden, + müssen jetzt mit Hilfe von \pdfTeX-Grundbefehlen gesetzt werden, typischerweise in + \filename{pdftexconfig.tex}; die Konfigurationsdatei \filename{pdftex.cfg} wird nicht länger unterstützt. + Jede schon bestehende Format-Datei (\filename{.fmt}) muss neu erstellt werden, wenn + \filename{pdftexconfig.tex} geändert wird. + \item Für zusätzliche Informationen siehe das \pdfTeX-Handbuch: \OnCD{texmf/doc/pdftex/manual}. + \end{itemize} + +\item Der Grundbefehl \cs{input} in \cmdname{tex} (\cmdname{mf} und \cmdname{mpost}) akzeptiert jetzt doppelte + Anführungszeichen und andere Spezialzeichen. Typische Beispiele: + +\begin{verbatim} +\input "filename with spaces" % plain +\input{"filename with spaces"} % latex +\end{verbatim} + + Für zusätzliche Informationen siehe das \Webc-Handbuch: \OnCD{texmf/doc/web2c}. + +\item enc\TeX\ wird jetzt in {\Webc} und damit auch in allen \TeX-Programmen unterstützt. Dazu wird \emph{beim + Generieren neuer Formate} die Option \optname{-enc} benutzt. enc\TeX\ unterstützt allgemein die Umkodierung der + Ein- und Ausgabe und ermöglicht eine volle Unicode-Unterstützung (in \acro{UTF}-8). + Siehe \OnCD{texmf-dist/doc/generic/enctex/} und \url{http://www.olsak.net/enctex.html}. + +\item Aleph (\ensuremath{\aleph}), eine neue ">Engine"<, die {\eTeX} und {\OMEGA} vereinigt, ist verfügbar. Ein bisschen + Information darüber finden Sie in \OnCD{texmf-dist/doc/aleph/base} und + \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=aleph}. Das \LaTeX-basierte Aleph-Format heißt + \cmdname{lamed}. + +\item Das neueste \LaTeX-Release enthält eine neue Version der \acro{LPPL}% + \footnote{LPPL: LaTeX Project Public License}, + die jetzt eine offiziell von Debian anerkannte Lizenz ist. Zusammen mit anderen Updates finden Sie Informationen + dazu in den \filename{ltnews}-Dateien in \OnCD{texmf-dist/doc/latex/base}. + +\item \cmdname{dvipng} -- ein neues Programm zum Konvertieren von \dvi-Dateien in \acro{PNG}-Bilddateien, ist + Bestandteil von \TL. Siehe \OnCD{texmf/doc/man/man1/dvipng.1}. + +\item Auf Vorschlag des Autors (Claudio~Beccari) haben wir das Paket \pkgname{cbgreek} auf einen ">mittelgroßen"< Satz + von Fonts reduziert. Herausgenommen wurden die ">invisible"<, Outline- und ">Transparency"<-Fonts, + die relativ selten benutzt werden -- denn wir benötigen den Platz. In seinem vollen Umfang ist das Paket natürlich + weiterhin auf \acro{CTAN} verfügbar (\url{http://www.ctan.org/tex-archive/fonts/greek/cb/}). + +\item \cmdname{oxdvi} wurde entfernt; benutzen Sie jetzt \cmdname{xdvi}. + +\item Die \cmdname{ini}- und \cmdname{vir}-Befehle (Links) für \cmdname{tex}, \cmdname{mf} and \cmdname{mpost} sind + nicht mehr länger verfügbar, so auch \cmdname{initex}. Das ist kein richtiger Verlust, da die + \cmdname{ini}-Funktionalität schon seit mehreren Jahren über den Aufrufparameter \optname{-ini} zur Verfügung + steht. + +\item Die Unterstützung der Plattform \cmdname{i386-openbsd} wurde entfernt. Da das Paket \pkgname{tetex} im + \acro{BSD}-Ports-System zur Verfügung steht und Binaries für \acro{GNU}/""Linux and Free\acro{BSD} erhältlich sind, + erschien es sinnvoll, die Zeit der Freiwilligen besser zu nutzen. + +\item Zumindest auf \cmdname{sparc-solaris} müssen Sie ggf. die En"-viron"-ment-Variable \envname{LD\_LIBRARY\_PATH} + setzen, um die \pkgname{t1utils}-Programme laufen lassen zu können. Ursache dafür ist, dass die Programme mit C++ + kompiliert wurden und dass es keinen Standard-Platz für Laufzeit-Bibliotheken gibt (das ist zwar auch im Jahre + 2004 nicht neu, wurde aber bisher nicht dokumentiert.) Unter \cmdname{mips-irix} werden die + \acro{MIPS}pro-7.4-Laufzeit-Bibliotheken benötigt. +\end{itemize} + +\subsection{Gegenwart}\label{tlcurrent} + +Im Jahr 2005 gab es -- wie üblich -- viele aktualisierte Pakete und +Programme. Die Struktur des Systems blieb weitgehend gleich, mit folgenden +Ausnahmen: + +\begin{itemize} +\item Die neuen Skripte \cmdname{texconfig-sys}, \cmdname{updmap-sys} und + \cmdname{fmtutil-sys} für die systemweite Konfiguration des Systems wurden + hinzugefügt. Die Skripte \cmdname{texconfig}, \cmdname{updmap} und + \cmdname{fmtutil} modifizieren nun die Konfiguration für einen einzelnen + Nutzer unter \dirname{\$HOME/.texlive2005}. + Siehe Abschnitt~\ref{sec:texconfig} auf Seite~\pageref{sec:texconfig}. +\item Analog spezifizieren die Pfade \envname{TEXMFCONFIG} und + \envname{TEXMFSYSCONFIG} nun, wo die Konfigurationsdateien gefunden + werden (für einen einzelnen Nutzer bzw. systemweit). Möglicherweise + müssen Sie daher vorhandene eigene Versionen von + \filename{fmtutil.cnf} oder \filename{updmap.cfg} in die entsprechenden + Pfade verschieben. Alternativ können Sie \envname{TEXMFCONFIG} und + \envname{TEXMFSYSCONFIG} in der Datei \filename{texmf.cnf} umdefinieren, + dass diese auf die Speicherorte Ihrer eigenen Konfigurationsdateien + verweisen. Siehe Abschnitt~\ref{sec:texmftrees} auf Seite~\pageref{sec:texmftrees}. +\item Im letzten Jahr wurden für die Programme, die DVI als Ausgabeformat + erzeugen, die Primitive wie \verb|\pdfoutput| auf undefiniert gesetzt, + obwohl immer \cmdname{pdfetex} verwendet wurde. In diesem Jahr wurde dies + wie angekündigt nicht mehr getan. Falls in Dokumenten nun die Abfrage + \verb|\ifx\pdfoutput\undefined| zum Test benutzt wird, ob PDF oder DVI + erzeugt wird, müssen diese geändert werden! Benutzen Sie das Paket + \pkgname{ifpdf.sty}, das auch mit dem geänderten Verhalten funktioniert, + oder orientieren Sie sich an dessen Code. +\item Im letzten Jahr wurden die Formate so geändert, dass sie Zeichen + als 8-bit ausgeben. Die neue TCX-Datei \filename{empty.tcx} eröffnet nun + einen einfachen Weg, die originale Ausgabe mit \verb|^^|-Notation zu + erhalten, wenn Sie es wünschen: +\begin{verbatim} +latex --translate-file=empty.tcx yourfile.tex +\end{verbatim} +\item Das Programm \cmdname{dvipdfmx} für die Konvertierung von DVI nach + PDF ist neu hinzugekommen. Dies ist eine aktiv gepflegte Erweiterung von + \cmdname{dvipdfm}, das zwar noch verfügbar ist, aber als obsolet angesehen + werden kann. +\item Ebenso sind die Programme \cmdname{pdfopen} und \cmdname{pdfclose} neu + hinzugekommen. Diese erlauben ein Reload von PDF-Dateien im Acrobat Reader, + ohne diesen neu starten zu müssen (andere PDF-Viewer wie \cmdname{xpdf}, + \cmdname{gv} oder \cmdname{gsview} hatten damit nie Probleme). +\item Aus Konsistenzgründen wurden die Variablen \envname{HOMETEXMF} und + \envname{VARTEXMF} in \envname{TEXMFHOME} bzw. \envname{TEXMFSYSVAR} + umbenannt. Weiterhin existiert \envname{TEXMFVAR} für einen Baum, der + spezifisch für einen einzelnen Nutzer ist. +\end{itemize} + +% ------------------------------------------------------------- +\subsection{Zukunft} + +\emph{{\TL} ist nicht perfekt! -- und wird es auch nie sein.} Wir planen im Abstand von +jeweils einem Jahr Neuauf"|lagen zu produzieren, die umfangreichere +Hilfstexte, mehr Hilfsprogramme, mehr Installationshilfen und (natürlich) +den ständig verbesserten und überprüften Satz der Makros und Zeichensätze +enthalten. Diese Arbeit wird von Freiwilligen in ihrer knappen Freizeit +geleistet. Viel Arbeit steht noch an. Wenn Sie uns helfen können, +zögern Sie keine Sekunde, sich bei uns zu melden. + +Verbesserungen, Anregungen und Erweiterungen für künftige Ausgaben +der {\TK} senden Sie bitte an:\hfill\null + +\begin{quote} +Sebastian Rahtz\\ +{}7 Stratfield Road\\ +Oxford OX2 7BG\\ +United Kingdom\\ +E"~Mail: \email{tex-live@tug.org}\\ +\url{http://tug.org/texlive/} +\end{quote} + +Neue Versionen, Anmerkungen und zusätzliches Material werden über +die \CTAN-Server im Verzeichnis \dirname{info/texlive} zur Verfügung gestellt. +Im \acro{WWW} können Sie sich über die Adresse +\url{http://www.tug.org/tex-live/} informieren und die Bestellformalitäten +einsehen. + +\end{document} |