summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/tudscr/source/doc/tudscr-installation.tex
blob: d139461ac23350416559428faf6c4f4a43fdebfc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
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~-- 
\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}<> 
  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|!)}%