Debian Codegraph @

texmf-dist/source/latex/tudscr/doc/tudscr-installation.tex

raw
1 \setchapterpreamble{\tudhyperdef'{sec:install:ext}}
2 \chapter{Weiterführende Installationshinweise}
3 %
4 \noindent\Attention{%
5 Hier werden unterschiedliche Varianten erläutert, wie \TUDScript in der
6 Version~\vTUDScript{} genutzt werden kann, falls eine frühere Variante als
7 \textbf{lokale Nutzerinstallation} verwendet wurde.
8 }
9
10 \bigskip\noindent
11 Bis zur Version~v2.01 wurde \TUDScript ausschließlich über das \Forum zur
12 lokalen Nutzerinstallation angeboten. In erster Linie hat das historische
13 Hintergründe und hängt mit der Entstehungsgeschichte von \TUDScript zusammen.
14 Eine lokale Nutzerinstallation bietet einen~-- eher zu vernachlässigenden~--
15 Vorteil. Treten bei der Verwendung von \TUDScript Probleme auf, können diese im
16 Forum gemeldet und diskutiert werden. Ist für ein solches Problem tatsächlich
17 eine Fehlerkorrektur respektive Aktualisierung von \TUDScript nötig, kann diese
18 schnell und unkompliziert über das \GitHubRepo bereitgestellt und durch den
19 Anwender sofort genutzt werden.
20
21 Dies hat allerdings für alle Anwender, welche das Forum relativ wenig oder gar
22 nicht besuchen, den großen Nachteil, dass Sie nicht von Aktualisierungen,
23 Verbesserungen und Fehlerkorrekturen neuer Versionen profitieren können. Auch
24 alle nachfolgenden Bugfixes und Aktualisierungen des \TUDScript-Bundles müssen
25 durch den Anwender manuell durchgeführt werden. Daher wird die Verbreitung via
26 \CTAN[pkg/tudscr] präferiert, sodass \TUDScript stets in der gerade aktuellen
27 Version verfügbar ist~-- eine durch den Anwender aktuell gehaltene
28 \hologo{LaTeX}"=Distribution vorausgesetzt. Der einzige Nachteil bei diesem
29 Ansatz ist, dass die Verbreitung eines Bugfixes und die anschließende
30 Bereitstellung durch die verwendete Distribution für gewöhnlich bis zu zwei
31 Tagen dauert.
32
33 Die gängigen \hologo{LaTeX}"=Distributionen durchsuchen im Regelfall zuerst das
34 lokale \Path{texmf}"=Nutzerverzeichnis nach Klassen und Paketen und erst daran
35 anschließend den \Path{texmf}"=Pfad der Distribution selbst. Dabei spielt es
36 keine Rolle, in welchem Pfad die neuere Version einer Klasse oder eines Paketes
37 liegt. Sobald im Nutzerverzeichnis die gesuchte Datei gefunden wurde, wird die
38 Suche beendet.
39 \Attention{%
40 In der Konsequenz bedeutet dies, dass sämtliche Aktualisierungen über CTAN
41 nicht zum Tragen kommen, falls \TUDScript als lokale Nutzerversion
42 installiert wurde.
43 }
44
45 Deshalb wird Anwendern empfohlen, eine gegebenenfalls vorhandene lokale
46 Nutzerinstallation von \TUDScript zu deinstallieren, falls diese nicht
47 \emph{bewusst} installiert wurde. Die Deinstallation wird in
48 \autoref{sec:local:uninstall} erläutert. Nach dieser können Updates des
49 \TUDScript-Bundles durch die Aktualisierungsfunktion der Distribution erfolgen.
50
51 Wie das \TUDScript-Bundle trotzdem als lokale Nutzerversion installiert oder
52 aktualisiert werden kann, ist in \autoref{sec:local:install} beziehungsweise
53 \autoref{sec:local:update} zu finden. Der Anwender sollte in diesem Fall
54 allerdings genau wissen, was er damit bezweckt, da er in diesem Fall für die
55 Aktualisierung von \TUDScript selbst verantwortlich ist.
56
57 \minisec{Nutzung der veralteten Schriftfamilien}
58 \ChangedAt{v2.06}%
59 %
60 Soll ein Dokument noch mit den veralteten Schriftfamilien \Univers und \DIN
61 gesetzt werden, so ist eine lokale Installation der Type1-Schriften notwendig,
62 welche in \autoref{sec:install:fonts} beschrieben wird. Zusätzlich sei auf die
63 beiden Optionen \Option*{tudscrver=2.05} und \Option*{cdoldfont} hingewiesen.
64 Für die Nutzung der \OpenSans wird lediglich die aktuelle Version des Paketes
65 \Package{opensans} benötigt, welches auf \CTAN[pkg/opensans] zu finden ist.
66
67
68 \section{Lokale Deinstallation des \TUDScript-Bundles}
69 \tudhyperdef*{sec:local:uninstall}%
70 \index{Deinstallation}%
71 %
72 Über die Kommandozeile beziehungsweise das Terminal kann mit
73 %
74 \begin{quoting}
75 \Path{kpsewhich --all tudscrbase.sty}
76 \end{quoting}
77 %
78 überprüft werden, ob eine lokale Nutzerinstallation von \TUDScript vorhanden
79 ist. Es werden alle Pfade ausgegeben, in denen die Datei \File*{tudscrbase.sty}
80 gefunden wird. Erscheint nur der Distributionspfad, ist die \TUDScript-Version
81 von CTAN aktiv und der Anwender kann mit dem \TUDScript-Bundle arbeiten.
82
83 Wird \emph{nur} das lokale Nutzerverzeichnis oder gar kein Verzeichnis
84 gefunden, so wird höchstwahrscheinlich eine veraltete Distribution
85 verwendet. In diesem Fall wird eine Aktualisierung dieser \emph{unbedingt}
86 empfohlen. Sollte dies nicht möglich sein, \emph{muss} \TUDScript als lokale
87 Nutzerversion installiert (\autoref{sec:local:install}) beziehungsweise~--
88 falls ein Pfad ausgegeben wurde~-- aktualisiert (\autoref{sec:local:update})
89 werden.
90
91 Sollte neben dem Pfad der Distribution noch mindestens ein weiterer Pfad
92 angezeigt werden, so ist eine lokale Nutzerversion installiert. In
93 diesem Fall hat der Anwender drei Möglichkeiten:
94 %
95 \begin{enumerate}
96 \item Entfernen der lokalen Nutzerinstallation (skriptbasiert)
97 \item Entfernen der lokalen Nutzerinstallation (manuell)
98 \item Aktualisierung der lokalen Nutzerversion (\autoref{sec:local:update})
99 \end{enumerate}
100 %
101 Um die lokale Nutzerinstallation zu entfernen, kann für Windows
102 \hrfn{\Download{uninstall/tudscr\_uninstall.bat}}{\File{tudscr\_uninstall.bat}}
103 sowie für unixartige Betriebssysteme
104 \hrfn{\Download{uninstall/tudscr\_uninstall.sh}}{\File{tudscr\_uninstall.sh}}
105 verwendet werden. Nach der Ausführung des jeweiligen Skriptes kann mit dem zu
106 Beginn gezeigten Aufruf in der Kommandozeile respektive Terminal geprüft
107 werden, ob die Deinstallation erfolgreich war. Wird immer noch mindestens ein
108 lokaler Pfad ausgegeben, sollte \TUDScript manuelle deinstalliert werden, was
109 nachfolgend beschrieben wird.
110
111 Nur die Deinstallation aller lokalen Nutzerinstallationen von \TUDScript
112 ermöglicht die Verwendung der jeweils aktuellen CTAN"=Version. Hierfür ist~--
113 unter der Annahme, dass das automatisierte Deinstallieren mithilfe der zuvor
114 genannten Skripte zur Deinstallation nicht erfolgreich war~-- etwas Handarbeit
115 durch den Anwender vonnöten. Der in der Kommandozeile respektive im Terminal mit
116 %
117 \begin{quoting}
118 \Path{kpsewhich --all tudscrbase.sty}
119 \end{quoting}
120 %
121 gefundene~-- zum Ordner der Distribution \emph{zusätzliche}~-- Pfad hat die
122 folgende Struktur:
123 %
124 \begin{quoting}
125 \Path{\PName{Installationspfad}/tex/latex/tudscr/tudscrbase.sty}
126 \end{quoting}
127 %
128 Um die Nutzerinstallation vollständig zu entfernen, muss als erstes zu
129 \Path{\PName{Installationspfad}} navigiert werden. Anschließend ist in diesem
130 Pfad Folgendes durchzuführen:
131 %
132 \settowidth\tempdim{\Path{tex/latex/tudscr/}}%
133 \begin{description}[labelwidth=\tempdim,labelsep=1em]
134 \item[\Path{tex/latex/tudscr/}]\File*{.cls}- und \File*{.sty}"~Dateien löschen
135 \item[\Path{tex/latex/tudscr/}]Ordner \Path{logo} vollständig löschen
136 \item[\Path{doc/latex/}] Ordner \Path{tudscr} vollständig löschen
137 \item[\Path{source/latex/}] Ordner \Path{tudscr} vollständig löschen
138 \end{description}
139 %
140 Zum Abschluss ist in der Kommandozeile beziehungsweise im Terminal der Befehl
141 \Path{texhash} aufzurufen. Damit wurde die lokale Nutzerversion entfernt und es
142 wird von nun an die Version von \TUDScript genutzt, welche durch die verwendete
143 Distribution bereitgestellt wird.
144
145
146
147 \section{Lokale Installation des \TUDScript-Bundles}
148 \tudhyperdef*{sec:local:install}%
149 \index{Installation!Nutzerinstallation|(}%
150 %
151 Eine lokale Nutzerinstallation von \TUDScript sollte ausschließlich durch
152 Anwender ausgeführt werden, die genau wissen, aus welchen Gründen dies
153 geschehen soll. Hierfür werden die passenden Skripte angeboten. Für eine lokale
154 Nutzerinstallation des \TUDScript-Bundles unter Windows für die Distributionen
155 \Distribution{\hologo{TeX}~Live} oder \Distribution{\hologo{MiKTeX}} werden die
156 Dateien aus
157 \hrfn{\Download{\vTUDScript/TUD-Script\_\vTUDScript\_Windows.zip}}%
158 {\File*{TUD-Script\_\vTUDScript\_Windows.zip}}
159 benötigt. Für unixoide Betriebssysteme sind es die Dateien aus
160 \hrfn{\Download{\vTUDScript/TUD-Script\_\vTUDScript\_Unix.zip}}%
161 {\File*{TUD-Script\_\vTUDScript\_Unix.zip}}.
162
163 Beim Ausführen des spezifischen Installationsskripts~--
164 \File{tudscr\_\vTUDScript\_install.bat} für Windows respektive
165 \File{tudscr\_\vTUDScript\_install.sh} für unixoide Betriebssysteme~-- werden
166 alle Dateien in das lokale Nutzerverzeichnis der jeweiligen Distribution
167 installiert, falls kein anderes Verzeichnis explizit angegeben wird.
168 \Attention{%
169 In jedem Fall sollte vor der Ausführung des Installationsskripts ein Update
170 der \hologo{LaTeX}"=Distribution durchgeführt werden. Dies gilt insbesondere
171 bei der Nutzung von \Distribution{\hologo{MiKTeX}}. Andernfalls wird es unter
172 Umständen im Installationsprozess oder bei der Nutzung von \TUDScript zu
173 Problemen kommen.
174 }
175
176 Alternativ zur Nutzung der bereitgestellte Skripte kann auch einfach der Inhalt
177 des Archivs
178 \hrfn{\Download{\vTUDScript/tudscr\_\vTUDScript.zip}}%
179 {\File{tudscr\_\vTUDScript.zip}}
180 in das lokale \Path{texmf}"=Nutzerverzeichnis kopiert und abschließend in der
181 Kommandozeile respektive im Terminal \Path{texhash} aufgerufen werden.
182
183
184
185 \section{Lokales Update des \TUDScript-Bundles}
186 \tudhyperdef*{sec:local:update}%
187 \index{Update|!}%
188 %
189 \subsection{Update des \TUDScript-Bundles ab Version~v2.02}
190 Ein Update und die lokale Installation unterscheiden sich ab der Version~v2.06
191 nicht voneinander, das Vorgehen ist absolut identisch zu der Beschreibung in
192 \autoref{sec:local:install}.
193 \Attention{%
194 Die lokale Aktualisierung auf Version~\vTUDScript{} funktioniert allerdings
195 nur, wenn \TUDScript bereits mindestens in der Version~v2.02 entweder als
196 lokale Nutzerversion oder über die Distribution installiert ist.%
197 }
198
199 \subsection{Update des \TUDScript-Bundles ab Version~v2.00}
200 %
201 Mit der Version~v2.02 gab es einige tiefgreifende Änderungen. Deshalb wird für
202 vorausgehende Versionen~-- sprich v2.00 und v2.01~-- kein dediziertes Update
203 angeboten. Die Aktualisierung kann durch den Anwender entweder~-- wie in
204 \autoref{sec:local:install} erläutert~-- mit einer skriptbasierten oder mit
205 einer manuellen Neuinstallation erfolgen.
206 \index{Installation!Nutzerinstallation|)}%
207
208
209 \subsection{Update des \TUDScript-Bundles von Version v1.0}
210 %
211 Ist \TUDScript in der veralteten \emph{Version~v1.0} installiert, so wird vor
212 der Aktualisierung dringlichst zu einem vollständigen Entfernen dieser Version
213 geraten. Andernfalls werden nach einem Update bei der Verwendung massive
214 Probleme und Fehler auftreten. Zur Deinstallation werden die Skripte
215 \hrfn{\Download{uninstall/tudscr_uninstall.bat}}{\File{tudscr\_uninstall.bat}}
216 respektive
217 \hrfn{\Download{uninstall/tudscr_uninstall.sh}}{\File{tudscr\_uninstall.sh}}
218 bereitgestellt. Die aktuelle Version~\vTUDScript{} kann nach der vollständigen
219 Deinstallation aller veralteten Versionen wie in \autoref{sec:install:fonts}
220 beschrieben installiert werden.
221
222 Im Vergleich zur \emph{Version~v1.0} hat sich an der Benutzerschnittstelle
223 nicht sehr viel verändert, ein Umstieg auf die Version~\vTUDScript{} dürfte
224 keine Schwierigkeiten bereiten. Treten danach dennoch Probleme auf, sollte der
225 Anwender als erstes die Beschreibung des Paketes \Package{tudscrcomp}'full'
226 lesen, welches eine Schnittstelle zur Nutzung alter und ursprünglich nicht mehr
227 vorgesehener Befehle sowie Optionen bereitstellt. Allerdings werden einige von
228 diesen auch durch das Paket \Package{tudscrcomp} nicht mehr bereitgestellt.
229 Aufgeführt sind diese in \autoref{sec:obsolete}. Sollten trotz aller Hinweise
230 dennoch Fehler oder Probleme beim Umstieg auf die neue \TUDScript-Version
231 auftreten, ist eine Meldung im \Forum oder im \GitHubRepo[issues] die beste
232 Möglichkeit, um Hilfe zu erhalten.
233
234
235
236 \section{Installation veralteter Schriftfamilien}
237 \tudhyperdef*{sec:install:fonts}%
238 \index{Installation!Schriftinstallation|!(}%
239
240 Bis Anfang des Jahres~2018 nutzte das \TUDCD als Hausschrift nicht \OpenSans
241 sondern die Schriftfamilien \Univers und \DIN. Diese lassen sich auch weiterhin
242 mit \TUDScript verwenden, um alte Dokumente kompilieren zu können. Hierfür sei
243 auf die Optionen \Option*{tudscrverv=2.05} und \Option*{cdoldfont} hingewiesen.
244 Da es sich bei diesen um lizenzierte Schriften handelt, müssen diese beim
245 Universitätsmarketing auf \hrfn{https://tu-dresden.de/cd/}{Anfrage} mit dem
246 Hinweis auf die Verwendung von \hologo{LaTeX} bestellt und nach Erhalt der
247 notwendigen Archive \File{Univers\_PS.zip} und \File{DIN\_Bd\_PS.zip} für
248 Windows (\autoref{sec:install:win}) beziehungsweise unixoide Betriebssysteme
249 (\autoref{sec:install:unix}) installiert werden. Ohne einen triftigen Grund
250 sollte jedoch in jedem Fall die \OpenSans genutzt werden, insbesondere für neu
251 erstellte Dokumente.
252
253 Das \TUDScript-Bundle unterstützt besagte Schriften auch im OpenType-Format,
254 welche ebenfalls über das Universitätsmarketing auf
255 \href{https://tu-dresden.de/cd/}{Anfrage} bestellt werden müssen. Die in den
256 Archiven \File{Univers\_8\_TTF\/.zip} und \File{DIN\_TTF\/.zip} enthaltenen
257 Schriften lassen sich~-- sobald diese für das Betriebssystem installiert
258 wurden~-- mit dem Paket \Package{fontspec} verwenden. In \fullref{sec:fonts}
259 sind weitere Hinweise zur Verwendung des Paketes \Package{fontspec} zu finden.
260
261 Im \GitHubRepo* sind die zur Schriftinstallation benötigten
262 \hrfn{https://github.com/tud-cd/tudscr/releases/tag/fonts}{Skripte}
263 ebenso zu finden wie die
264 \hrfn{https://github.com/tud-cd/tudscr/releases/tag/oldfonts}{Skripte}
265 für die Klassen von Klaus Bergmann. Die unterschiedlichen Installationsskripte
266 begründen sich insbesondere dadurch, dass bei der Installation für das
267 \TUDScript-Bundle sowohl die Metriken als auch das Kerning der Schriften für
268 Fließtext und den Mathematikmodus angepasst werden. Sollen die so verbesserten
269 Schriften für die Klassen von Klaus Bergmann verwendet werden, kann dies mit
270 dem Paket \Package{fix-tudscrfonts} erfolgen, was allerdings das Ergebnis der
271 erzeugten Ausgabe beeinflusst, weshalb die Installationsskripte in
272 unterschiedlichen Varianten weiterhin vorgehalten werden.
273
274 \minisec{Erforderliche Pakete bei der Schriftinstallation}
275 Für die Installation der Schriften sind die Pakete \Package*{fontinst},
276 \Package*{cmbright}, \Package*{hfbright}, \Package*{cm-super} und
277 \Package*{iwona} von \emph{essentieller} Bedeutung und daher \emph{zwingend}
278 notwendig. Das Vorhandensein dieser wird durch die jeweiligen
279 Schriftinstallationsskripte geprüft und die Installation beim Fehlen eines oder
280 mehrerer Pakete mit einer entsprechenden Warnung abgebrochen.
281
282 \minisec{Anmerkung zu \hologo{MiKTeX}}
283 Vor der Installation der Schriften für \TUDScript sollte unbedingt ein Update
284 von \Distribution{\hologo{MiKTeX}}|?| durchgeführt werden. Außerdem ist es sehr
285 ratsam, die Installation von \Distribution{\hologo{MiKTeX}}|?| in der
286 Mehrbenutzervariante mit Administratorrechten durchzuführen, da die
287 Einzelbenutzervariante relativ unregelmäßig und nicht immer nachvollziehbar zu
288 Problemen führen kann.
289
290 Möglicherweise sind einige der für den Schriftinstallationsprozess notwendigen
291 Pakete noch nicht installiert. Ist die automatische Nachinstallation fehlender
292 Pakete aktiviert, so reicht es im Normalfall das Installationsskript zu
293 starten. Andernfalls müssen diese Pakete manuell durch den Benutzer über den
294 \Distribution{\hologo{MiKTeX}}"=Paketmanager hinzugefügt werden.
295
296 Das Installationsskript scheitert außerdem bei einigen Anwendern~-- aufgrund
297 eingeschränkter Nutzerzugriffsrechte~-- beim Eintragen der Schriften in die
298 Map"~Datei. Dies muss gegebenenfalls durch den Anwender über die Kommandozeile
299 %
300 \begin{quoting}
301 \Path{initexmf -{}-edit-config-file updmap}
302 \end{quoting}
303 %
304 erfolgen. In der sich öffnenden Datei sollte sich der Eintrag
305 \Path{Map~tudscr.map} befinden. Ist dies nicht der Fall, muss diese Zeile
306 manuell eingetragen und die Datei anschließend gespeichert werden. Danach muss
307 der Nutzer in der Kommandozeile noch folgenden Aufruf ausführen:
308 %
309 \begin{quoting}
310 \Path{initexmf~-{}-mkmaps}
311 \end{quoting}
312
313
314 \minisec{Anmerkung zu \hologo{TeX}~Live und Mac\hologo{TeX}}
315 Sollte keine Vollinstallation von \Distribution{\hologo{TeX}~Live} durchgeführt
316 worden sein, müssen die erforderlichen Pakete zur Schriftinstallation manuell
317 über den \Distribution{\hologo{TeX}~Live}"=Paketmanager hinzugefügt werden.
318
319 Sind nach einem fehlerfreien Durchlauf des Installationsskriptes die Schriften
320 dennoch nicht verfügbar, so muss die Synchronisierung aller Schriftdateien
321 angestoßen werden. Daran anschließend müssen die Map"~Datei und die
322 dazugehörigen Schriftdateien registriert werden. Die hierfür notwendigen
323 Aufrufe lauten:
324 %
325 \begin{quoting}
326 \Path{updmap-sys -{}-syncwithtrees}\newline
327 \Path{updmap-sys -{}-enable Map=tudscr.map}\newline
328 \Path{updmap-sys -{}-force}
329 \end{quoting}
330 %
331 Sind die Schriften danach immer noch nicht verfügbar, so wurden bestimmt schon
332 weitere Schriften auf dem System \emph{lokal} installiert. In diesem Fall
333 sollte der Vorgang nochmals für eine lokale Schriftinstallation mit
334 %
335 \begin{quoting}
336 \Path{updmap -{}-syncwithtrees}\newline
337 \Path{updmap -{}-enable Map=tudscr.map}\newline
338 \Path{updmap -{}-force}
339 \end{quoting}
340 %
341 ausgeführt werden. Dieses Vorgehen macht allerdings den Befehl
342 \Path{updmap-sys} von nun an wirkungslos. Nach einer systemweiten Installation
343 neuer Schriften~-- beispielsweise bei der Aktualisierung der Distribution~--
344 müssen diese über den manuellen Aufruf von \Path{updmap} zukünftig durch den
345 Anwender lokal bei \Distribution{\hologo{TeX}~Live}|?| respektive
346 \Distribution{Mac\hologo{TeX}}|?| registriert werden.
347
348 \Attention{%
349 Für die Schriftinstallation werden die Skripte \Path{tftopl}, \Path{pltotf}
350 und \Path{vptovf} benötigt, welche bei \Distribution{\hologo{TeX}~Live}|?|
351 beziehungsweise \Distribution{Mac\hologo{TeX}}|?| über das Paket
352 \Package*{fontware} aus \Package*{collection-fontutils}<>
353 bereitgestellt werden und zwingend installiert sein müssen.
354 }
355
356
357 \subsection{Installation der Type1-Schriften unter Windows}
358 \tudhyperdef*{sec:install:win}%
359 %
360 Zur Installation der Schriften des \CDs für das \TUDScript-Bundle ist das Archiv
361 \hrfn{\Download{fonts/TUD-Script_fonts_Windows.zip}}%
362 {\File*{TUD-Script\_fonts\_Windows.zip}}
363 vorgesehen. Dieses ist sowohl für \Distribution{\hologo{TeX}~Live}|?| als auch
364 \Distribution{\hologo{MiKTeX}}|?| nutzbar und enthält~-- bis auf die jeweiligen
365 Schriftarchive selbst~-- alle benötigten Dateien. Diese sollten nach dem
366 Entpacken des Archivs in das gleiche Verzeichnis kopiert werden. Vor der
367 Verwendung des Skripts \File{tudscr\_fonts\_install.bat} sollte sichergestellt
368 werden, dass sich \emph{alle} der folgenden Dateien im selben Verzeichnis
369 befinden:
370 %
371 \settowidth\tempdim{\File{tudscr\_fonts\_install.zip}~}%
372 \begin{description}[labelwidth=\tempdim,labelsep=1em]
373 \item[\File{tudscr\_fonts\_install.bat}]Installationsskript
374 \item[\File{Univers\_PS.zip}]Archiv mit Schriftdateien für \Univers
375 \item[\File{DIN\_Bd\_PS.zip}]Archiv mit Schriftdateien für \DIN
376 \item[\File{tudscr\_fonts\_install.zip}]Archiv mit Metriken für die
377 Schriftinstallation via \Package{fontinst}
378 \end{description}
379 %
380 Beim Ausführen des Installationsskripts werden alle Schriften standardmäßig in
381 ein lokales Nutzerverzeichnis installiert. Wird das Skript über das Kontextmenü
382 mit Administratorrechten ausgeführt, erfolgt die Installation in einem Pfad,
383 der \emph{für alle Nutzer} gültig und lesbar ist.
384
385
386
387 \subsection{Installation der Type1-Schriften unter Linux und OS~X}
388 \tudhyperdef*{sec:install:unix}%
389 %
390 Zur Installation der Schriften des \CDs für das \TUDScript-Bundle ist das Archiv
391 \hrfn{\Download{fonts/TUD-Script_fonts_Unix.zip}}%
392 {\File*{TUD-Script\_fonts\_Unix.zip}}
393 vorgesehen. Dieses ist sowohl für \Distribution{\hologo{TeX}~Live}|?| als auch
394 \Distribution{Mac\hologo{TeX}}|?| nutzbar und enthält~-- bis auf die jeweiligen
395 Schriftdateien selbst~-- alle benötigten Dateien. Diese sollten nach dem
396 Entpacken des Archivs in das gleiche Verzeichnis kopiert werden. Vor der
397 Verwendung des Skripts \File{tudscr\_fonts\_install.sh} sollte sichergestellt
398 werden, dass sich \emph{alle} der folgenden Dateien im selben Verzeichnis
399 befinden:
400 %
401 \begin{description}[labelwidth=\tempdim,labelsep=1em]
402 \item[\File{tudscr\_fonts\_install.sh}]Installationsskript
403 (Terminal: \Path{bash tudscr\_fonts\_install.sh})
404 \item[\File{Univers\_PS.zip}]Archiv mit Schriftdateien für \Univers
405 \item[\File{DIN\_Bd\_PS.zip}]Archiv mit Schriftdateien für \DIN
406 \item[\File{tudscr\_fonts\_install.zip}]Archiv mit Metriken für die
407 Schriftinstallation via \Package{fontinst}
408 \end{description}
409 %
410 \minisec{Anmerkung zu Linux und OS~X}
411 \Attention{%
412 Nach dem Entpacken eines Release-Archivs im passenden Pfad\footnote{%
413 beispielsweise \Path{cd~"\$HOME/Downloads/\PName{Unterordner}"}%
414 } \textbf{muss das Skript zwingend} mit \Path{bash~\PName{Skript}.sh} im
415 Terminal in diesem Pfad mit den benötigten Dateien aufgerufen werden.
416 }
417 Dabei werden alle Schriften standardmäßig in das lokale Nutzerverzeichnis
418 (\Path{\$TEXMFHOME}) installiert. Wird das Skript mit \Path{sudo} verwendet,
419 erfolgt die Installation \emph{für alle Nutzer} in den lokalen Systempfad
420 (\Path{\$TEXMFLOCAL}).
421
422 Es ist unbedingt darauf zu Achten, das beim Ausführen des Skriptes das Terminal
423 im richtigen Verzeichnis aktiv ist. Bei den meisten unixoiden Betriebssystemen
424 ist es problemlos möglich, das Terminal aus der Benutzeroberfläche heraus über
425 das Kontextmenü im gewünschten Pfad zu öffnen. Geht dies nicht, so muss nach
426 dem Öffnen des Terminals mit dem Befehl \Path{cd} erst zum entsprechenden
427 Pfad~-- exemplarisch \Path{cd~"\$HOME/Downloads/\PName{Unterordner}"}~--
428 navigiert werden. Ein beispielhafter Aufruf im Terminal könnte also lauten:
429 %
430 \begin{quoting}
431 \Path{%
432 cd~"\$HOME/Downloads/TUD-Script\_fonts\_Unix"{}\,\POParameter{ENTER}
433 }\newline
434 \Path{bash tudscr\_fonts\_install.sh\,\POParameter{ENTER}}
435 \end{quoting}
436
437
438 \subsection{Installationshinweise für portable Installationen}
439 \tudhyperdef*{sec:install:portable}%
440 %
441 Prinzipiell ist die Installation der Type1-Schriften des \CDs bei der Nutzung
442 von \Distribution{\hologo{TeX}~Live~Portable}|?| respektive
443 \Distribution{\hologo{MiKTeX}~Portable}|?| äquivalent zur nicht"~portablen
444 Variante, welche in \autoref{sec:install:fonts} beschrieben wird. Alle dort
445 gegebenen Hinweise sollten sorgfältig berücksichtigt werden. Der durch das
446 jeweilige Installationsskript voreingestellte Installationspfad sollte für
447 gewöhnlich nicht geändert werden. Geschieht dies dennoch, so sollte dieser sich
448 logischerweise auf dem externen Speichermedium
449 \Path{\PName{Laufwerksbuchstabe}:\textbackslash} befinden.
450
451 \minisec{\hologo{TeX}~Live~Portable}
452 Das folgende Vorgehen wurde mit Windows getestet. Empfehlungen für die portable
453 Installation für unixoide Betriebssysteme können an \mailto{\TUDScriptContact}
454 gesendet werden.
455 \begin{enumerate}
456 \item Installation von \Distribution{\hologo{TeX}~Live~Portable} in
457 \Path{\PName{Laufwerksbuchstabe}:\textbackslash LaTeX\textbackslash texlive}
458 \item Die Datei \File*{tl-tray-menu.exe} im Installationspfad öffnen
459 \item Das Kontextmenü von \Distribution{\hologo{TeX}~Live~Portable} mit einem
460 Rechtsklick auf das entsprechende Symbol im Infobereich der Taskleiste
461 öffnen und entweder über die grafische Oberfläche (\emph{Package Manager})
462 oder die Kommandozeile (\emph{Command Prompt}) ein Update durchführen
463 \item Über das Kontextmenü die Kommandozeile ausführen und in dieser das Skript
464 für die Installation der Schriften \File{tudscr\_fonts\_install.bat} starten.
465 Dabei gegebenenfalls zuvor in den Pfad des Skriptes wechseln~-- exemplarisch:
466 \begin{quoting}[leftmargin=1.5em,rightmargin=0pt]
467 \Path{%
468 cd~/d~\%USERPROFILE\%\textbackslash{}Downloads%
469 \textbackslash{}TUD-Script\_fonts\_Windows\,\POParameter{ENTER}
470 }\newline%
471 \Path{tudscr\_fonts\_install.bat}\,\POParameter{ENTER}
472 \end{quoting}
473 Unter Umständen meldet das Skript fehlende Pakete. Dieses müssen über durch
474 den Anwender über den \emph{\hologo{TeX}~Live~Manager} installiert werden.
475 \Attention{%
476 Ein Ausführen ohne die über \Distribution{\hologo{TeX}~Live~Portable}
477 geöffnete Kommandozeile führt zu Fehlern.
478 }%
479 \end{enumerate}
480
481 \minisec{\hologo{MiKTeX}~Portable}
482 \begin{enumerate}
483 \item Installation von \Distribution{\hologo{MiKTeX}~Portable} in
484 \Path{\PName{Laufwerksbuchstabe}:\textbackslash LaTeX\textbackslash MiKTeX}%
485 \footnote{Der Pfad darf \emph{nicht} auf der obersten Verzeichnisebene
486 \Path{\PName{Laufwerksbuchstabe}:\textbackslash} liegen.
487 }
488 \item Die Datei \File{miktex-portable.cmd} im Installationspfad öffnen
489 \item Das Kontextmenü von \Distribution{\hologo{MiKTeX}~Portable} mit einem
490 Rechtsklick auf das entsprechende Symbol im Infobereich der Taskleiste öffnen
491 und ein Update durchführen
492 \item Über das Kontextmenü die Kommandozeile ausführen und in dieser das Skript
493 für die Installation der Schriften \File{tudscr\_fonts\_install.bat} starten.
494 Dabei gegebenenfalls zuvor in den Pfad des Skriptes wechseln~-- exemplarisch:
495 \begin{quoting}[leftmargin=1.5em,rightmargin=0pt]
496 \Path{%
497 cd~/d~\%USERPROFILE\%\textbackslash{}Downloads%
498 \textbackslash{}TUD-Script\_fonts\_Windows\,\POParameter{ENTER}
499 }\newline
500 \Path{tudscr\_fonts\_install.bat}\,\POParameter{ENTER}
501 \end{quoting}
502 Bei diesem Schritt werden die Pakete \Package{fontinst}, \Package{cmbright}
503 und \Package{iwona} unter Umständen nachinstalliert.
504 \Attention{%
505 Ein Ausführen ohne die über \Distribution{\hologo{MiKTeX}~Portable}
506 geöffnete Kommandozeile führt zu Fehlern.
507 }%
508 \item Bei der erstmaligen Verwendung von \TUDScript werden alle weiteren
509 benötigten Pakete von \Distribution{\hologo{MiKTeX}~Portable}
510 nachinstalliert, falls die automatische Nachinstallation aktiviert ist und
511 diese nicht schon vorhanden sind. Unter anderem betrifft dies die Pakete
512 \Package*{tudscr}, \Package{koma-script} sowie \Package{etoolbox},
513 \Package{xpatch} \Package{letltxmacro}, \Package{environ},
514 \Package{trimspaces}, \Package{xcolor} und \Package{mptopdf}<>.
515 \end{enumerate}
516
517
518 \subsection{Probleme bei der Installation der Type1-Schriften}
519 %
520 Wird Windows verwendet, kann es unter Umständen vorkommen, dass notwendige
521 Befehlsaufrufe für das Installationsskript nicht ausgeführt werden können. In
522 diesem Fall ist der Pfad zu den benötigten Dateien, welche normalerweise unter
523 \Path{\%SystemRoot\%\textbackslash System32} zu finden sind, nicht in der
524 Umgebungsvariable \Path{PATH} enthalten. Einen Hinweis zur Problemlösung ist
525 \hrfn{http://latex.wcms-file3.tu-dresden.de/phpBB3/viewtopic.php?t=359}{%
526 in diesem Beitrag im Forum%
527 }
528 zu finden.
529
530 Treten bei der Installation wider Erwarten Probleme auf, so ist zur Lösung eine
531 Logdatei zu erstellen. Hierfür sollte unter \textbf{Windows} das Skript,
532 welches Probleme verursacht, \emph{nicht} aus der Kommandozeile oder dem
533 Explorer heraus sondern über \emph{Windows PowerShell} ausgeführt werden.
534 Hierfür ist die Eingabe von \enquote{PowerShell} im Startmenü von Windows mit
535 einem nachfolgenden Öffnen mittels \POParameter{ENTER}"~Taste ausreichend.
536 Danach muss mit \Path{cd} zum Ordner des Skriptes navigiert und dieses mit
537 \Path{.\textbackslash\PName{Skript}.bat|Tee-Object -file \PName{Skript}.log}
538 ausgeführt werden. Ein Aufruf aus der PowerShell"~Konsole könnte lauten:
539 %
540 \begin{quoting}[rightmargin=0pt]
541 \Path{%
542 cd~"\$env:USERPROFILE\textbackslash{}Downloads\textbackslash{}%
543 TUD-Script\_fonts\_Windows"{}\,\POParameter{ENTER}%
544 }\newline%
545 \Path{%
546 .\textbackslash{}tudscr\_fonts\_install.bat%
547 |Tee-Object -file fonts\_install.log\,\POParameter{ENTER}%
548 }%
549 \end{quoting}
550 %
551 Für \textbf{unixartige Systeme} ist der Aufruf
552 \Path{bash \PName{Skript}.sh > \PName{Skript}.log} aus dem Terminal heraus zu
553 verwenden. Ein exemplarische Verwendung könnte lauten:
554 %
555 \begin{quoting}
556 \Path{%
557 cd~"\$HOME/Downloads/TUD-Script\_fonts\_Unix"{}\,\POParameter{ENTER}%
558 }\newline
559 \Path{%
560 bash tudscr\_fonts\_install.sh > fonts\_install.log\,\POParameter{ENTER}%
561 }%
562 \end{quoting}
563 %
564 Die so erstellte Logdatei kann \emph{mit einer kurzen Fehlerbeschreibung}
565 entweder im \Forum* gepostet oder per E"~Mail an \mailto{\TUDScriptContact}
566 gesendet werden.%
567 \index{Installation!Schriftinstallation|!)}%