summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/doc/german/introduction.tex
blob: 8016ce1efc137e5e1330f6042f98a1b57ce93820 (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
% ======================================================================
% introduction.tex
% Copyright (c) Markus Kohm, 2001-2006
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
% This work may be distributed and/or modified under the conditions of
% the LaTeX Project Public License, version 1.3b of the license.
% The latest version of this license is in
%   http://www.latex-project.org/lppl.txt
% and version 1.3b or later is part of all distributions of LaTeX 
% version 2005/12/01 or later and of this work.
%
% This work has the LPPL maintenance status "author-maintained".
%
% The Current Maintainer and author of this work is Markus Kohm.
%
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% introduction.tex
% Copyright (c) Markus Kohm, 2001-2006
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3b, verteilt und/oder veraendert werden.
% Die neuste Version dieser Lizenz ist
%   http://www.latex-project.org/lppl.txt
% und Version 1.3b ist Teil aller Verteilungen von LaTeX
% Version 2005/12/01 oder spaeter und dieses Werks.
%
% Dieses Werk hat den LPPL-Verwaltungs-Status "author-maintained"
% (allein durch den Autor verwaltet).
%
% Der Aktuelle Verwalter und Autor dieses Werkes ist Markus Kohm.
% 
% Dieses Werk besteht aus den in manifest.txt aufgefuehrten Dateien.
% ======================================================================
%
% Introduction of the KOMA-Script guide
% Maintained by Markus Kohm
%
% ----------------------------------------------------------------------
%
% Einleitung der KOMA-Script-Anleitung
% Verwaltet von Markus Kohm
%
% ======================================================================

\ProvidesFile{introduction.tex}[2006/07/05 KOMA-Script guide introduction]

\chapter{Einleitung}
\labelbase{introduction}

\section{Vorwort}
\label{sec:introduction.preface}

{\KOMAScript} ist ein sehr komplexes Paket (engl. \emph{bundle}). Dies
ist schon allein darin begr�ndet, dass es nicht nur aus einer einzigen
Klasse (engl. \emph{class}) oder einem einzigen Paket (engl.
\emph{package}), sondern einer Vielzahl derer besteht. Zwar sind die
Klassen als Gegenst�cke zu den Standardklassen konzipiert (siehe
\autoref{cha:maincls}), das hei�t jedoch insbesondere nicht,
dass sie nur �ber die Befehle, Umgebungen und Einstellm�glichkeiten
der Standardklassen verf�gen oder deren Aussehen als
Standardeinstellung �bernehmen.
Die F�higkeiten von {\KOMAScript} reichen
teilweise weit �ber die F�higkeiten der Standardklassen hinaus.
Manche davon sind auch als Erg�nzung zu den Grundf�higkeiten des
\LaTeX-Kerns zu betrachten.

Allein aus dem Vorgenannten ergibt sich schon zwangsl�ufig, dass die
Dokumentation zu {\KOMAScript} sehr umfangreich ausf�llt. Hinzu kommt,
dass {\KOMAScript} in der Regel nicht gelehrt wird. Das hei�t, es gibt
keinen Lehrer, der seine Sch�ler kennt und damit den Unterricht und
das Unterrichtsmaterial entsprechend w�hlen und anpassen kann. Es w�re
ein Leichtes, die Dokumentation f�r irgendeine Zielgruppe zu
verfassen.  Die Schwierigkeit, der sich die Autoren gegen�ber sehen,
besteht jedoch darin, dass eine Anleitung f�r alle m�glichen
Zielgruppen ben�tigt wird. Wir haben uns bem�ht, eine Anleitung zu
erstellen, die f�r den Informatiker gleicherma�en geeignet ist wie f�r
die Sekret�rin des Fischh�ndlers. Wir haben uns bem�ht, obwohl es sich
dabei eigentlich um ein unm�gliches Unterfangen handelt. Ergebnis sind
zahlreiche Kompromisse. Wir bitten jedoch, die Problematik bei
eventuellen Beschwerden zu ber�cksichtigen und bei der Verbesserung
unserer derzeitigen L�sung zu helfen.

Trotz des Umfangs der Anleitung bitten wir au�erdem darum, im Falle von
Problemen zun�chst die Dokumentation zu konsultieren. Als erste Anlaufstelle
sei auf den mehrteiligen Index am Ende des \iffree{Dokuments}{Buches}
hingewiesen. \iffree{Zur Dokumentation geh�ren neben dieser Anleitung auch
  alle Text-Dokumente, die Bestandteil des Pakets sind. Sie sind in
  \File{manifest.txt} vollst�ndig aufgef�hrt}{}


\section{Dokumentaufbau}
\label{sec:introduction.structure}

Diese Anleitung enth�lt sehr wenige Informationen, die speziell f�r den
\LaTeX-Neuling geschrieben wurden. Es wird als zwingend vorausgesetzt,
dass Dokumente wie \cite{l2kurz} und \cite{latex:usrguide} gelesen und
verstanden sind. Auch das Studium des einen oder anderen Buches zu
\LaTeX{} wird empfohlen.  Literaturempfehlungen finden sich
beispielsweise in \cite{DANTE:FAQ}. Der Umfang von \cite{DANTE:FAQ}
ist ebenfalls erheblich. Dennoch wird darum gebeten, das Dokument
nicht nur irgendwo vorliegen zu haben, sondern es mindestens einmal zu
lesen und bei Problemen zu konsultieren.

\begin{Explain}
  Im Gegensatz zu tiefgehender Anf�ngerinformation sind weiterf�hrende
  Informationen und Begr�ndungen in dieser Dokumentation reichlich
  vorhanden.  Um solche Dokumentteile leichter erkennbar zu machen,
  sind sie in einer besonderen Schrift hervorgehoben. Damit ist es
  besonders ungeduldigen und uninteressierten Zeitgenossen m�glich,
  solche Teile zu �berspringen.  Empfohlen wird dies aber ausdr�cklich
  nicht.  Gleichwohl ist es gut zu wissen, dass diese Teile nicht
  zwingend verstanden werden m�ssen, um {\KOMAScript} anzuwenden. Vor
  der �nderung und Kritisierung der Voreinstellungen von
  {\KOMAScript}, ist das Studium und Verst�ndnis dieser Teile jedoch
  von erheblichem Vorteil.
\end{Explain}

Die Einteilung der Anleitung in Kapitel und Abschnitte soll ebenfalls dabei
helfen, nur die Teile lesen zu m�ssen, die tats�chlich von Interesse sind. Um
dies zu erreichen, sind die Informationen zu den einzelnen Klassen und Paketen
nicht �ber das gesamte Dokument verteilt, sondern jeweils in einem Kapitel
konzentriert. Querverweise in ein anderes Kapitel sind damit in der Regel auch
Verweise auf einen anderen Teil des Gesamtpakets. Da die drei Hauptklassen in
weiten Teilen �bereinstimmen, sind sie in einem gemeinsamen Kapitel
zusammengefasst. Die Unterschiede werden deutlich hervorgehoben, soweit
sinnvoll auch durch eine entsprechende Randnotiz. Dies geschieht
beispielsweise wie hier, wenn etwas nur die Klasse
\Class{scrartcl}\OnlyAt{\Class{scrartcl}} betrifft.

Unterschiedliche Schriftarten werden auch zur Hervorhebung unterschiedlicher
Dinge verwendet. So werden die Namen von \Package{Paketen} und \Class{Klassen}
anders angezeigt als \File{Dateinamen}. \Macro{Anweisungen},
\Environment{Umgebungen}, \Option{Optionen}, \Variable{Variablen} und
\PLength{Pseudol�ngen} werden einheitlich hervorgehoben. Jedoch wird der
\PValue{Platzhalter} f�r einen Parameter anders dargestellt als ein
konkreter \PValue{Wert eines Parameters}. So zeigt etwa
\Macro{begin}\Parameter{Umgebungsname} ganz allgemein wie eine Umgebung
eingeleitet wird, w�hrend \Macro{begin}\PParameter{document} angibt, wie
die konkrete Umgebung \Environment{document} beginnt. Dabei ist gleichzeitig
\PValue{document} ein konkreter Wert f�r den Parameter
\PName{Umgebungsname} der Anweisung \Macro{begin}.

Damit sollten Sie nun alles wissen, um diese Anleitung lesen und verstehen zu
k�nnen. Trotzdem k�nnte es sich lohnen, den Rest dieses Kapitels gelegentlich
auch zu lesen.

\section{Die Geschichte von \KOMAScript}
\label{sec:introduction.history}

\begin{Explain}
  Anfang der 90er~Jahre wurde Frank Neukam damit beauf"|tragt, ein
  Vorlesungsskript zu setzen. Damals war noch \LaTeX2.09 aktuell und
  es gab keine Unterscheidung nach Klassen und Paketen, sondern alles
  waren Stile (engl. \emph{styles}). Die Standarddokumentstile
  erschienen ihm f�r ein Vorlesungsskript nicht optimal und boten auch
  nicht alle Befehle und Umgebungen, die er ben�tigte.
  
  Zur selben Zeit besch�ftigte sich Frank auch mit Fragen der
  Typografie, insbesondere mit \cite{JTsch87}. Damit stand f�r ihn
  fest, nicht nur irgendeinen Dokumentstil f�r Skripten zu erstellen,
  sondern allgemein eine Stilfamilie, die den Regeln der europ�ischen
  Typografie folgt. {\Script} war geboren.
  
  Ich, Markus Kohm, traf auf {\Script} ungef�hr zum Jahreswechsel
  1992/""1993. Im Gegensatz zu Frank Neukam hatte ich h�ufig mit
  Dokumenten zu tun, f�r die ich das A5-Format bevorzuge. Zu jenem
  Zeitpunkt wurde A5 weder von den Standardklassen noch von {\Script}
  unterst�tzt. Daher dauerte es nicht lange, bis ich erste
  Ver�nderungen an {\Script} vornahm. Diese fanden sich auch in
  {\ScriptII} wieder, das im Dezember~1993 von Frank ver�ffentlicht
  wurde.
  
  Mitte 1994 erschien dann \LaTeXe. Die damit einhergehenden
  �nderungen waren tiefgreifend. Daher blieb dem Anwender von
  {\ScriptII} nur die Entscheidung, sich entweder auf den
  Kompatibilit�tsmodus von \LaTeX{} zu beschr�nken, oder auf {\Script}
  zu verzichten. Wie viele andere wollte ich beides nicht. Also machte
  ich mich daran, einen \Script-Nachfolger f�r {\LaTeXe} zu
  entwickeln, der am 7.~Juli~1994 unter dem Namen {\KOMAScript}
  erschienen ist. Ich will hier nicht n�her auf die Wirren eingehen,
  die es um die offizielle Nachfolge von {\Script} gab und warum mein
  Paket einen neuen Namen hat. Tatsache ist, dass auch aus Franks
  Sicht {\KOMAScript} der Nachfolger von {\ScriptII} ist. Zu erw�hnen
  ist noch, dass {\KOMAScript} urspr�nglich ohne Briefklasse
  erschienen war. Diese wurde im Dezember~1994 von Axel Kielhorn
  beigesteuert. Noch etwas sp�ter erstellte Axel Sommerfeldt den
  ersten richtigen scrguide zu {\KOMAScript}.
  
  Seither ist einiges an Zeit vergangen. {\LaTeX} hat sich ein wenig
  ver�ndert, die \LaTeX-Landschaft erheblich. {\KOMAScript} hat sich
  weiterentwickelt. Es findet nicht mehr allein im deutschsprachigen
  Raum Anwender, sondern in ganz Europa, Nordamerika, Australien
  und Asien.
  Diese Anwender suchen bei {\KOMAScript} nicht allein nach
  einem typografisch ansprechenden Ergebnis. Zu beobachten ist
  vielmehr, dass bei {\KOMAScript} ein neuer Schwerpunkt entstanden
  ist: Flexibilisierung durch Variabilisierung. Unter diesem
  Schlagwort verstehe ich die M�glichkeit, in das Erscheinungsbild an
  vielen Stellen eingreifen zu k�nnen. Dies f�hrte zu vielen neuen
  Makros, die mehr schlecht als recht in die existierende Anleitung
  integriert wurden.  Irgendwann wurde es damit auch Zeit f�r eine
  komplett �berarbeitete Anleitung.\par
\end{Explain}


\section{Danksagung}
\label{sec:introduction.thanks}

Eine Danksagung in der Einleitung? Geh�rt sie nicht vielmehr an den
Schluss?  Richtig! Eigentlich geh�rt die an das Ende. Mein Dank gilt
hier jedoch nicht prim�r denjenigen, die diese Anleitung m�glich
gemacht haben. F�r den Dank an die Guide-Autoren mache ich den Leser
zust�ndig! Mein pers�nlicher Dank gilt Frank Neukam, ohne dessen
\Script-Familie es vermutlich {\KOMAScript} nie gegeben h�tte. Mein
Dank gilt denjenigen, die an der Entstehung von {\KOMAScript} und den
Anleitungen mitgewirkt haben. Stellvertretend f�r andere m�chte ich
hier Jens-Uwe Morawski und Torsten Kr�ger nennen. Jens' unerm�dlichem
Einsatz ist neben vielem Anderen die englische �bersetzung der
Anleitung zu verdanken. Torsten ist der beste Betatester, den ich je
hatte. Er hat damit insbesondere an der Verwendbarkeit von
\Class{scrlttr2} und \Class{scrpage2} einen erheblichen Anteil. Mein
Dank gilt auch allen, die mich immer wieder aufgemuntert haben, weiter
zu machen und dieses oder jenes noch besser, weniger fehlerhaft oder
schlicht zus�tzlich zu implementieren.

Ganz besonderen Dank bin ich den Gr�ndern von DANTE, Deutschsprachige
Anwendervereinigung \TeX~e.V\kern-.18em., schuldig, durch die letztlich die
Verbreitung von \TeX{} und \LaTeX{} und allen Paketen einschlie�lich
{\KOMAScript} an einer zentralen Stelle �berhaupt erm�glicht wird. In gleicher
Weise bedanke ich mich bei den aktiven Helfern auf der Mailingliste
\texttt{\TeX-D-L} (siehe \cite{DANTE:FAQ}) und in der Usenet-Gruppe
\texttt{de.comp.text.tex}, die mir so manche Antwort auf Fragen zu
{\KOMAScript} abnehmen.

\section{Rechtliches}
\label{sec:introduction.legal}

{\KOMAScript} steht unter der {\LaTeX} Project Public Licence. Eine nicht
offizielle deutsche �bersetzung ist Bestandteil des \KOMAScript-Pakets. In
allen Zweifelsf�llen gilt im deutschsprachigen Raum der Text
\File{lppl-de.txt}, w�hrend in allen anderen L�ndern der Text \File{lppl.txt}
anzuwenden ist.

\iffree{F�r die Korrektheit der Anleitung, Teile der Anleitung oder einer
  anderen in diesem Paket enthaltenen Dokumentation wird keine Gew�hr
  �bernommen.}%
{Diese gedruckte Ausgabe der Anleitung ist davon und von den in den Dateien
  \File{lppl.txt} und \File{lppl-de.txt} des \KOMAScript-Pakets
  festgeschriebenden rechtlichen Bedingungen ausdr�cklich ausgenommen.}

\section{Installation}
\label{sec:introduction.installation}

Die Installation von {\KOMAScript} wird in der Datei \File{INSTALLD.txt}
beschrieben. Beachten Sie dazu auch die jeweilige Dokumentation zu der
installierten \TeX-Distribution.


\section{Fehlermeldungen, Fragen, Probleme}
\label{sec:introduction.errors}

Sollten Sie der Meinung sein, dass Sie einen Fehler in der Anleitung,
einer der \KOMAScript-Klassen, einem der \KOMAScript-Pakete oder einem
anderen Bestandteil von \KOMAScript{} gefunden haben, so sollten Sie
wie folgt vorgehen. Pr�fen Sie zun�chst, ob inzwischen eine neue
Version von \KOMAScript{} erschienen ist. Installieren Sie diese neue
Version und kontrollieren Sie, ob der Fehler oder das
Problem auch dann noch vorhanden ist.

Wenn es sich nicht um einen Fehler in der Dokumentation handelt und
der Fehler oder das Problem nach einem Update noch immer auf"|tritt,
erstellen Sie bitte wie in \cite{DANTE:FAQ} angegeben ein minimales
Beispiel. Ein solches Beispiel sollte nur einen minimalen Text und
nur die Pakete und Definitionen enthalten, die f�r die Verdeutlichung
des Fehlers unbedingt notwendig sind. Auf exotische Pakete sollte
m�glichst ganz verzichtet werden.
Oft l�sst sich ein Problem durch ein minimales Beispiel so weit
eingrenzen, dass bereits vom Anwender selbst festgestellt werden kann,
ob es sich um einen Anwendungsfehler handelt oder nicht. Auch ist so
sehr h�ufig zu erkennen, welche Pakete oder Klassen konkret das
Problem verursachen und ob es sich �berhaupt um ein
\KOMAScript-Problem handelt. Dies k�nnen Sie gegebenenfalls
zus�tzlich �berpr�fen, indem Sie statt einer \KOMAScript-Klasse einen
Test mit der entsprechenden Standardklasse vornehmen. Danach ist dann
auch klar, ob der Fehlerbericht an den Autor von \KOMAScript{} oder an
den Autor eines anderen Pakets zu richten ist. Sie sollten sp�testens
jetzt noch einmal gr�ndlich die Anleitungen der entsprechenden Paket,
Klassen und \KOMAScript-Bestandteile studieren sowie \cite{DANTE:FAQ}
konsultieren. M�glicherweise existiert ja bereits eine L�sung f�r Ihr
Problem, so dass sich eine Fehlermeldung er�brigt.

Wenn Sie denken, dass Sie einen noch unbekannten Fehler gefunden haben, oder
es aus anderem Grund f�r sinnvoll oder notwendig erachten, den
\KOMAScript-Autor zu kontaktieren, so sollten Sie dabei folgende Angaben
keinesfalls vergessen:
\begin{itemize}
\item Tritt das Problem auch auf, wenn statt einer \KOMAScript-Klasse eine
  Standardklasse verwendet wird? In dem Fall liegt der Fehler h�chst
  wahrscheinlich nicht bei \KOMAScript. Es ist dann sinnvoller, die Frage in
  einem �ffentlichen Forum, einer Mailingliste oder im Usenet zu stellen.
\item Welche \KOMAScript-Version verwenden Sie? Entsprechende Informationen
  finden Sie in der \File{log}-Datei des \LaTeX-Laufs jedes Dokuments, das
  eine \KOMAScript-Klasse verwendet.
\item Welches Betriebssystem und welche \TeX-Distribution wird verwendet?
  Diese Angaben erscheinen bei einem bestriebssystemunabh�ngigen Paket wie
  \KOMAScript{} oder \LaTeX{} eher �berfl�ssig. Es zeigt sich aber immer
  wieder, dass sie durchaus eine Rolle spielen k�nnen.
\item Was genau ist das Problem oder der Fehler? Beschreiben Sie das Problem
  oder den Fehler lieber zu ausf�hrlich als zu knapp. Oftmals ist es sinnvoll
  auch die Hintergr�nde zu erl�utern.
\item Wie sieht ein vollst�ndiges Minimalbeispiel aus? Ein solches
  vollst�ndiges Minimalbeispiel kann jeder leicht selbst erstellen, indem
  Schritt f�r Schritt Inhalte und Pakete aus dem Problemdokument
  auskommentiert werden. Am Ende bleibt ein Dokument, das nur die Pakete l�dt
  und nur die Teile enth�lt, die f�r das Problem notwendig sind. Au�erdem
  sollten alle geladenen Abbildungen durch \Macro{rule}-Anweisungen
  entsprechender Gr��e ersetzt werden. Vor dem Verschicken entfernt man nun
  die auskommentierten Teile, f�gt als erste Zeile die Anweisung
  \Macro{listfiles} ein und f�hrt einen weiteren \LaTeX-Lauf durch. Man erh�lt
  dann am Ende der \File{log}-Datei eine �bersicht �ber die verwendeten
  Pakete. Das vollst�ndige Minimalbeispiel und die \File{log}-Datei f�gen Sie
  ihrer Beschreibung hinzu.
\end{itemize}
Schicken Sie keine Pakete, PDF- oder PS- oder DVI-Dateien mit.  Falls die
gesamte Problem- oder Fehlerbeschreibung einschlie�lich Minimalbeispiel und
\File{log}-Datei gr��er als ein paar Dutzend KByte ist, haben Sie mit gr��ter
Wahrscheinlichkeit etwas falsch gemacht. Anderenfalls schicken Sie Ihre
Mitteilung an \href{mailto:komascript@gmx.info}{komascript@gmx.info}.

H�ufig werden Sie eine Frage zu \KOMAScript{} oder im Zusammenhang mit
\KOMAScript{} lieber �ffentlich, beispielsweise in \texttt{de.comp.text.tex}
oder dem Forum auf \cite{homepage}, stellen wollen. Auch in diesem Fall
sollten Sie obige Punkte beachten, in der Regel jedoch auf die
\File{log}-Datei verzichten. F�gen Sie stattdessen nur die Liste der Pakete
und Paketversionen aus der \File{log}-Datei an. Im Falle einer Fehlermeldung
zitieren Sie diese ebenfalls aus der \File{log}-Datei.


\section{Weitere Informationen}
\label{sec:introduction.moreinfos}

Sobald Sie im Umgang mit \KOMAScript{} ge�bt sind, werden Sie sich
m�glicherweise Beispiele zu schwierigeren Aufgaben w�nschen. Solche Beispiele
gehen �ber die Vermittlung von Grundwissen hinaus und sind daher\iffree{}{
  au�er im Angang} nicht Bestandteil dieser Anleitung. Auf den Internetseiten
des \KOMAScript{} Documentation Projects \cite{homepage} finden Sie jedoch
weiterf�hrende Beispiele. Diese sind f�r fortgeschrittene \LaTeX-Anwender
konzipiert. F�r Anf�nger sind sie wenig oder nicht geeignet.

\endinput
%%% Local Variables: 
%%% mode: latex
%%% TeX-master: "../guide.tex"
%%% End: