diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/tudscr/doc/tudscr-introduction.tex')
-rw-r--r-- | Master/texmf-dist/source/latex/tudscr/doc/tudscr-introduction.tex | 80 |
1 files changed, 60 insertions, 20 deletions
diff --git a/Master/texmf-dist/source/latex/tudscr/doc/tudscr-introduction.tex b/Master/texmf-dist/source/latex/tudscr/doc/tudscr-introduction.tex index f6a77684115..66a4896f5f9 100644 --- a/Master/texmf-dist/source/latex/tudscr/doc/tudscr-introduction.tex +++ b/Master/texmf-dist/source/latex/tudscr/doc/tudscr-introduction.tex @@ -161,9 +161,9 @@ angebotenen Installationspakete (\url{https://tug.org/texlive/} respektive % Die Installation der Schriften des \CDs \emph{muss zwingend} über das Terminal ausgeführt werden. Nach dem Entpacken eines Release-Archivs sollte im passenden -Pfad (beispielsweise \Path{cd \textasciitilde/Downloads/\PName{Unterordner}}) -das Skript aus dem Terminal mit \Path{bash \PName{Skript}.sh} direkt ausgeführt -werden. Mehr dazu in \autoref{sec:install:unix}. +Pfad (beispielsweise \Path{cd~"\$HOME/Downloads/\PName{Unterordner}"}) das +Skript aus dem Terminal mit \Path{bash \PName{Skript}.sh} direkt ausgeführt +werden. Mehr dazu ist in \autoref{sec:install:unix} zu finden. \minisec{Anmerkung zu \NoCaseChange{\hologo{MiKTeX}}} @@ -254,13 +254,13 @@ 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{tudscrfonts\_install.bat} sollte sichergestellt +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{tudscrfonts\_install.bat}}% +\settowidth\tempdim{\File{tudscr\_fonts\_install.zip}~}% \begin{description}[labelwidth=\tempdim,labelsep=1em] - \item[\File{tudscrfonts\_install.bat}]Installationsskript + \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 @@ -286,14 +286,13 @@ Zur Installation der Schriften des \CDs für das \TUDScript-Bundle ist das Archi \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{tudscrfonts\_install.sh} sollte sichergestellt +Verwendung des Skripts \File{tudscr\_fonts\_install.sh} sollte sichergestellt werden, dass sich \emph{alle} der folgenden Dateien im selben Verzeichnis befinden: % -\settowidth\tempdim{\File{tudscrfonts\_install.sh}}% \begin{description}[labelwidth=\tempdim,labelsep=1em] - \item[\File{tudscrfonts\_install.sh}]Installationsskript - (Terminal: \Path{bash tudscrfonts\_install.sh}) + \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 @@ -302,16 +301,31 @@ befinden: % \Attention{% Das Installationsskript \textbf{muss} mit \Path{bash \PName{Skript}.sh} im - Terminal aufgerufen werden. + Terminal im 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-KOMA-Script\_fonts\_Unix"{}\,\POParameter{ENTER} +}\newline +\Path{bash tudscr\_fonts\_install.sh\,\POParameter{ENTER}} +\end{quoting} + -\subsection*{Probleme bei der Installation der PostScript-Schriften} +\subsection{Probleme bei der Installation der PostScript-Schriften} % Wird Windows verwendet, kann es unter Umständen vorkommen, dass notwendige Befehlsaufrufe für das Installationsskript nicht ausgeführt werden können. In @@ -323,14 +337,40 @@ Umgebungsvariable \Path{PATH} enthalten. Einen Hinweis zur Problemlösung ist } zu finden. -Treten bei der Installation wider Erwarten Probleme auf, so sollte eine -Logdatei erstellt werden. Unter Windows muss das Skript, welches Probleme -verursacht, aus der Kommandozeile mit -\Path{\PName{Skript}.bat > \PName{Skript}.log} aufgerufen werden, wobei das -doppelte Betätigen der Eingabetaste nötig ist. Für unixartige Systeme -ist der Aufruf \Path{bash \PName{Skript}.sh > \PName{Skript}.log} aus dem -Terminal heraus zu verwenden. Die erstellte Logdatei kann mit einer kurzen -Fehlerbeschreibung direkt an \Email{\tudscrmail} gesendet werden. +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-KOMA-Script\_fonts\_Windows"{}\,\POParameter{ENTER}% + }\newline% + \Path{% + .\textbackslash{}tudscr\_fonts\_install.bat% + |Tee-Object\,-file\,tudscr\_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 exemplarischer +Aufruf im könnte lauten: +% +\begin{quoting} +\Path{% + cd~"\$HOME/Downloads/TUD-KOMA-Script\_fonts\_Unix"{}\,\POParameter{ENTER} +}\newline +\Path{bash tudscr\_fonts\_install.sh\,\POParameter{ENTER}} +\end{quoting} +% +Die erstellte Logdatei sollte \emph{mit einer kurzen Fehlerbeschreibung} direkt +an \Email{\tudscrmail} gesendet werden. \index{Installation|!)}% |