diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/german/introduction.tex')
-rw-r--r-- | Master/texmf-dist/source/latex/koma-script/doc/german/introduction.tex | 357 |
1 files changed, 357 insertions, 0 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/german/introduction.tex b/Master/texmf-dist/source/latex/koma-script/doc/german/introduction.tex new file mode 100644 index 00000000000..8016ce1efc1 --- /dev/null +++ b/Master/texmf-dist/source/latex/koma-script/doc/german/introduction.tex @@ -0,0 +1,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: |