<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">\setchapterpreamble{\tudhyperdef'{sec:install:ext}}
\chapter{WeiterfÃ¼hrende Installationshinweise}
%
\noindent\Attention{%
  Hier werden unterschiedliche Varianten erlÃ¤utert, wie \TUDScript in der 
  Version~\vTUDScript{} genutzt werden kann, falls eine frÃ¼here Variante als 
  \textbf{lokale Nutzerinstallation} verwendet wurde.
}

\bigskip\noindent
Bis zur Version~v2.01 wurde \TUDScript ausschlieÃŸlich Ã¼ber das \Forum zur 
lokalen Nutzerinstallation angeboten. In erster Linie hat das historische 
HintergrÃ¼nde und hÃ¤ngt mit der Entstehungsgeschichte von \TUDScript zusammen. 
Eine lokale Nutzerinstallation bietet einen~-- eher zu vernachlÃ¤ssigenden~-- 
Vorteil. Treten bei der Verwendung von \TUDScript Probleme auf, kÃ¶nnen diese im 
Forum gemeldet und diskutiert werden. Ist fÃ¼r ein solches Problem tatsÃ¤chlich 
eine Fehlerkorrektur respektive Aktualisierung von \TUDScript nÃ¶tig, kann diese 
schnell und unkompliziert Ã¼ber das \GitHubRepo bereitgestellt und durch den 
Anwender sofort genutzt werden.

Dies hat allerdings fÃ¼r alle Anwender, welche das Forum relativ wenig oder gar 
nicht besuchen, den groÃŸen Nachteil, dass Sie nicht von Aktualisierungen, 
Verbesserungen und Fehlerkorrekturen neuer Versionen profitieren kÃ¶nnen. Auch 
alle nachfolgenden Bugfixes und Aktualisierungen des \TUDScript-Bundles mÃ¼ssen 
durch den Anwender manuell durchgefÃ¼hrt werden. Daher wird die Verbreitung via 
\CTAN[pkg/tudscr] prÃ¤feriert, sodass \TUDScript stets in der gerade aktuellen 
Version verfÃ¼gbar ist~-- eine durch den Anwender aktuell gehaltene 
\hologo{LaTeX}"=Distribution vorausgesetzt. Der einzige Nachteil bei diesem 
Ansatz ist, dass die Verbreitung eines Bugfixes und die anschlieÃŸende 
Bereitstellung durch die verwendete Distribution fÃ¼r gewÃ¶hnlich bis zu zwei 
Tagen dauert.

Die gÃ¤ngigen \hologo{LaTeX}"=Distributionen durchsuchen im Regelfall zuerst das 
lokale \Path{texmf}"=Nutzerverzeichnis nach Klassen und Paketen und erst daran 
anschlieÃŸend den \Path{texmf}"=Pfad der Distribution selbst. Dabei spielt es 
keine Rolle, in welchem Pfad die neuere Version einer Klasse oder eines Paketes 
liegt. Sobald im Nutzerverzeichnis die gesuchte Datei gefunden wurde, wird die 
Suche beendet.
\Attention{%
  In der Konsequenz bedeutet dies, dass sÃ¤mtliche Aktualisierungen Ã¼ber CTAN 
  nicht zum Tragen kommen, falls \TUDScript als lokale Nutzerversion 
  installiert wurde.
}

Deshalb wird Anwendern empfohlen, eine gegebenenfalls vorhandene lokale 
Nutzerinstallation von \TUDScript zu deinstallieren, falls diese nicht 
\emph{bewusst} installiert wurde. Die Deinstallation wird in 
\autoref{sec:local:uninstall} erlÃ¤utert. Nach dieser kÃ¶nnen Updates des 
\TUDScript-Bundles durch die Aktualisierungsfunktion der Distribution erfolgen. 

Wie das \TUDScript-Bundle trotzdem als lokale Nutzerversion installiert oder 
aktualisiert werden kann, ist in \autoref{sec:local:install} beziehungsweise 
\autoref{sec:local:update} zu finden. Der Anwender sollte in diesem Fall 
allerdings genau wissen, was er damit bezweckt, da er in diesem Fall fÃ¼r die 
Aktualisierung von \TUDScript selbst verantwortlich ist.

\minisec{Nutzung der veralteten Schriftfamilien}
\ChangedAt{v2.06}%
%
Soll ein Dokument noch mit den veralteten Schriftfamilien \Univers und \DIN 
gesetzt werden, so ist eine lokale Installation der Type1-Schriften notwendig, 
welche in \autoref{sec:install:fonts} beschrieben wird. ZusÃ¤tzlich sei auf die 
beiden Optionen \Option*{tudscrver=2.05} und \Option*{cdoldfont} hingewiesen. 
FÃ¼r die Nutzung der \OpenSans wird lediglich die aktuelle Version des Paketes 
\Package{opensans} benÃ¶tigt, welches auf \CTAN[pkg/opensans] zu finden ist.


