diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/english/introduction.tex')
-rw-r--r-- | Master/texmf-dist/source/latex/koma-script/doc/english/introduction.tex | 130 |
1 files changed, 66 insertions, 64 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/introduction.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/introduction.tex index 107d05c9072..b865de9cb9f 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/english/introduction.tex +++ b/Master/texmf-dist/source/latex/koma-script/doc/english/introduction.tex @@ -37,18 +37,18 @@ % % Introduction of the KOMA-Script guide % Maintained by Markus Kohm -% Translation: Kevin Pfeiffer, Markus Kohm % % ---------------------------------------------------------------------- % % Einleitung der KOMA-Script-Anleitung % Verwaltet von Markus Kohm -% Übersetzung: Kevin Pfeiffer, Markus Kohm % % ====================================================================== -\ProvidesFile{introduction.tex}[2006/07/04 KOMA-Script guide introduction] -% Date of translated german file: 2006-07-01 +\ProvidesFile{introduction.tex}[2007/09/26 KOMA-Script guide introduction] +\translator{Kevin Pfeiffer\and Gernot Hassenpflug\and Markus Kohm} + +% Date of translated german file: 2006/07/05 \chapter{Introduction} \labelbase{introduction} @@ -56,34 +56,34 @@ \section{Preface}\label{sec:introduction.preface} The {\KOMAScript} bundle is actually several packages and classes. It -provides counterparts or replacements for the standard \LaTeX{} classes such +provides counterparts or replacements for the standard {\LaTeX} classes such as \emph{article}, \emph{book}, etc. (see \autoref{cha:maincls}), but offers many additional features and its own unique look and feel. -The \KOMAScript{} user guide is intended to serve the advanced as well as the -inexperienced \LaTeX{} user and is accordingly quite large. The result is a +The {\KOMAScript} user guide is intended to serve the advanced as well as the +inexperienced {\LaTeX} user and is accordingly quite large. The result is a compromise and we hope that you will keep this in mind when using it. Your suggestions for improvement are, of course, always welcome. \section{Structure of the Guide}\label{sec:introduction.structure} -The \KOMAScript{} user guide is not intended to be a \LaTeX{} primer. -Those new to \LaTeX{} should look at \emph{The Not So Short Introduction -to \LaTeXe{}} \cite{lshort} or \emph{\LaTeXe{} for Authors} -\cite{latex:usrguide} or a \LaTeX{} reference book. You will also find -useful information in the many \LaTeX{} FAQs, including the \emph{TeX +The {\KOMAScript} user guide is not intended to be a {\LaTeX} primer. +Those new to {\LaTeX} should look at \emph{The Not So Short Introduction +to {\LaTeXe}} \cite{lshort} or \emph{{\LaTeXe} for Authors} +\cite{latex:usrguide} or a {\LaTeX} reference book. You will also find +useful information in the many {\LaTeX} FAQs, including the \emph{{\TeX} Frequently Asked Questions on the Web} \cite{UK:FAQ}. \begin{Explain} - In this guide you will find supplemental information about \LaTeX{} and - \KOMAScript{} in (san serif) paragraphs like this one. + In this guide you will find supplemental information about {\LaTeX} and + {\KOMAScript} in (sans serif) paragraphs like this one. The information given in these explanatory sections is not essential for - using \KOMAScript{}, but if you experience problems you should - take a look at it -- particularly before sending a bug report. + using {\KOMAScript}, but if you experience problems you should + take a look at it\,---\,particularly before sending a bug report. \end{Explain} -If you are only interested in using a single \KOMAScript{} class or +If you are only interested in using a single {\KOMAScript} class or package you can probably successfully avoid reading the entire guide. Each class and package typically has its own chapter; however, the three main classes (\Class{scrbook}, \Class{scrrprt}, and \Class{scrartcl}) @@ -92,54 +92,55 @@ applies to one or two of the three classes, it is called out in the margin. \OnlyAt{\Class{Like this.}} \begin{Explain} - The primary documentation for \KOMAScript is in German and has been - translated for your convenience; like most of the \LaTeX{} world, its + The primary documentation for {\KOMAScript} is in German and has been + translated for your convenience; like most of the {\LaTeX} world, its commands, environments, options, etc., are in English. In a few cases, the name of a command may sound a little strange, but even so, we hope and - believe that with the help of this guide \KOMAScript{} will still be usable + believe that with the help of this guide {\KOMAScript} will be usable and useful to you. \end{Explain} -\section{History of \KOMAScript}\label{sec:introduction.history} +\section{History of {\KOMAScript}}\label{sec:introduction.history} In the early 1990s, Frank Neukam needed a method to publish an -instructor's lecture notes. At that time \LaTeX was \LaTeX2.09 and there -was no distinction between classes and packages -- there were only +instructor's lecture notes. At that time {\LaTeX} was {\LaTeX}2.09 and there +was no distinction between classes and packages\,---\,there were only \emph{styles}. Frank felt that the standard document styles were not good enough for his work; he wanted additional commands and environments. At the same time he was interested in typography and, after reading Tschichold's \emph{Ausgewählte Aufsätze über Fragen der Gestalt des Buches und der Typographie} (Selected Articles on the Problems of Book Design and Typography) \cite{JTsch87}, he decided to -write his own document style -- and not just a one-time solution to his +write his own document style\,---\,and not just a one-time solution to his lecture notes, but an entire style family, one specifically designed for -European and German typography. Thus \Script{} was born. +European and German typography. Thus {\Script} was born. -Markus Kohm, the developer of \KOMAScript{}, came across {\Script} in +Markus Kohm, the developer of {\KOMAScript}, came across {\Script} in December 1992 and added an option to use the A5 paper format. This and -other changes were then incorporated in to\ScriptII{}, released by Frank +other changes were then incorporated into {\ScriptII}, released by Frank in December 1993. -Beginning in mid-1994, \LaTeXe{} became available and brought with it -many changes. Users of \ScriptII{} were faced with either limiting their -usage to \LaTeXe{}'s compatibility mode or giving up \Script{} -altogether. This situation lead Markus to put together a new \LaTeXe{} -package, released on 7~July 1994 as \KOMAScript{}; a few months later -Frank declared \KOMAScript{} to be the official successor to \Script{}. -\KOMAScript{} originally provided no \emph{letter} class, but this +Beginning in mid-1994, {\LaTeXe} became available and brought with it +many changes. Users of {\ScriptII} were faced with either limiting their +usage to {\LaTeXe}'s compatibility mode or giving up {\Script} +altogether. This situation led Markus to put together a new {\LaTeXe} +package, released on 7~July 1994 as {\KOMAScript}; a few months later +Frank declared {\KOMAScript} to be the official successor to {\Script}. +{\KOMAScript} originally provided no \emph{letter} class, but this deficiency was soon remedied by Axel Kielhorn, and the result became part -of \KOMAScript{} in December 1994. Axel also wrote the first true +of {\KOMAScript} in December 1994. Axel also wrote the first true German-language user guide, which was followed by an English-language guide by Werner Lemberg. -Since then much time has passed. \LaTeX{} has changed in only minor ways, but -the \LaTeX{} lanscape has changed a great deal; many new packages and classes -are now available and \KOMAScript{} itself has grown far beyond what it was in -1994. The initial goal was to provide good \LaTeX classes for German-language -authors, but today its primary purpose is to provide more-flexible -alternatives to the standard classes. \KOMAScript{}'s success has lead to -e-mail from users all over the world and this has lead to many new macros -- all +Since then much time has passed. {\LaTeX} has changed in only minor +ways, but the {\LaTeX} landscape has changed a great deal; many new +packages and classes are now available and {\KOMAScript} itself has +grown far beyond what it was in 1994. The initial goal was to provide +good {\LaTeX} classes for German-language authors, but today its +primary purpose is to provide more-flexible alternatives to the +standard classes. {\KOMAScript}'s success has led to e-mail from users +all over the world, and this has led to many new macros\,---\,all needing documentation; hence this ``small guide.'' @@ -147,9 +148,9 @@ needing documentation; hence this ``small guide.'' Acknowledgements in the introduction? No, the proper acknowledgements can be found in the addendum. My comments here are not intended for the authors of -this guide -- and those thanks should rightly come from you, the reader, -anyhow. I, the author of \KOMAScript, would like to extend my personal thanks -to Frank Neukam. Without his \Script{} family, \KOMAScript{} would not have +this guide\,---\,and those thanks should rightly come from you, the reader, +anyhow. I, the author of {\KOMAScript}, would like to extend my personal thanks +to Frank Neukam. Without his {\Script} family, {\KOMAScript} would not have come about. I am indebted to the many persons who have contributed to {\KOMAScript}, but with their indulgence, I would like to specifically mention Jens-Uwe Morawski and Torsten Kr\"uger. The English translation of the guide @@ -160,11 +161,11 @@ encouraged me to go on, to make things better and less error-prone, or to implement additional features. Thanks go as well to DANTE, Deutschsprachige -Anwendervereinigung \TeX~e.V\kern-.18em, (the German-Language TeX User Group). -Without the DANTE server, \KOMAScript{} could not have been released and -distributed. Thanks as well to everybody in the \TeX{} newsgroups and mailing +Anwendervereinigung {\TeX}~e.V\kern-.18em, (the German-Language {\TeX} User Group). +Without the DANTE server, {\KOMAScript} could not have been released and +distributed. Thanks as well to everybody in the {\TeX} newsgroups and mailing lists who answer questions and have helped me to provide support for -\KOMAScript{}. +{\KOMAScript}. \section{Legal Notes}\label{sec:introduction.legal} @@ -173,36 +174,36 @@ will find it in the file \File{lppl.txt}. An unofficial German-language translation is also available in \File{lppl-de.txt} and is valid for all German-speaking countries. -\iffree{This document and the \KOMAScript{} bundle are provided ``as is'' and +\iffree{This document and the {\KOMAScript} bundle are provided ``as is'' and without warranty of any kind.}% {Please note: the printed version of this guide is not free under the -conditions of the LaTeX{} Project Public Licence. If you need a free version -of this guide, use the version that is provided as part of the \KOMAScript{} +conditions of the {\LaTeX} Project Public Licence. If you need a free version +of this guide, use the version that is provided as part of the {\KOMAScript} bundle.} \section{Installation}\label{sec:introduction.installation} Installation information can be found in the file \File{INSTALL.txt}. You -should also read the documentation that comes with the \TeX{} distribution you +should also read the documentation that comes with the {\TeX} distribution you are using. \section{Bugreports and Other Requests} \label{sec:introduction.errors} If you think you have found an error in the documentation or a bug in one of -the \KOMAScript{} classes, one of the \KOMAScript{} packages, or another -part of \KOMAScript{}, please do the following: first have a look at -CTAN to see if a newer version of \KOMAScript{} is available; in this case +the {\KOMAScript} classes, one of the {\KOMAScript} packages, or another +part of {\KOMAScript}, please do the following: first have a look on +CTAN to see if a newer version of {\KOMAScript} is available; in this case install the applicable section and try again. -If you are using the most recent version of \KOMAScript and still have a -bug, please provide a short \LaTeX{} document that demonstrates the problem. You +If you are using the most recent version of {\KOMAScript} and still have a +bug, please provide a short {\LaTeX} document that demonstrates the problem. You should only use the packages and definitions needed to demonstrate the problem; do not use any unusual packages. By preparing such an example it often becomes clear whether the problem is -truly a \KOMAScript{} bug or something else. Please report \KOMAScript{} (only) -bugs to the author of \KOMAScript{}. Please use \File{komabug.tex}, an -interactive \LaTeX{} document, to generate your bug report and send it to the +truly a {\KOMAScript} bug or something else. Please report {\KOMAScript} (only) +bugs to the author of {\KOMAScript}. Please use \File{komabug.tex}, an +interactive {\LaTeX} document, to generate your bug report and send it to the address you may find at \File{komabug.tex}. If you want to ask your question in a newsgroup or mailing list, you @@ -212,17 +213,18 @@ numbers of all packages in use, simply put \Macro{listfiles} in the preamble of your example and read the end of the \File{log}-file. -\section{Additional Informations} +\section{Additional Information} \label{sec:introduction.moreinfos} -Once you become an experienced \KOMAScript{} user you may want to look at some +Once you become an experienced {\KOMAScript} user you may want to look at some more advanced examples and information. These you will find on the -\KOMAScript{} documentation web site \cite{homepage}. The main +{\KOMAScript} documentation web site \cite{homepage}. The main language of the site is German, but nevertheless English is welcome. \endinput %%% Local Variables: %%% mode: latex +%%% coding: iso-latin-1 %%% TeX-master: "../guide.tex" %%% End: |