diff options
Diffstat (limited to 'macros/latex/contrib/tudscr/source/doc/tudscr-installation.tex')
-rw-r--r-- | macros/latex/contrib/tudscr/source/doc/tudscr-installation.tex | 567 |
1 files changed, 567 insertions, 0 deletions
diff --git a/macros/latex/contrib/tudscr/source/doc/tudscr-installation.tex b/macros/latex/contrib/tudscr/source/doc/tudscr-installation.tex new file mode 100644 index 0000000000..2dd8d79199 --- /dev/null +++ b/macros/latex/contrib/tudscr/source/doc/tudscr-installation.tex @@ -0,0 +1,567 @@ +\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~-- für Windows +\File{tudscr\_\vTUDScript\_install.bat} respektive für unixoide Betriebssysteme +\File{tudscr\_\vTUDScript\_install.sh}~-- 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}<> + 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{\tudscrmail} +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}<>. +\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 > \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 > fonts\_install.log\,\POParameter{ENTER}% + }% +\end{quoting} +% +Die so erstellte Logdatei kann \emph{mit einer kurzen Fehlerbeschreibung} +entweder im \Forum* gepostet oder direkt per E"~Mail an \mailto{\tudscrmail} +gesendet werden. +\index{Installation!Schriftinstallation|!)}% |