\section{Lokale Deinstallation des \TUDScript-Bundles}
\tudhyperdef*{sec:local:uninstall}%
\index{Deinstallation}%
%
Ãœber die Kommandozeile beziehungsweise das Terminal kann mit
%
\begin{quoting}
\Path{kpsewhich --all tudscrbase.sty}
\end{quoting}
%
Ã¼berprÃ¼ft werden, ob eine lokale Nutzerinstallation von \TUDScript vorhanden 
ist. Es werden alle Pfade ausgegeben, in denen die Datei \File*{tudscrbase.sty} 
gefunden wird. Erscheint nur der Distributionspfad, ist die \TUDScript-Version 
von CTAN aktiv und der Anwender kann mit dem \TUDScript-Bundle arbeiten.

Wird \emph{nur} das lokale Nutzerverzeichnis oder gar kein Verzeichnis 
gefunden, so wird hÃ¶chstwahrscheinlich eine veraltete Distribution 
verwendet. In diesem Fall wird eine Aktualisierung dieser \emph{unbedingt} 
empfohlen. Sollte dies nicht mÃ¶glich sein, \emph{muss} \TUDScript als lokale 
Nutzerversion installiert (\autoref{sec:local:install}) beziehungsweise~-- 
falls ein Pfad ausgegeben wurde~-- aktualisiert (\autoref{sec:local:update}) 
werden.

Sollte neben dem Pfad der Distribution noch mindestens ein weiterer Pfad 
angezeigt werden, so ist eine lokale Nutzerversion installiert. In 
diesem Fall hat der Anwender drei MÃ¶glichkeiten:
%
\begin{enumerate}
\item Entfernen der lokalen Nutzerinstallation (skriptbasiert)
\item Entfernen der lokalen Nutzerinstallation (manuell)
\item Aktualisierung der lokalen Nutzerversion (\autoref{sec:local:update})
\end{enumerate}
%
Um die lokale Nutzerinstallation zu entfernen, kann fÃ¼r Windows
\hrfn{\Download{uninstall/tudscr\_uninstall.bat}}{\File{tudscr\_uninstall.bat}}
sowie fÃ¼r unixartige Betriebssysteme
\hrfn{\Download{uninstall/tudscr\_uninstall.sh}}{\File{tudscr\_uninstall.sh}}
verwendet werden. Nach der AusfÃ¼hrung des jeweiligen Skriptes kann mit dem zu 
Beginn gezeigten Aufruf in der Kommandozeile respektive Terminal geprÃ¼ft 
werden, ob die Deinstallation erfolgreich war. Wird immer noch mindestens ein 
lokaler Pfad ausgegeben, sollte \TUDScript manuelle deinstalliert werden, was 
nachfolgend beschrieben wird.

Nur die Deinstallation aller lokalen Nutzerinstallationen von \TUDScript 
ermÃ¶glicht die Verwendung der jeweils aktuellen CTAN"=Version. HierfÃ¼r ist~-- 
unter der Annahme, dass das automatisierte Deinstallieren mithilfe der zuvor 
genannten Skripte zur Deinstallation nicht erfolgreich war~-- etwas Handarbeit 
durch den Anwender vonnÃ¶ten. Der in der Kommandozeile respektive im Terminal mit
%
\begin{quoting}
\Path{kpsewhich --all tudscrbase.sty}
\end{quoting}
%
gefundene~-- zum Ordner der Distribution \emph{zusÃ¤tzliche}~-- Pfad hat die 
folgende Struktur:
%
\begin{quoting}
\Path{\PName{Installationspfad}/tex/latex/tudscr/tudscrbase.sty}
\end{quoting}
%
Um die Nutzerinstallation vollstÃ¤ndig zu entfernen, muss als erstes zu 
\Path{\PName{Installationspfad}} navigiert werden. AnschlieÃŸend ist in diesem 
Pfad Folgendes durchzufÃ¼hren:
%
\settowidth\tempdim{\Path{tex/latex/tudscr/}}%
\begin{description}[labelwidth=\tempdim,labelsep=1em]
\item[\Path{tex/latex/tudscr/}]\File*{.cls}- und \File*{.sty}"~Dateien lÃ¶schen
\item[\Path{tex/latex/tudscr/}]Ordner \Path{logo} vollstÃ¤ndig lÃ¶schen
\item[\Path{doc/latex/}] Ordner \Path{tudscr} vollstÃ¤ndig lÃ¶schen
\item[\Path{source/latex/}] Ordner \Path{tudscr} vollstÃ¤ndig lÃ¶schen
\end{description}
%
Zum Abschluss ist in der Kommandozeile beziehungsweise im Terminal der Befehl 
\Path{texhash} aufzurufen. Damit wurde die lokale Nutzerversion entfernt und es 
wird von nun an die Version von \TUDScript genutzt, welche durch die verwendete 
Distribution bereitgestellt wird.



