diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/scrguide/einleit.tex')
-rw-r--r-- | Master/texmf-dist/source/latex/koma-script/scrguide/einleit.tex | 310 |
1 files changed, 310 insertions, 0 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/scrguide/einleit.tex b/Master/texmf-dist/source/latex/koma-script/scrguide/einleit.tex new file mode 100644 index 00000000000..977f090d199 --- /dev/null +++ b/Master/texmf-dist/source/latex/koma-script/scrguide/einleit.tex @@ -0,0 +1,310 @@ +\ProvidesFile{einleit.tex}[2003/05/26 KOMA-Script Anleitung] +% ============================================================================ +% einleit.tex +% Copyright (c) 2001 Markus Kohm and the authors. +% +% This file is part of the LaTeX2e KOMA-Script-Bundle +% +% This file can be redistributed and/or modified under the terms of the LaTeX +% Project Public License Version 1.0 distributed together with this file. See +% LEGAL.TXT or LEGALDE.TXT. +% +% This bundle is written specialy for use at german-language. So the main +% documentation is german. There may also be an english documentation. See +% readme.txt, if you search for it. +% ---------------------------------------------------------------------------- +% einleit.tex +% Copyright (c) 2001 Markus Kohm und bei den weiteren Autoren. +% +% Diese Datei ist Teil des LaTeX2e KOMA-Script-Pakets. +% +% Diese Datei kann nach den Regeln der LaTeX Project Public Licence +% Version 1.0, wie sie zusammen mit dieser Datei verteilt wird, +% weiterverbreitet und/oder modifiziert werden. Siehe dazu auch LEGAL.TXT oder +% LEGALDE.TXT. +% +% Dieses Paket ist fuer den deutschen Sprachraum konzipiert. Daher ist auch +% diese Anleitung komplett in Deutsch. Moeglicherweise existiert auch eine +% englische Version der Anleitung. Falls Sie eine solche benoetigen, schauen +% Sie bitte in liesmich.txt nach, ob eine solche vorhanden ist. +% ============================================================================ +% +% Modul: Einleitung +% Autoren: Markus Kohm (MJK) <markus.kohm@gmx.de> +% Inhalt: Die Einleitung zu dem Dokument +% Sprache: Deutsch +% Zeichensatz der Kommentare: +% US-ASCII +% + +\chapter{Einleitung} +\label{cha: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. Hierzu gehören +neben dieser Anleitung auch alle Text-Dokumente, die Bestandteil +des Pakets sind. Sie sind in \File{liesmich.txt} vollständig aufgeführt. + +%\clearpage% HACK: Feintuning, um overfull \vbox zu vermeiden (nicht + % nachmachen!) +\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. +\iffalse% Nicht in die gedruckte Version! +In \cite{DANTE:FAQ} findet +man übrigens auch einen Tipp, wie man ein A5-Dokument so auf A4-Papier +drucken kann, dass man durch Falten in der Mitte ein Heft daraus +machen kann. Die \KOMAScript-Anleitung liegt im A5-Format vor. +\fi + +\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 dies +sinnvoll ist, geschieht es auch durch eine entsprechende Randnotiz. Wenn etwas +nur die Klasse \Class{scrartcl}\OnlyAt{\Class{scrartcl}} betrifft, kann +dies beispielsweise wie in diesem Absatz erfolgen. + +\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 Frank + 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 um den 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 Anwenderklientel sucht 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 war 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 in der Usenet-Gruppe +\texttt{de.comp.text.tex} und der Mailingliste +\texttt{\TeX-D-L} \cite{DANTE:FAQ}, 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 dieses Pakets. In allen +Zweifelsfällen gilt im deutschsprachigen Raum der Text \File{LEGALDE.TXT}, +während in allen anderen Ländern der Text \File{LEGAL.TXT} anzuwenden ist. + +Für die Korrektheit der Anleitung, Teile der Anleitung oder einer anderen in +diesem Paket enthaltenen Dokumentation wird keine Gewähr übernommen. + + +\section{Installation}\label{sec:introduction.installation} +Die Installation von {\KOMAScript} wird in den Dateien \File{liesmich.txt} und +\File{INSTALLDE.TXT} beschrieben. Beachten Sie dazu auch die jeweilige +Dokumentation zu der installierten \TeX-Distribution. + + +\section{Fehlermeldungen} +\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 gegebenenfalls 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. + +Für die eigentliche Meldung sollte unbedingt das zu \KOMAScript{} +gehörende interaktive \LaTeX-Dokument \File{komabug.tex} verwendet +werden. Dazu sollte das Programm \File{latex} in einer Shell -- +beispielsweise die Eingabeaufforderung von Windows -- mit dem Parameter +\File{komabug.tex} gestartet werden. Es erfolgt dann ein textueller +Frage-Antwort-Dialog, bei dem eine Nachricht in die Datei +\File{komabug.msg} ausgegeben wird, die alle grundlegenden +Informationen enthält. Im Dokument ist auch die Adresse angegeben, an +die Sie die Meldung schicken können. Bitte beachten Sie unbedingt +die Angaben zum Betreff Ihrer E-Mail in der erzeugten Datei +\File{komabug.msg}. Anfragen, bei denen diese wenigen Punkte beachtet +wurden, werden normalerweise zügig bearbeitet. + +Häufig werden Sie eine Frage zu \KOMAScript{} oder im Zusammenhang mit +\KOMAScript{} lieber öffentlich, beispielsweise in +\texttt{de.comp.text.tex} stellen wollen, als dem \KOMAScript-Autor zu +schreiben. Auch in diesem Fall sollten Sie unbedingt die Version des +\LaTeX-Kerns, die Version der verwendeten Klassen und Pakete und ein +minimales Beispiel angeben. Wenn Sie in diesem Beispiel noch vor +\Macro{documentclass} die Anweisung \Macro{listfiles} +verwenden, können Sie die +Angaben zu den Versionen anschließend der \File{log}-Datei entnehmen. + + +\section{Weitere Informationen} + +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 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. + + +\section{Autoren}\label{sec:introduction.authors} +Unter dieser Überschrift ist am Ende jedes Kapitels der Dokumentation +zu finden, welche Autoren daran mitgewirkt haben. Der jeweils +zuständige Autor ist dabei fett hervorgehoben. Ist beim zuständigen +Autor eine E-Mail-Adresse angegeben, können Sie diesem auch direkt +schreiben. Bei diesem Kapitel ist das: +\begin{itemize} +\item \textbf{Markus Kohm} \TextEMail{Markus.Kohm@gmx.de} +\end{itemize} + +%%% Local Variables: +%%% mode: latex +%%% TeX-master: "scrguide2" +%%% End: + |