\section{Lokale Installation des \TUDScript-Bundles}
\tudhyperdef*{sec:local:install}%
\index{Installation!Nutzerinstallation|(}%
%
Eine lokale Nutzerinstallation von \TUDScript sollte ausschlieÃŸlich durch 
Anwender ausgefÃ¼hrt werden, die genau wissen, aus welchen GrÃ¼nden dies 
geschehen soll. HierfÃ¼r werden die passenden Skripte angeboten. FÃ¼r eine lokale 
Nutzerinstallation des \TUDScript-Bundles unter Windows fÃ¼r die Distributionen 
\Distribution{\hologo{TeX}~Live} oder \Distribution{\hologo{MiKTeX}} werden die 
Dateien aus
\hrfn{\Download{\vTUDScript/TUD-Script\_\vTUDScript\_Windows.zip}}%
{\File*{TUD-Script\_\vTUDScript\_Windows.zip}}
benÃ¶tigt. FÃ¼r unixoide Betriebssysteme sind es die Dateien aus 
\hrfn{\Download{\vTUDScript/TUD-Script\_\vTUDScript\_Unix.zip}}%
{\File*{TUD-Script\_\vTUDScript\_Unix.zip}}.

Beim AusfÃ¼hren des spezifischen Installationsskripts~-- 
\File{tudscr\_\vTUDScript\_install.bat} fÃ¼r Windows respektive 
\File{tudscr\_\vTUDScript\_install.sh} fÃ¼r unixoide Betriebssysteme~-- werden 
alle Dateien in das lokale Nutzerverzeichnis der jeweiligen Distribution 
installiert, falls kein anderes Verzeichnis explizit angegeben wird. 
\Attention{%
  In jedem Fall sollte vor der AusfÃ¼hrung des Installationsskripts ein Update 
  der \hologo{LaTeX}"=Distribution durchgefÃ¼hrt werden. Dies gilt insbesondere 
  bei der Nutzung von \Distribution{\hologo{MiKTeX}}. Andernfalls wird es unter 
  UmstÃ¤nden im Installationsprozess oder bei der Nutzung von \TUDScript zu 
  Problemen kommen.
}

Alternativ zur Nutzung der bereitgestellte Skripte kann auch einfach der Inhalt 
des Archivs
\hrfn{\Download{\vTUDScript/tudscr\_\vTUDScript.zip}}%
{\File{tudscr\_\vTUDScript.zip}}
in das lokale \Path{texmf}"=Nutzerverzeichnis kopiert und abschlieÃŸend in der 
Kommandozeile respektive im Terminal \Path{texhash} aufgerufen werden. 



\section{Lokales Update des \TUDScript-Bundles}
\tudhyperdef*{sec:local:update}%
\index{Update|!}%
%
\subsection{Update des \TUDScript-Bundles ab Version~v2.02}
Ein Update und die lokale Installation unterscheiden sich ab der Version~v2.06 
nicht voneinander, das Vorgehen ist absolut identisch zu der Beschreibung in 
\autoref{sec:local:install}.
\Attention{%
  Die lokale Aktualisierung auf Version~\vTUDScript{} funktioniert allerdings 
  nur, wenn \TUDScript bereits mindestens in der Version~v2.02 entweder als 
  lokale Nutzerversion oder Ã¼ber die Distribution installiert ist.%
}

\subsection{Update des \TUDScript-Bundles ab Version~v2.00}
%
Mit der Version~v2.02 gab es einige tiefgreifende Ã„nderungen. Deshalb wird fÃ¼r 
vorausgehende Versionen~-- sprich v2.00 und v2.01~-- kein dediziertes Update 
angeboten. Die Aktualisierung kann durch den Anwender entweder~-- wie in 
\autoref{sec:local:install} erlÃ¤utert~-- mit einer skriptbasierten oder mit 
einer manuellen Neuinstallation erfolgen.
\index{Installation!Nutzerinstallation|)}%


\subsection{Update des \TUDScript-Bundles von Version v1.0}
%
Ist \TUDScript in der veralteten \emph{Version~v1.0} installiert, so wird vor 
der Aktualisierung dringlichst zu einem vollstÃ¤ndigen Entfernen dieser Version 
geraten. Andernfalls werden nach einem Update bei der Verwendung massive 
Probleme und Fehler auftreten. Zur Deinstallation werden die Skripte 
\hrfn{\Download{uninstall/tudscr_uninstall.bat}}{\File{tudscr\_uninstall.bat}}
respektive
\hrfn{\Download{uninstall/tudscr_uninstall.sh}}{\File{tudscr\_uninstall.sh}}
bereitgestellt. Die aktuelle Version~\vTUDScript{} kann nach der vollstÃ¤ndigen 
Deinstallation aller veralteten Versionen wie in \autoref{sec:install:fonts} 
beschrieben installiert werden.

Im Vergleich zur \emph{Version~v1.0} hat sich an der Benutzerschnittstelle 
nicht sehr viel verÃ¤ndert, ein Umstieg auf die Version~\vTUDScript{} dÃ¼rfte 
keine Schwierigkeiten bereiten. Treten danach dennoch Probleme auf, sollte der 
Anwender als erstes die Beschreibung des Paketes \Package{tudscrcomp}'full' 
lesen, welches eine Schnittstelle zur Nutzung alter und ursprÃ¼nglich nicht mehr 
vorgesehener Befehle sowie Optionen bereitstellt. Allerdings werden einige von 
diesen auch durch das Paket \Package{tudscrcomp} nicht mehr bereitgestellt. 
AufgefÃ¼hrt sind diese in \autoref{sec:obsolete}. Sollten trotz aller Hinweise 
dennoch Fehler oder Probleme beim Umstieg auf die neue \TUDScript-Version 
auftreten, ist eine Meldung im \Forum oder im \GitHubRepo[issues] die beste 
MÃ¶glichkeit, um Hilfe zu erhalten.



\section{Installation veralteter Schriftfamilien}
\tudhyperdef*{sec:install:fonts}%
\index{Installation!Schriftinstallation|!(}%

Bis Anfang des Jahres~2018 nutzte das \TUDCD als Hausschrift nicht \OpenSans 
sondern die Schriftfamilien \Univers und \DIN. Diese lassen sich auch weiterhin 
mit \TUDScript verwenden, um alte Dokumente kompilieren zu kÃ¶nnen. HierfÃ¼r sei 
auf die Optionen \Option*{tudscrverv=2.05} und \Option*{cdoldfont} hingewiesen. 
Da es sich bei diesen um lizenzierte Schriften handelt, mÃ¼ssen diese beim 
UniversitÃ¤tsmarketing auf \hrfn{https://tu-dresden.de/cd/}{Anfrage} mit dem 
Hinweis auf die Verwendung von \hologo{LaTeX} bestellt und nach Erhalt der 
notwendigen Archive \File{Univers\_PS.zip} und \File{DIN\_Bd\_PS.zip} fÃ¼r 
Windows (\autoref{sec:install:win}) beziehungsweise unixoide Betriebssysteme 
(\autoref{sec:install:unix}) installiert werden. Ohne einen triftigen Grund 
sollte jedoch in jedem Fall die \OpenSans genutzt werden, insbesondere fÃ¼r neu 
erstellte Dokumente.

Das \TUDScript-Bundle unterstÃ¼tzt besagte Schriften auch im OpenType-Format, 
welche ebenfalls Ã¼ber das UniversitÃ¤tsmarketing auf 
\href{https://tu-dresden.de/cd/}{Anfrage} bestellt werden mÃ¼ssen. Die in den 
Archiven \File{Univers\_8\_TTF\/.zip} und \File{DIN\_TTF\/.zip} enthaltenen 
Schriften lassen sich~-- sobald diese fÃ¼r das Betriebssystem installiert 
wurden~-- mit dem Paket \Package{fontspec} verwenden. In \fullref{sec:fonts} 
sind weitere Hinweise zur Verwendung des Paketes \Package{fontspec} zu finden.

Im \GitHubRepo* sind die zur Schriftinstallation benÃ¶tigten 
\hrfn{https://github.com/tud-cd/tudscr/releases/tag/fonts}{Skripte}
ebenso zu finden wie die
\hrfn{https://github.com/tud-cd/tudscr/releases/tag/oldfonts}{Skripte}
fÃ¼r die Klassen von Klaus Bergmann. Die unterschiedlichen Installationsskripte 
begrÃ¼nden sich insbesondere dadurch, dass bei der Installation fÃ¼r das 
\TUDScript-Bundle sowohl die Metriken als auch das Kerning der Schriften fÃ¼r 
FlieÃŸtext und den Mathematikmodus angepasst werden. Sollen die so verbesserten 
Schriften fÃ¼r die Klassen von Klaus Bergmann verwendet werden, kann dies mit 
dem Paket \Package{fix-tudscrfonts} erfolgen, was allerdings das Ergebnis der 
erzeugten Ausgabe beeinflusst, weshalb die Installationsskripte in 
unterschiedlichen Varianten weiterhin vorgehalten werden.

\minisec{Erforderliche Pakete bei der Schriftinstallation}
FÃ¼r die Installation der Schriften sind die Pakete \Package*{fontinst}, 
\Package*{cmbright}, \Package*{hfbright}, \Package*{cm-super} und 
\Package*{iwona} von \emph{essentieller} Bedeutung und daher \emph{zwingend} 
notwendig. Das Vorhandensein dieser wird durch die jeweiligen 
Schriftinstallationsskripte geprÃ¼ft und die Installation beim Fehlen eines oder 
mehrerer Pakete mit einer entsprechenden Warnung abgebrochen.

\minisec{Anmerkung zu \hologo{MiKTeX}}
Vor der Installation der Schriften fÃ¼r \TUDScript sollte unbedingt ein Update 
von \Distribution{\hologo{MiKTeX}}|?| durchgefÃ¼hrt werden. AuÃŸerdem ist es sehr 
ratsam, die Installation von \Distribution{\hologo{MiKTeX}}|?| in der 
Mehrbenutzervariante mit Administratorrechten durchzufÃ¼hren, da die 
Einzelbenutzervariante relativ unregelmÃ¤ÃŸig und nicht immer nachvollziehbar zu 
Problemen fÃ¼hren kann. 

MÃ¶glicherweise sind einige der fÃ¼r den Schriftinstallationsprozess notwendigen 
Pakete noch nicht installiert. Ist die automatische Nachinstallation fehlender 
Pakete aktiviert, so reicht es im Normalfall das Installationsskript zu 
starten. Andernfalls mÃ¼ssen diese Pakete manuell durch den Benutzer Ã¼ber den 
\Distribution{\hologo{MiKTeX}}"=Paketmanager hinzugefÃ¼gt werden.

Das Installationsskript scheitert auÃŸerdem bei einigen Anwendern~-- aufgrund 
eingeschrÃ¤nkter Nutzerzugriffsrechte~-- beim Eintragen der Schriften in die 
Map"~Datei. Dies muss gegebenenfalls durch den Anwender Ã¼ber die Kommandozeile 
%
\begin{quoting}
\Path{initexmf -{}-edit-config-file updmap}
\end{quoting}
%
erfolgen. In der sich Ã¶ffnenden Datei sollte sich der Eintrag 
\Path{Map~tudscr.map} befinden. Ist dies nicht der Fall, muss diese Zeile 
manuell eingetragen und die Datei anschlieÃŸend gespeichert werden. Danach muss 
der Nutzer in der Kommandozeile noch folgenden Aufruf ausfÃ¼hren:
%
\begin{quoting}
 \Path{initexmf~-{}-mkmaps}
\end{quoting}


\minisec{Anmerkung zu \hologo{TeX}~Live und Mac\hologo{TeX}}
Sollte keine Vollinstallation von \Distribution{\hologo{TeX}~Live} durchgefÃ¼hrt 
worden sein, mÃ¼ssen die erforderlichen Pakete zur Schriftinstallation manuell 
Ã¼ber den \Distribution{\hologo{TeX}~Live}"=Paketmanager hinzugefÃ¼gt werden.

Sind nach einem fehlerfreien Durchlauf des Installationsskriptes die Schriften 
dennoch nicht verfÃ¼gbar, so muss die Synchronisierung aller Schriftdateien 
angestoÃŸen werden. Daran anschlieÃŸend mÃ¼ssen die Map"~Datei und die 
dazugehÃ¶rigen Schriftdateien registriert werden. Die hierfÃ¼r notwendigen 
Aufrufe lauten:
%
\begin{quoting}
\Path{updmap-sys -{}-syncwithtrees}\newline
\Path{updmap-sys -{}-enable Map=tudscr.map}\newline
\Path{updmap-sys -{}-force}
\end{quoting}
%
Sind die Schriften danach immer noch nicht verfÃ¼gbar, so wurden bestimmt schon 
weitere Schriften auf dem System \emph{lokal} installiert. In diesem Fall 
sollte der Vorgang nochmals fÃ¼r eine lokale Schriftinstallation mit 
%
\begin{quoting}
\Path{updmap -{}-syncwithtrees}\newline
\Path{updmap -{}-enable Map=tudscr.map}\newline
\Path{updmap -{}-force}
\end{quoting}
%
ausgefÃ¼hrt werden. Dieses Vorgehen macht allerdings den Befehl 
\Path{updmap-sys} von nun an wirkungslos. Nach einer systemweiten Installation 
neuer Schriften~-- beispielsweise bei der Aktualisierung der Distribution~-- 
mÃ¼ssen diese Ã¼ber den manuellen Aufruf von \Path{updmap} zukÃ¼nftig durch den 
Anwender lokal bei \Distribution{\hologo{TeX}~Live}|?| respektive 
\Distribution{Mac\hologo{TeX}}|?| registriert werden.

\Attention{%
  FÃ¼r die Schriftinstallation werden die Skripte \Path{tftopl}, \Path{pltotf} 
  und \Path{vptovf} benÃ¶tigt, welche bei \Distribution{\hologo{TeX}~Live}|?| 
  beziehungsweise \Distribution{Mac\hologo{TeX}}|?| Ã¼ber das Paket 
  \Package*{fontware} aus \Package*{collection-fontutils}&lt;&gt; 
  bereitgestellt werden und zwingend installiert sein mÃ¼ssen.
}


\subsection{Installation der Type1-Schriften unter Windows}
\tudhyperdef*{sec:install:win}%
%
Zur Installation der Schriften des \CDs fÃ¼r das \TUDScript-Bundle ist das Archiv
\hrfn{\Download{fonts/TUD-Script_fonts_Windows.zip}}%
{\File*{TUD-Script\_fonts\_Windows.zip}}
vorgesehen. Dieses ist sowohl fÃ¼r \Distribution{\hologo{TeX}~Live}|?| als auch
\Distribution{\hologo{MiKTeX}}|?| nutzbar und enthÃ¤lt~-- bis auf die jeweiligen 
Schriftarchive selbst~-- alle benÃ¶tigten Dateien. Diese sollten nach dem 
Entpacken des Archivs in das gleiche Verzeichnis kopiert werden. Vor der 
Verwendung des Skripts \File{tudscr\_fonts\_install.bat} sollte sichergestellt 
werden, dass sich \emph{alle} der folgenden Dateien im selben Verzeichnis 
befinden:
%
\settowidth\tempdim{\File{tudscr\_fonts\_install.zip}~}%
\begin{description}[labelwidth=\tempdim,labelsep=1em]
  \item[\File{tudscr\_fonts\_install.bat}]Installationsskript
  \item[\File{Univers\_PS.zip}]Archiv mit Schriftdateien fÃ¼r \Univers
  \item[\File{DIN\_Bd\_PS.zip}]Archiv mit Schriftdateien fÃ¼r \DIN
  \item[\File{tudscr\_fonts\_install.zip}]Archiv mit Metriken fÃ¼r die
    Schriftinstallation via \Package{fontinst}
\end{description}
%
Beim AusfÃ¼hren des Installationsskripts werden alle Schriften standardmÃ¤ÃŸig in 
ein lokales Nutzerverzeichnis installiert. Wird das Skript Ã¼ber das KontextmenÃ¼ 
mit Administratorrechten ausgefÃ¼hrt, erfolgt die Installation in einem Pfad, 
der \emph{fÃ¼r alle Nutzer} gÃ¼ltig und lesbar ist.



\subsection{Installation der Type1-Schriften unter Linux und OS~X}
\tudhyperdef*{sec:install:unix}%
%
Zur Installation der Schriften des \CDs fÃ¼r das \TUDScript-Bundle ist das Archiv
\hrfn{\Download{fonts/TUD-Script_fonts_Unix.zip}}%
{\File*{TUD-Script\_fonts\_Unix.zip}}
 vorgesehen. Dieses ist sowohl fÃ¼r \Distribution{\hologo{TeX}~Live}|?| als auch 
\Distribution{Mac\hologo{TeX}}|?| nutzbar und enthÃ¤lt~-- bis auf die jeweiligen 
Schriftdateien selbst~-- alle benÃ¶tigten Dateien. Diese sollten nach dem 
Entpacken des Archivs in das gleiche Verzeichnis kopiert werden. Vor der 
Verwendung des Skripts \File{tudscr\_fonts\_install.sh} sollte sichergestellt 
werden, dass sich \emph{alle} der folgenden Dateien im selben Verzeichnis 
befinden:
%
\begin{description}[labelwidth=\tempdim,labelsep=1em]
  \item[\File{tudscr\_fonts\_install.sh}]Installationsskript
    (Terminal: \Path{bash tudscr\_fonts\_install.sh})
  \item[\File{Univers\_PS.zip}]Archiv mit Schriftdateien fÃ¼r \Univers
  \item[\File{DIN\_Bd\_PS.zip}]Archiv mit Schriftdateien fÃ¼r \DIN
  \item[\File{tudscr\_fonts\_install.zip}]Archiv mit Metriken fÃ¼r die
    Schriftinstallation via \Package{fontinst}
\end{description}
%
\minisec{Anmerkung zu Linux und OS~X}
\Attention{%
  Nach dem Entpacken eines Release-Archivs im passenden Pfad\footnote{%
    beispielsweise \Path{cd~"\$HOME/Downloads/\PName{Unterordner}"}%
  } \textbf{muss das Skript zwingend} mit \Path{bash~\PName{Skript}.sh} im 
  Terminal in diesem Pfad mit den benÃ¶tigten Dateien aufgerufen werden.
}
Dabei werden alle Schriften standardmÃ¤ÃŸig in das lokale Nutzerverzeichnis 
(\Path{\$TEXMFHOME}) installiert. Wird das Skript mit \Path{sudo} verwendet, 
erfolgt die Installation \emph{fÃ¼r alle Nutzer} in den lokalen Systempfad 
(\Path{\$TEXMFLOCAL}).

Es ist unbedingt darauf zu Achten, das beim AusfÃ¼hren des Skriptes das Terminal 
im richtigen Verzeichnis aktiv ist. Bei den meisten unixoiden Betriebssystemen 
ist es problemlos mÃ¶glich, das Terminal aus der BenutzeroberflÃ¤che heraus Ã¼ber 
das KontextmenÃ¼ im gewÃ¼nschten Pfad zu Ã¶ffnen. Geht dies nicht, so muss nach 
dem Ã–ffnen des Terminals mit dem Befehl \Path{cd} erst zum entsprechenden 
Pfad~-- exemplarisch \Path{cd~"\$HOME/Downloads/\PName{Unterordner}"}~-- 
navigiert werden. Ein beispielhafter Aufruf im Terminal kÃ¶nnte also lauten:
%
\begin{quoting}
\Path{%
  cd~"\$HOME/Downloads/TUD-Script\_fonts\_Unix"{}\,\POParameter{ENTER}
}\newline
\Path{bash tudscr\_fonts\_install.sh\,\POParameter{ENTER}}
\end{quoting}


\subsection{Installationshinweise fÃ¼r portable Installationen}
\tudhyperdef*{sec:install:portable}%
%
Prinzipiell ist die Installation der Type1-Schriften des \CDs bei der Nutzung 
von \Distribution{\hologo{TeX}~Live~Portable}|?| respektive 
\Distribution{\hologo{MiKTeX}~Portable}|?| Ã¤quivalent zur nicht"~portablen 
Variante, welche in \autoref{sec:install:fonts} beschrieben wird. Alle dort 
gegebenen Hinweise sollten sorgfÃ¤ltig berÃ¼cksichtigt werden. Der durch das 
jeweilige Installationsskript voreingestellte Installationspfad sollte fÃ¼r 
gewÃ¶hnlich nicht geÃ¤ndert werden. Geschieht dies dennoch, so sollte dieser sich 
logischerweise auf dem externen Speichermedium   
\Path{\PName{Laufwerksbuchstabe}:\textbackslash} befinden.

\minisec{\hologo{TeX}~Live~Portable}
Das folgende Vorgehen wurde mit Windows getestet. Empfehlungen fÃ¼r die portable 
Installation fÃ¼r unixoide Betriebssysteme kÃ¶nnen an \mailto{\TUDScriptContact} 
gesendet werden.
\begin{enumerate}
\item Installation von \Distribution{\hologo{TeX}~Live~Portable} in 
  \Path{\PName{Laufwerksbuchstabe}:\textbackslash LaTeX\textbackslash texlive}
\item Die Datei \File*{tl-tray-menu.exe} im Installationspfad Ã¶ffnen
\item Das KontextmenÃ¼ von \Distribution{\hologo{TeX}~Live~Portable} mit einem 
  Rechtsklick auf das entsprechende Symbol im Infobereich der Taskleiste    
  Ã¶ffnen und entweder Ã¼ber die grafische OberflÃ¤che (\emph{Package Manager}) 
  oder die Kommandozeile (\emph{Command Prompt}) ein Update durchfÃ¼hren
\item Ãœber das KontextmenÃ¼ die Kommandozeile ausfÃ¼hren und in dieser das Skript 
  fÃ¼r die Installation der Schriften \File{tudscr\_fonts\_install.bat} starten. 
  Dabei gegebenenfalls zuvor in den Pfad des Skriptes wechseln~-- exemplarisch:
  \begin{quoting}[leftmargin=1.5em,rightmargin=0pt]
  \Path{%
    cd~/d~\%USERPROFILE\%\textbackslash{}Downloads%
    \textbackslash{}TUD-Script\_fonts\_Windows\,\POParameter{ENTER}
  }\newline%
  \Path{tudscr\_fonts\_install.bat}\,\POParameter{ENTER}
  \end{quoting}
  Unter UmstÃ¤nden meldet das Skript fehlende Pakete. Dieses mÃ¼ssen Ã¼ber durch 
  den Anwender Ã¼ber den \emph{\hologo{TeX}~Live~Manager} installiert werden.
  \Attention{%
    Ein AusfÃ¼hren ohne die Ã¼ber \Distribution{\hologo{TeX}~Live~Portable} 
    geÃ¶ffnete Kommandozeile fÃ¼hrt zu Fehlern.
  }%
\end{enumerate}

\minisec{\hologo{MiKTeX}~Portable}
\begin{enumerate}
\item Installation von \Distribution{\hologo{MiKTeX}~Portable} in 
  \Path{\PName{Laufwerksbuchstabe}:\textbackslash LaTeX\textbackslash MiKTeX}%
  \footnote{Der Pfad darf \emph{nicht} auf der obersten Verzeichnisebene 
  \Path{\PName{Laufwerksbuchstabe}:\textbackslash} liegen.
  }
\item Die Datei \File{miktex-portable.cmd} im Installationspfad Ã¶ffnen
\item Das KontextmenÃ¼ von \Distribution{\hologo{MiKTeX}~Portable} mit einem 
  Rechtsklick auf das entsprechende Symbol im Infobereich der Taskleiste Ã¶ffnen 
  und ein Update durchfÃ¼hren
\item Ãœber das KontextmenÃ¼ die Kommandozeile ausfÃ¼hren und in dieser das Skript 
  fÃ¼r die Installation der Schriften \File{tudscr\_fonts\_install.bat} starten.
  Dabei gegebenenfalls zuvor in den Pfad des Skriptes wechseln~-- exemplarisch:
  \begin{quoting}[leftmargin=1.5em,rightmargin=0pt]
  \Path{%
    cd~/d~\%USERPROFILE\%\textbackslash{}Downloads%
    \textbackslash{}TUD-Script\_fonts\_Windows\,\POParameter{ENTER}
  }\newline
  \Path{tudscr\_fonts\_install.bat}\,\POParameter{ENTER}
  \end{quoting}
  Bei diesem Schritt werden die Pakete \Package{fontinst}, \Package{cmbright} 
  und \Package{iwona} unter UmstÃ¤nden nachinstalliert.
  \Attention{%
    Ein AusfÃ¼hren ohne die Ã¼ber \Distribution{\hologo{MiKTeX}~Portable} 
    geÃ¶ffnete Kommandozeile fÃ¼hrt zu Fehlern.
  }%
\item Bei der erstmaligen Verwendung von \TUDScript werden alle weiteren 
  benÃ¶tigten Pakete von \Distribution{\hologo{MiKTeX}~Portable} 
  nachinstalliert, falls die automatische Nachinstallation aktiviert ist und 
  diese nicht schon vorhanden sind. Unter anderem betrifft dies die Pakete 
  \Package*{tudscr}, \Package{koma-script} sowie \Package{etoolbox}, 
  \Package{xpatch} \Package{letltxmacro}, \Package{environ}, 
  \Package{trimspaces}, \Package{xcolor} und \Package{mptopdf}&lt;&gt;.  
\end{enumerate}


\subsection{Probleme bei der Installation der Type1-Schriften}
%
Wird Windows verwendet, kann es unter UmstÃ¤nden vorkommen, dass notwendige 
Befehlsaufrufe fÃ¼r das Installationsskript nicht ausgefÃ¼hrt werden kÃ¶nnen. In 
diesem Fall ist der Pfad zu den benÃ¶tigten Dateien, welche normalerweise unter 
\Path{\%SystemRoot\%\textbackslash System32} zu finden sind, nicht in der 
Umgebungsvariable \Path{PATH} enthalten. Einen Hinweis zur ProblemlÃ¶sung ist 
\hrfn{http://latex.wcms-file3.tu-dresden.de/phpBB3/viewtopic.php?t=359}{%
  in diesem Beitrag im Forum%
}
zu finden.

Treten bei der Installation wider Erwarten Probleme auf, so ist zur LÃ¶sung eine 
Logdatei zu erstellen. HierfÃ¼r sollte unter \textbf{Windows} das Skript, 
welches Probleme verursacht, \emph{nicht} aus der Kommandozeile oder dem 
Explorer heraus sondern Ã¼ber \emph{Windows PowerShell} ausgefÃ¼hrt werden. 
HierfÃ¼r ist die Eingabe von \enquote{PowerShell} im StartmenÃ¼ von Windows mit 
einem nachfolgenden Ã–ffnen mittels \POParameter{ENTER}"~Taste ausreichend. 
Danach muss mit \Path{cd} zum Ordner des Skriptes navigiert und dieses mit 
\Path{.\textbackslash\PName{Skript}.bat|Tee-Object -file \PName{Skript}.log} 
ausgefÃ¼hrt werden. Ein Aufruf aus der PowerShell"~Konsole kÃ¶nnte lauten:
%
\begin{quoting}[rightmargin=0pt]
  \Path{%
    cd~"\$env:USERPROFILE\textbackslash{}Downloads\textbackslash{}%
    TUD-Script\_fonts\_Windows"{}\,\POParameter{ENTER}%
  }\newline%
  \Path{%
    .\textbackslash{}tudscr\_fonts\_install.bat%
    |Tee-Object -file fonts\_install.log\,\POParameter{ENTER}%
  }%
\end{quoting}
%
FÃ¼r \textbf{unixartige Systeme} ist der Aufruf 
\Path{bash \PName{Skript}.sh &gt; \PName{Skript}.log} aus dem Terminal heraus zu 
verwenden. Ein exemplarische Verwendung kÃ¶nnte lauten:
%
\begin{quoting}
  \Path{%
    cd~"\$HOME/Downloads/TUD-Script\_fonts\_Unix"{}\,\POParameter{ENTER}%
  }\newline
  \Path{%
    bash tudscr\_fonts\_install.sh &gt; fonts\_install.log\,\POParameter{ENTER}%
  }%
\end{quoting}
%
Die so erstellte Logdatei kann \emph{mit einer kurzen Fehlerbeschreibung} 
entweder im \Forum* gepostet oder per E"~Mail an \mailto{\TUDScriptContact}
gesendet werden.%
\index{Installation!Schriftinstallation|!)}%
</pre></body></html>